Dukungan atribut Automation API

Automation API mendukung sebagian besar karakteristik, tetapi dukungan untuk beberapa atribut, peristiwa, dan perintah dalam karakteristik mungkin terbatas.

Untuk memverifikasi bahwa Automation API mendukung kasus penggunaan Anda, telusuri di tabel di bawah.

Secara umum:

  • Setiap karakteristik dan jenis yang ingin Anda gunakan di aplikasi dengan Automation API harus didaftarkan saat inisialisasi. Lihat Membuat instance Home.
  • Atribut apa pun dapat digunakan dalam pemicu atau kondisi.
  • Perangkat Cloud-to-cloud yang tidak melaporkan statusnya tidak dapat digunakan sebagai pemicu dalam otomatisasi, yang dibuat secara manual atau melalui penemuan.
  • Meskipun perangkat mendukung karakteristik yang tercantum di sini, perangkat mungkin diblokir agar tidak digunakan sebagai pemicu atau tindakan di Automation API karena nilai minimum kualitas Status Laporan:
    • Perangkat dengan tingkat keberhasilan Status Laporan yang lebih rendah dari 90% akan diblokir agar tidak dapat digunakan sebagai pemicu.
    • Perangkat dengan tingkat keberhasilan eksekusi perintah yang lebih rendah dari 95% akan diblokir agar tidak digunakan sebagai tindakan.
  • Perintah hanya dapat digunakan sebagai tindakan.
  • Beberapa karakteristik, seperti AssistantBroadcast, hanya tersedia untuk digunakan di Automation API.
  • Perintah okGoogle adalah perintah tingkat struktur dan dapat digunakan untuk mengotomatiskan perangkat apa pun dalam struktur. Namun, aplikasi Home API mungkin tidak memiliki akses ke setiap perangkat. Lihat izin OkGoogle untuk melihat cara izin diterapkan dalam berbagai kasus.
  • Beberapa karakteristik memiliki prasyarat:
    • Untuk menggunakan Time.ScheduledTimeEvent, struktur tempat otomatisasi berjalan harus memiliki alamat jalan yang disiapkan di Google Home app (GHA). Mengubah alamat rumah Google menjelaskan cara pengguna memasukkan alamat struktur. Jika alamat tidak disiapkan di GHA, otomatisasi akan gagal dibuat, dan error akan ditampilkan dengan pesan "ScheduledTimeEvent tidak didukung oleh structure".
    • Untuk menggunakan karakteristik AreaPresenceState atau AreaAttendanceState, pengguna harus menyiapkan deteksi kehadiran di GHA.
    • Untuk menggunakan atribut ObjectDetection, pengguna harus memiliki langganan Nest Aware yang aktif.

Versi sederhana dari beberapa karakteristik juga tersedia untuk digunakan dalam otomatisasi. Untuk mengetahui informasi selengkapnya, lihat Atribut yang disederhanakan.

Pemblokiran menunjukkan bahwa perintah tidak didukung dalam otomatisasi untuk satu atau beberapa jenis perangkat. Untuk informasi selengkapnya, lihat Tindakan yang diblokir dalam otomatisasi.

Sifat Jenis sifat Jenis elemen Elemen
AssistantBroadcast google Perintah Broadcast
AssistantFulfillment google Perintah OkGoogle
Notifikasi google Perintah SendNotifications
Waktu google Acara ScheduledTimeEvent
Waktu google Atribut currentTime
Waktu google Atribut missingStructureLocation
Waktu google Atribut sunriseTime
Waktu google Atribut sunsetTime
VoiceStarter google Acara OkGoogleEvent
AirQuality matter Atribut airQuality
ApplicationLauncher matter Perintah LaunchApp
ApplicationLauncher matter Perintah StopApp
ApplicationLauncher matter Atribut currentApp
AudioOutput matter Atribut currentOutput
CarbonDioxideConcentrationMeasurement matter Atribut levelValue
CarbonDioxideConcentrationMeasurement matter Atribut measuredValue
CarbonMonoxideConcentrationMeasurement matter Atribut levelValue
CarbonMonoxideConcentrationMeasurement matter Atribut maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Atribut measuredValue
CarbonMonoxideConcentrationMeasurement matter Atribut measurementUnit
CarbonMonoxideConcentrationMeasurement matter Atribut minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Atribut ketidakpastian
Saluran matter Perintah ChangeChannelByNumber
Saluran matter Perintah SkipChannel
ColorControl matter Perintah ColorLoopSet
ColorControl matter Perintah MoveColor
ColorControl matter Perintah MoveColorTemperature
ColorControl matter Perintah MoveToColor
ColorControl matter Perintah MoveToColorTemperature
ColorControl matter Perintah MoveToHue
ColorControl matter Perintah MoveToHueAndSaturation
ColorControl matter Perintah MoveToSaturation
ColorControl matter Perintah StepColor
ColorControl matter Perintah StepColorTemperature
ColorControl matter Atribut colorTemperatureMireds
ColorControl matter Atribut currentHue
ColorControl matter Atribut currentX
ColorControl matter Atribut currentY
DishwasherMode matter Perintah ChangeToMode
DishwasherMode matter Atribut currentMode
DishwasherMode matter Atribut onMode
DoorLock matter Acara DoorLockAlarm
DoorLock matter Acara DoorStateChange
DoorLock matter Perintah LockDoor
DoorLock matter Acara LockOperation
DoorLock matter Acara LockOperationError
DoorLock matter Perintah UnlockDoor
DoorLock matter Atribut doorClosedEvents
DoorLock matter Atribut doorOpenEvents
DoorLock matter Atribut doorState
DoorLock matter Atribut lockState
FanControl matter Perintah Langkah
FanControl matter Atribut airflowDirection
FanControl matter Atribut fanMode
FanControl matter Atribut percentCurrent
FanControl matter Atribut percentSetting
FanControl matter Atribut speedCurrent
FanControl matter Atribut speedSetting
FanControl matter Atribut windSetting
FormaldehydeConcentrationMeasurement matter Atribut levelValue
FormaldehydeConcentrationMeasurement matter Atribut measuredValue
IlluminanceMeasurement matter Atribut measuredValue
LaundryWasherMode matter Perintah ChangeToMode
LaundryWasherMode matter Atribut currentMode
LaundryWasherMode matter Atribut onMode
LevelControl matter Perintah Pindahkan
LevelControl matter Perintah MoveToLevel
LevelControl matter Perintah MoveToLevelWithOnOff
LevelControl matter Perintah MoveWithOnOff
LevelControl matter Perintah Langkah
LevelControl matter Perintah StepWithOnOff
LevelControl matter Perintah Berhenti
LevelControl matter Perintah StopWithOnOff
LevelControl matter Atribut currentLevel
LevelControl matter Atribut maxLevel
LevelControl matter Atribut startUpCurrentLevel
MediaInput matter Perintah RenameInput
MediaInput matter Perintah SelectInput
MediaInput matter Atribut currentInput
MediaPlayback matter Perintah FastForward
MediaPlayback matter Perintah Berikutnya
MediaPlayback matter Perintah Jeda
MediaPlayback matter Perintah Putar
MediaPlayback matter Perintah Sebelumnya
MediaPlayback matter Perintah Mundur
MediaPlayback matter Perintah SkipBackward
MediaPlayback matter Perintah SkipForward
MediaPlayback matter Acara StateChanged
MediaPlayback matter Perintah Berhenti
MediaPlayback matter Atribut currentState
ModeSelect matter Perintah ChangeToMode block
ModeSelect matter Atribut currentMode
ModeSelect matter Atribut onMode
NitrogenDioxideConcentrationMeasurement matter Atribut levelValue
NitrogenDioxideConcentrationMeasurement matter Atribut measuredValue
OccupancySensing matter Atribut jumlah tamu
OnOff matter Perintah Nonaktif blokir
OnOff matter Perintah Aktif blokir
OnOff matter Atribut onOff
OperationalState matter Acara OperationCompletion
OperationalState matter Perintah Jeda blok
OperationalState matter Perintah Blokir lanjutkan
OperationalState matter Perintah Mulai
OperationalState matter Perintah Berhenti
OperationalState matter Atribut currentPhase
OperationalState matter Atribut operationalState
OzoneConcentrationMeasurement matter Atribut levelValue
OzoneConcentrationMeasurement matter Atribut measuredValue
Pm10ConcentrationMeasurement matter Atribut levelValue
Pm10ConcentrationMeasurement matter Atribut measuredValue
Pm25ConcentrationMeasurement matter Atribut levelValue
Pm25ConcentrationMeasurement matter Atribut measuredValue
PowerSource matter Atribut batChargeState
PowerSource matter Atribut batChargingCurrent
PowerSource matter Atribut batTimeToFullCharge
RadonConcentrationMeasurement matter Atribut levelValue
RadonConcentrationMeasurement matter Atribut measuredValue
RelativeHumidityMeasurement matter Atribut measuredValue
RvcCleanMode matter Perintah ChangeToMode
RvcOperationalState matter Perintah GoHome
RvcOperationalState matter Perintah Jeda
RvcOperationalState matter Perintah Lanjutkan
RvcOperationalState matter Atribut currentPhase
RvcOperationalState matter Atribut operationalError
RvcOperationalState matter Atribut operationalState
RvcRunMode matter Perintah ChangeToMode
RvcRunMode matter Atribut currentMode
Tombol matter Acara InitialPress
Tombol matter Acara LongPress
Tombol matter Acara LongRelease
Tombol matter Acara MultiPressComplete
Tombol matter Acara MultiPressOngoing
Tombol matter Acara ShortRelease
Tombol matter Acara SwitchLatched
Tombol matter Atribut currentPosition
TemperatureControl matter Perintah SetTemperature block
TemperatureControl matter Atribut maxTemperature
TemperatureControl matter Atribut minTemperature
TemperatureControl matter Atribut selectedTemperatureLevel
TemperatureControl matter Atribut temperatureSetpoint
TemperatureMeasurement matter Atribut measuredValue
Termostat matter Perintah SetpointRaiseLower
Termostat matter Atribut activePresetHandle
Termostat matter Atribut localTemperature
Termostat matter Atribut jumlah tamu
Termostat matter Atribut occupiedCoolingSetpoint
Termostat matter Atribut occupiedHeatingSetpoint
Termostat matter Atribut outdoorTemperature
Termostat matter Atribut setpointChangeSource
Termostat matter Atribut systemMode
Termostat matter Atribut temperatureSetpointHold
Termostat matter Atribut temperatureSetpointHoldDuration
Termostat matter Atribut thermostatRunningMode
Termostat matter Atribut thermostatRunningState
Termostat matter Atribut unoccupiedCoolingSetpoint
Termostat matter Atribut unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Atribut levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Atribut measuredValue
WindowCovering matter Perintah DownOrClose
WindowCovering matter Perintah GoToLiftPercentage
WindowCovering matter Perintah GoToLiftValue
WindowCovering matter Perintah GoToTiltPercentage
WindowCovering matter Perintah GoToTiltValue
WindowCovering matter Perintah StopMotion
WindowCovering matter Perintah UpOrOpen
WindowCovering matter Atribut currentPositionLift
WindowCovering matter Atribut currentPositionLiftPercent100ths
WindowCovering matter Atribut currentPositionLiftPercentage
WindowCovering matter Atribut currentPositionTilt
WindowCovering matter Atribut currentPositionTiltPercent100ths
WindowCovering matter Atribut currentPositionTiltPercentage
WindowCovering matter Atribut targetPositionLiftPercent100ths
WindowCovering matter Atribut targetPositionTiltPercent100ths
ArmDisarm google Perintah ArmDisarm block
ArmDisarm google Acara ArmDisarmArmState
ArmDisarm google Atribut armState
ArmDisarm google Atribut currentArmLevel
ArmDisarm google Atribut isArmed
Dock google Perintah Dock
Dock google Atribut isDocked
DoorbellPress google Acara DoorbellPressed
ExtendedAirQuality google Acara AirQuality
ExtendedAirQuality google Atribut indoorAirQuality
ExtendedAirQuality google Atribut indoorMeasuredValue
ExtendedAirQuality google Atribut measuredValue
ExtendedAirQuality google Atribut outdoorAirQuality
ExtendedAirQuality google Atribut outdoorMeasuredValue
ExtendedColorControl google Perintah MoveToColorHSV
ExtendedColorControl google Perintah MoveToColorName
ExtendedColorControl google Perintah MoveToColorRGB
ExtendedColorControl google Atribut currentBlue
ExtendedColorControl google Atribut currentGreen
ExtendedColorControl google Atribut currentHue
ExtendedColorControl google Atribut currentName
ExtendedColorControl google Atribut currentRed
ExtendedColorControl google Atribut currentSaturation
ExtendedColorControl google Atribut currentValue
ExtendedFanControl google Perintah ToggleAirflowDirection
ExtendedFanControl google Atribut customFanMode
ExtendedFanControl google Atribut customFanModes
ExtendedMediaInput google Perintah NextInput
ExtendedMediaInput google Perintah PreviousInput
ExtendedMediaInput google Perintah SelectCustomInput
ExtendedMediaInput google Atribut currentCustomInput
ExtendedMediaInput google Atribut customInputsList
ExtendedMediaInput google Atribut customInputsOrdered
ExtendedOperationalState google Acara PauseUnpauseFollowUp
ExtendedOperationalState google Acara StartStopFollowUp
ExtendedPowerSource google Perintah StartCharging
ExtendedPowerSource google Perintah StopCharging
ExtendedThermostat google Atribut activePresetHandle
ExtendedThermostat google Atribut activeRemoteTemperatureSensorIds
ExtendedThermostat google Atribut averageLocalTemperature
ExtendedThermostat google Atribut extendedRunningMode
ExtendedThermostat google Atribut extendedSystemMode
LightEffects google Perintah PulseEffectSet
LightEffects google Perintah SleepEffectSet
LightEffects google Perintah StopEffect
LightEffects google Perintah WakeEffectSet
LightEffects google Atribut pulseEffectSet
LightEffects google Atribut sleepEffectSet
LightEffects google Atribut wakeEffectSet
LockUnlock google Perintah Kunci
LockUnlock google Perintah Buka kunci blok
LockUnlock google Atribut lockState
MotionDetection google Acara MotionDetected
MotionDetection google Atribut motionDetectionEventInProgress
ObjectDetection google Acara ObjectDetected
OpenClose google Perintah Blok tutup
OpenClose google Perintah GoToOpenPercentage block
OpenClose google Perintah Buka blok
OpenClose google Perintah Langkah blokir
OpenClose google Atribut openPercent
OpenClose google Atribut openState
OpenClose google Atribut targetOpenPercent
Kumpulan data google Perintah StartRecording
Kumpulan data google Perintah StopRecording
Kumpulan data google Atribut isCurrentlyRecording
Tombol alih google Perintah ChangeToggleSettings block
Tombol alih google Atribut currentToggleSettings
Kecerahan google Perintah BrightnessStep
Kecerahan google Perintah MoveToBrightness
Kecerahan google Atribut currentBrightnessPercent
SimplifiedOnOff google Atribut onOff
SimplifiedThermostat google Perintah SetSystemMode
SimplifiedThermostat google Atribut systemMode
Volume google Perintah MoveToVolume
Volume google Perintah Bisukan
Volume google Perintah Bunyikan
Volume google Perintah VolumeStep
Volume google Atribut currentVolumePercent
Volume google Atribut isMuted
AreaAttendanceState google Atribut attendanceState
AreaPresenceState google Atribut presenceState