Obsługa atrybutów interfejsu Automation API

Interfejs Automation API obsługuje większość atrybutów, ale obsługa niektórych atrybutów, zdarzeń i komend może być ograniczona.

Aby sprawdzić, czy interfejs Automation API obsługuje Twój przypadek użycia, sprawdź tabelę poniżej.

Przede wszystkim:

  • Wszystkie cechy i typy, których chcesz używać w aplikacji z automatyzacją, muszą zostać zarejestrowane podczas inicjalizacji. Zobacz Tworzenie instancji domowej.
  • W przypadku urządzeń początkowych i warunków można użyć dowolnego atrybutu.
  • Cloud-to-cloudUrządzenia, które nie zgłaszają swojego stanu, nie mogą być używane jako wyzwalacze w automatyzacjach utworzonych ręcznie lub za pomocą funkcji wykrywania.
  • Nawet jeśli urządzenie obsługuje wymienione tu cechy, może nie być możliwe użycie go jako elementu inicjującego lub działania w interfejsie Automation API z powodu przekroczenia progów jakości stanu raportu:
    • Urządzenia z wartością skuteczności stanu raportu poniżej 90% nie mogą być używane jako startery.
    • Urządzenia z poziomem skuteczności wykonania polecenia poniżej 95% są blokowane przed używaniem jako działania.
  • Poleceń można używać tylko jako działań.
  • Niektóre cechy, takie jak AssistantBroadcast, są dostępne tylko w interfejsie Automation API.
  • Polecenie okGoogle jest poleceniem na poziomie struktury i może służyć do automatyzacji dowolnego urządzenia w strukturze. Aplikacja interfejsów API Home może jednak nie mieć dostępu do wszystkich urządzeń. Zapoznaj się z uprawnieniami OkGoogle, aby dowiedzieć się, jak są one egzekwowane w różnych przypadkach.
  • Niektóre cechy wymagają spełnienia pewnych warunków wstępnych:
    • Aby korzystać z Time.ScheduledTimeEvent, struktura, w której działa automatyzacja, musi mieć adres ulicy skonfigurowany w Google Home app (GHA). Zmienianie adresu domowego w Google wyjaśnia, jak użytkownik może wpisać adres budynku. Jeśli adres nie jest skonfigurowany w GHA, nie uda się utworzyć automatyzacji i pojawi się błąd z komunikatem „Funkcja structure nie obsługuje zdarzenia o zaplanowanym czasie”.
    • Aby używać atrybutów AreaPresenceState lub AreaAttendanceState, użytkownik musi skonfigurować wykrywanie obecności w GHA.
    • Aby korzystać z cechy ObjectDetection, użytkownik musi mieć aktywną subskrypcję Nest Aware.

Uproszczone wersje niektórych atrybutów są też dostępne do stosowania w automatyzacjach. Więcej informacji znajdziesz w artykule Uproszczone cechy.

Blok wskazuje, że polecenie nie jest obsługiwane w automatyzacjach dotyczących co najmniej 1 typu urządzenia. Więcej informacji znajdziesz w artykule Zablokowane działania w automatyzacjach.

Cecha Typ cechy Typ elementu Element
AssistantBroadcast google Polecenie Transmisja
AssistantFulfillment google Polecenie OkGoogle
Powiadomienie google Polecenie SendNotifications
Czas google Zdarzenie ScheduledTimeEvent
Czas google Atrybut currentTime
Czas google Atrybut missingStructureLocation
Czas google Atrybut sunriseTime
Czas google Atrybut sunsetTime
VoiceStarter google Zdarzenie OkGoogleEvent
AirQuality matter Atrybut airQuality
ApplicationLauncher matter Polecenie LaunchApp
ApplicationLauncher matter Polecenie StopApp
ApplicationLauncher matter Atrybut currentApp
AudioOutput matter Atrybut currentOutput
CarbonDioxideConcentrationMeasurement matter Atrybut levelValue
CarbonDioxideConcentrationMeasurement matter Atrybut measuredValue
CarbonMonoxideConcentrationMeasurement matter Atrybut levelValue
CarbonMonoxideConcentrationMeasurement matter Atrybut maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Atrybut measuredValue
CarbonMonoxideConcentrationMeasurement matter Atrybut measurementUnit
CarbonMonoxideConcentrationMeasurement matter Atrybut minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Atrybut niepewność
Channel matter Polecenie ChangeChannelByNumber
Channel matter Polecenie SkipChannel
ColorControl matter Polecenie ColorLoopSet
ColorControl matter Polecenie MoveColor
ColorControl matter Polecenie MoveColorTemperature
ColorControl matter Polecenie MoveToColor
ColorControl matter Polecenie MoveToColorTemperature
ColorControl matter Polecenie MoveToHue
ColorControl matter Polecenie MoveToHueAndSaturation
ColorControl matter Polecenie MoveToSaturation
ColorControl matter Polecenie StepColor
ColorControl matter Polecenie StepColorTemperature
ColorControl matter Atrybut colorTemperatureMireds
ColorControl matter Atrybut currentHue
ColorControl matter Atrybut currentX
ColorControl matter Atrybut currentY
DishwasherMode matter Polecenie ChangeToMode
DishwasherMode matter Atrybut currentMode
DishwasherMode matter Atrybut onMode
DoorLock matter Zdarzenie DoorLockAlarm
DoorLock matter Zdarzenie DoorStateChange
DoorLock matter Polecenie LockDoor
DoorLock matter Zdarzenie LockOperation
DoorLock matter Zdarzenie LockOperationError
DoorLock matter Polecenie UnlockDoor
DoorLock matter Atrybut doorClosedEvents
DoorLock matter Atrybut doorOpenEvents
DoorLock matter Atrybut doorState
DoorLock matter Atrybut lockState
FanControl matter Polecenie Krok
FanControl matter Atrybut airflowDirection
FanControl matter Atrybut fanMode
FanControl matter Atrybut percentCurrent
FanControl matter Atrybut percentSetting
FanControl matter Atrybut speedCurrent
FanControl matter Atrybut speedSetting
FanControl matter Atrybut windSetting
FormaldehydeConcentrationMeasurement matter Atrybut levelValue
FormaldehydeConcentrationMeasurement matter Atrybut measuredValue
IlluminanceMeasurement matter Atrybut measuredValue
LaundryWasherMode matter Polecenie ChangeToMode
LaundryWasherMode matter Atrybut currentMode
LaundryWasherMode matter Atrybut onMode
LevelControl matter Polecenie Przenoszenie
LevelControl matter Polecenie MoveToLevel
LevelControl matter Polecenie MoveToLevelWithOnOff
LevelControl matter Polecenie MoveWithOnOff
LevelControl matter Polecenie Krok
LevelControl matter Polecenie StepWithOnOff
LevelControl matter Polecenie Zatrzymaj
LevelControl matter Polecenie StopWithOnOff
LevelControl matter Atrybut currentLevel
LevelControl matter Atrybut maxLevel
LevelControl matter Atrybut startUpCurrentLevel
MediaInput matter Polecenie RenameInput
MediaInput matter Polecenie SelectInput
MediaInput matter Atrybut currentInput
MediaPlayback matter Polecenie FastForward
MediaPlayback matter Polecenie Dalej
MediaPlayback matter Polecenie Wstrzymanie
MediaPlayback matter Polecenie Play
MediaPlayback matter Polecenie Wstecz
MediaPlayback matter Polecenie Przewiń do tyłu
MediaPlayback matter Polecenie SkipBackward
MediaPlayback matter Polecenie SkipForward
MediaPlayback matter Zdarzenie StateChanged
MediaPlayback matter Polecenie Zatrzymaj
MediaPlayback matter Atrybut currentState
ModeSelect matter Polecenie ChangeToMode block
ModeSelect matter Atrybut currentMode
ModeSelect matter Atrybut onMode
NitrogenDioxideConcentrationMeasurement matter Atrybut levelValue
NitrogenDioxideConcentrationMeasurement matter Atrybut measuredValue
OccupancySensing matter Atrybut liczba osób
OnOff matter Polecenie Wyłączono blokowanie
OnOff matter Polecenie Włączono blokowanie
OnOff matter Atrybut onOff
OperationalState matter Zdarzenie OperationCompletion
OperationalState matter Polecenie Wstrzymanie blokowanie
OperationalState matter Polecenie Wznów blokada
OperationalState matter Polecenie Zacznij
OperationalState matter Polecenie Zatrzymaj
OperationalState matter Atrybut currentPhase
OperationalState matter Atrybut operationalState
OzoneConcentrationMeasurement matter Atrybut levelValue
OzoneConcentrationMeasurement matter Atrybut measuredValue
Pm10ConcentrationMeasurement matter Atrybut levelValue
Pm10ConcentrationMeasurement matter Atrybut measuredValue
Pm25ConcentrationMeasurement matter Atrybut levelValue
Pm25ConcentrationMeasurement matter Atrybut measuredValue
PowerSource matter Atrybut batChargeState
PowerSource matter Atrybut batChargingCurrent
PowerSource matter Atrybut batTimeToFullCharge
RadonConcentrationMeasurement matter Atrybut levelValue
RadonConcentrationMeasurement matter Atrybut measuredValue
RelativeHumidityMeasurement matter Atrybut measuredValue
RvcCleanMode matter Polecenie ChangeToMode
RvcOperationalState matter Polecenie GoHome
RvcOperationalState matter Polecenie Wstrzymanie
RvcOperationalState matter Polecenie Wznów
RvcOperationalState matter Atrybut currentPhase
RvcOperationalState matter Atrybut operationalError
RvcOperationalState matter Atrybut operationalState
RvcRunMode matter Polecenie ChangeToMode
RvcRunMode matter Atrybut currentMode
Przełącz matter Zdarzenie InitialPress
Przełącz matter Zdarzenie LongPress
Przełącz matter Zdarzenie LongRelease
Przełącz matter Zdarzenie MultiPressComplete
Przełącz matter Zdarzenie MultiPressOngoing
Przełącz matter Zdarzenie ShortRelease
Przełącz matter Zdarzenie SwitchLatched
Przełącz matter Atrybut currentPosition
TemperatureControl matter Polecenie SetTemperature block
TemperatureControl matter Atrybut maxTemperature
TemperatureControl matter Atrybut minTemperature
TemperatureControl matter Atrybut selectedTemperatureLevel
TemperatureControl matter Atrybut temperatureSetpoint
TemperatureMeasurement matter Atrybut measuredValue
Termostat matter Polecenie SetpointRaiseLower
Termostat matter Atrybut activePresetHandle
Termostat matter Atrybut localTemperature
Termostat matter Atrybut liczba osób
Termostat matter Atrybut occupiedCoolingSetpoint
Termostat matter Atrybut occupiedHeatingSetpoint
Termostat matter Atrybut outdoorTemperature
Termostat matter Atrybut setpointChangeSource
Termostat matter Atrybut systemMode
Termostat matter Atrybut temperatureSetpointHold
Termostat matter Atrybut temperatureSetpointHoldDuration
Termostat matter Atrybut thermostatRunningMode
Termostat matter Atrybut thermostatRunningState
Termostat matter Atrybut unoccupiedCoolingSetpoint
Termostat matter Atrybut unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Atrybut levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Atrybut measuredValue
WindowCovering matter Polecenie DownOrClose
WindowCovering matter Polecenie GoToLiftPercentage
WindowCovering matter Polecenie GoToLiftValue
WindowCovering matter Polecenie GoToTiltPercentage
WindowCovering matter Polecenie GoToTiltValue
WindowCovering matter Polecenie StopMotion
WindowCovering matter Polecenie UpOrOpen
WindowCovering matter Atrybut currentPositionLift
WindowCovering matter Atrybut currentPositionLiftPercent100ths
WindowCovering matter Atrybut currentPositionLiftPercentage
WindowCovering matter Atrybut currentPositionTilt
WindowCovering matter Atrybut currentPositionTiltPercent100ths
WindowCovering matter Atrybut currentPositionTiltPercentage
WindowCovering matter Atrybut targetPositionLiftPercent100ths
WindowCovering matter Atrybut targetPositionTiltPercent100ths
ArmDisarm google Polecenie ArmDisarm block
ArmDisarm google Zdarzenie ArmDisarmArmState
ArmDisarm google Atrybut armState
ArmDisarm google Atrybut currentArmLevel
ArmDisarm google Atrybut isArmed
Dock google Polecenie Dock
Dock google Atrybut isDocked
DoorbellPress google Zdarzenie DoorbellPressed
ExtendedAirQuality google Zdarzenie AirQuality
ExtendedAirQuality google Atrybut indoorAirQuality
ExtendedAirQuality google Atrybut indoorMeasuredValue
ExtendedAirQuality google Atrybut measuredValue
ExtendedAirQuality google Atrybut outdoorAirQuality
ExtendedAirQuality google Atrybut outdoorMeasuredValue
ExtendedColorControl google Polecenie MoveToColorHSV
ExtendedColorControl google Polecenie MoveToColorName
ExtendedColorControl google Polecenie MoveToColorRGB
ExtendedColorControl google Atrybut currentBlue
ExtendedColorControl google Atrybut currentGreen
ExtendedColorControl google Atrybut currentHue
ExtendedColorControl google Atrybut currentName
ExtendedColorControl google Atrybut currentRed
ExtendedColorControl google Atrybut currentSaturation
ExtendedColorControl google Atrybut currentValue
ExtendedFanControl google Polecenie ToggleAirflowDirection
ExtendedFanControl google Atrybut customFanMode
ExtendedFanControl google Atrybut customFanModes
ExtendedMediaInput google Polecenie NextInput
ExtendedMediaInput google Polecenie PreviousInput
ExtendedMediaInput google Polecenie SelectCustomInput
ExtendedMediaInput google Atrybut currentCustomInput
ExtendedMediaInput google Atrybut customInputsList
ExtendedMediaInput google Atrybut customInputsOrdered
ExtendedOperationalState google Zdarzenie PauseUnpauseFollowUp
ExtendedOperationalState google Zdarzenie StartStopFollowUp
ExtendedPowerSource google Polecenie StartCharging
ExtendedPowerSource google Polecenie StopCharging
ExtendedThermostat google Atrybut activePresetHandle
ExtendedThermostat google Atrybut activeRemoteTemperatureSensorIds
ExtendedThermostat google Atrybut averageLocalTemperature
ExtendedThermostat google Atrybut extendedRunningMode
ExtendedThermostat google Atrybut extendedSystemMode
LightEffects google Polecenie PulseEffectSet
LightEffects google Polecenie SleepEffectSet
LightEffects google Polecenie StopEffect
LightEffects google Polecenie WakeEffectSet
LightEffects google Atrybut pulseEffectSet
LightEffects google Atrybut sleepEffectSet
LightEffects google Atrybut wakeEffectSet
LockUnlock google Polecenie Blokowanie
LockUnlock google Polecenie Odblokuj blokowanie
LockUnlock google Atrybut lockState
MotionDetection google Zdarzenie MotionDetected
MotionDetection google Atrybut motionDetectionEventInProgress
ObjectDetection google Zdarzenie ObjectDetected
OpenClose google Polecenie Zamknij blokowanie
OpenClose google Polecenie GoToOpenPercentage block
OpenClose google Polecenie Otwórz blok
OpenClose google Polecenie Krok block
OpenClose google Atrybut openPercent
OpenClose google Atrybut openState
OpenClose google Atrybut targetOpenPercent
Nagrywanie google Polecenie StartRecording
Nagrywanie google Polecenie StopRecording
Nagrywanie google Atrybut isCurrentlyRecording
Przełączniki google Polecenie ChangeToggleSettings block
Przełączniki google Atrybut currentToggleSettings
Jasność google Polecenie BrightnessStep
Jasność google Polecenie MoveToBrightness
Jasność google Atrybut currentBrightnessPercent
SimplifiedOnOff google Atrybut onOff
SimplifiedThermostat google Polecenie SetSystemMode
SimplifiedThermostat google Atrybut systemMode
Tom google Polecenie MoveToVolume
Tom google Polecenie Wycisz
Tom google Polecenie Wyłącz wyciszenie
Tom google Polecenie VolumeStep
Tom google Atrybut currentVolumePercent
Tom google Atrybut isMuted
AreaAttendanceState google Atrybut attendanceState
AreaPresenceState google Atrybut presenceState