Unterstützung von Automatisierungs-API-Attributen

Die Automation API unterstützt die meisten Eigenschaften, aber die Unterstützung für einige Attribute, Ereignisse und Befehle in einer Eigenschaft kann eingeschränkt sein.

Ob die Automation API Ihren Anwendungsfall unterstützt, sehen Sie in der folgenden Tabelle.

Allgemein gilt:

  • Alle Merkmale und Typen, die Sie in Ihrer App mit der Automation API verwenden möchten, müssen bei der Initialisierung registriert werden. Weitere Informationen finden Sie unter Zuhause-Instanz erstellen.
  • Jedes Attribut kann in Auslösern oder Bedingungen verwendet werden.
  • Cloud-to-cloud-Geräte, die ihren Status nicht melden, können nicht als Trigger in Automatisierungen verwendet werden, die entweder manuell oder durch die Suche erstellt wurden.
  • Auch wenn ein Gerät die hier aufgeführten Eigenschaften unterstützt, kann es aufgrund von Qualitätsgrenzwerten für den Status des Berichts nicht als Auslöser oder Aktion in der Automation API verwendet werden:
    • Geräte mit einer Erfolgsquote von weniger als 90% für den Berichtsstatus können nicht als Auslöser verwendet werden.
    • Geräte mit einer Erfolgsquote bei der Befehlsausführung von weniger als 95% können nicht für Aktionen verwendet werden.
  • Befehle können nur als Aktionen verwendet werden.
  • Einige Merkmale wie AssistantBroadcast sind nur für die Verwendung in der Automation API verfügbar.
  • Der Befehl okGoogle gilt für die gesamte Struktur und kann verwendet werden, um jedes Gerät in der Struktur zu automatisieren. Eine Home APIs-App hat jedoch möglicherweise nicht auf jedes Gerät Zugriff. Unter OkGoogle-Berechtigungen erfahren Sie, wie Berechtigungen in verschiedenen Fällen erzwungen werden.
  • Für einige Merkmale gelten Voraussetzungen:
    • Damit Time.ScheduledTimeEvent verwendet werden kann, muss das Gebäude, in dem die Automatisierung ausgeführt wird, eine Adresse haben, die in Google Home app (GHA) eingerichtet wurde. Unter Google-Privatadresse ändern wird erläutert, wie ein Nutzer die Adresse des Gebäudes eingeben kann. Wenn die Adresse nicht in der GHA eingerichtet ist, kann die Automatisierung nicht erstellt werden und es wird die Fehlermeldung „Das ScheduledTimeEvent wird von der structure nicht unterstützt“ ausgegeben.
    • Wenn der Nutzer die Merkmale AreaPresenceState oder AreaAttendanceState verwenden möchte, muss er die Anwesenheitserkennung in der GHA einrichten.
    • Um das Attribut ObjectDetection verwenden zu können, muss der Nutzer ein aktives Nest Aware-Abo haben.

Für einige Merkmale sind auch vereinfachte Versionen verfügbar, die in Automatisierungen verwendet werden können. Weitere Informationen finden Sie unter Vereinfachte Merkmale.

Ein Block gibt an, dass der Befehl in Automatisierungen für einen oder mehrere Gerätetypen nicht unterstützt wird. Weitere Informationen finden Sie unter Blockierte Aktionen in Automatisierungen.

Merkmal Merkmaltyp Elementtyp Element
AssistantBroadcast google Befehl Broadcast
AssistantFulfillment google Befehl OkGoogle
Benachrichtigung google Befehl SendNotifications
Zeit google Ereignis ScheduledTimeEvent
Zeit google Attribut currentTime
Zeit google Attribut missingStructureLocation
Zeit google Attribut sunriseTime
Zeit google Attribut sunsetTime
VoiceStarter google Ereignis OkGoogleEvent
AirQuality matter Attribut airQuality
ApplicationLauncher matter Befehl LaunchApp
ApplicationLauncher matter Befehl StopApp
ApplicationLauncher matter Attribut currentApp
AudioOutput matter Attribut currentOutput
CarbonDioxideConcentrationMeasurement matter Attribut levelValue
CarbonDioxideConcentrationMeasurement matter Attribut measuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut levelValue
CarbonMonoxideConcentrationMeasurement matter Attribut maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut measuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut measurementUnit
CarbonMonoxideConcentrationMeasurement matter Attribut minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut Unsicherheit
Kanal matter Befehl ChangeChannelByNumber
Kanal matter Befehl SkipChannel
ColorControl matter Befehl ColorLoopSet
ColorControl matter Befehl MoveColor
ColorControl matter Befehl MoveColorTemperature
ColorControl matter Befehl MoveToColor
ColorControl matter Befehl MoveToColorTemperature
ColorControl matter Befehl MoveToHue
ColorControl matter Befehl MoveToHueAndSaturation
ColorControl matter Befehl MoveToSaturation
ColorControl matter Befehl StepColor
ColorControl matter Befehl StepColorTemperature
ColorControl matter Attribut colorTemperatureMireds
ColorControl matter Attribut currentHue
ColorControl matter Attribut currentX
ColorControl matter Attribut currentY
DishwasherMode matter Befehl ChangeToMode
DishwasherMode matter Attribut currentMode
DishwasherMode matter Attribut onMode
DoorLock matter Ereignis DoorLockAlarm
DoorLock matter Ereignis DoorStateChange
DoorLock matter Befehl LockDoor
DoorLock matter Ereignis LockOperation
DoorLock matter Ereignis LockOperationError
DoorLock matter Befehl UnlockDoor
DoorLock matter Attribut doorClosedEvents
DoorLock matter Attribut doorOpenEvents
DoorLock matter Attribut doorState
DoorLock matter Attribut lockState
FanControl matter Befehl Schritt
FanControl matter Attribut airflowDirection
FanControl matter Attribut fanMode
FanControl matter Attribut percentCurrent
FanControl matter Attribut percentSetting
FanControl matter Attribut speedCurrent
FanControl matter Attribut speedSetting
FanControl matter Attribut windSetting
FormaldehydeConcentrationMeasurement matter Attribut levelValue
FormaldehydeConcentrationMeasurement matter Attribut measuredValue
IlluminanceMeasurement matter Attribut measuredValue
LaundryWasherMode matter Befehl ChangeToMode
LaundryWasherMode matter Attribut currentMode
LaundryWasherMode matter Attribut onMode
LevelControl matter Befehl Verschieben
LevelControl matter Befehl MoveToLevel
LevelControl matter Befehl MoveToLevelWithOnOff
LevelControl matter Befehl MoveWithOnOff
LevelControl matter Befehl Schritt
LevelControl matter Befehl StepWithOnOff
LevelControl matter Befehl Stop
LevelControl matter Befehl StopWithOnOff
LevelControl matter Attribut currentLevel
LevelControl matter Attribut maxLevel
LevelControl matter Attribut startUpCurrentLevel
MediaInput matter Befehl RenameInput
MediaInput matter Befehl SelectInput
MediaInput matter Attribut currentInput
MediaPlayback matter Befehl FastForward
MediaPlayback matter Befehl Weiter
MediaPlayback matter Befehl Pausieren
MediaPlayback matter Befehl Wiedergabe
MediaPlayback matter Befehl Vorherige
MediaPlayback matter Befehl Zurückspulen
MediaPlayback matter Befehl SkipBackward
MediaPlayback matter Befehl SkipForward
MediaPlayback matter Ereignis StateChanged
MediaPlayback matter Befehl Stop
MediaPlayback matter Attribut currentState
ModeSelect matter Befehl ChangeToMode block
ModeSelect matter Attribut currentMode
ModeSelect matter Attribut onMode
NitrogenDioxideConcentrationMeasurement matter Attribut levelValue
NitrogenDioxideConcentrationMeasurement matter Attribut measuredValue
OccupancySensing matter Attribut Belegung
OnOff matter Befehl Aus blockieren
OnOff matter Befehl On block
OnOff matter Attribut onOff
OperationalState matter Ereignis OperationCompletion
OperationalState matter Befehl Pausieren block
OperationalState matter Befehl Resume block
OperationalState matter Befehl Starten
OperationalState matter Befehl Stop
OperationalState matter Attribut currentPhase
OperationalState matter Attribut operationalState
OzoneConcentrationMeasurement matter Attribut levelValue
OzoneConcentrationMeasurement matter Attribut measuredValue
Pm10ConcentrationMeasurement matter Attribut levelValue
Pm10ConcentrationMeasurement matter Attribut measuredValue
Pm25ConcentrationMeasurement matter Attribut levelValue
Pm25ConcentrationMeasurement matter Attribut measuredValue
PowerSource matter Attribut batChargeState
PowerSource matter Attribut batChargingCurrent
PowerSource matter Attribut batTimeToFullCharge
RadonConcentrationMeasurement matter Attribut levelValue
RadonConcentrationMeasurement matter Attribut measuredValue
RelativeHumidityMeasurement matter Attribut measuredValue
RvcCleanMode matter Befehl ChangeToMode
RvcOperationalState matter Befehl GoHome
RvcOperationalState matter Befehl Pausieren
RvcOperationalState matter Befehl Fortsetzen
RvcOperationalState matter Attribut currentPhase
RvcOperationalState matter Attribut operationalError
RvcOperationalState matter Attribut operationalState
RvcRunMode matter Befehl ChangeToMode
RvcRunMode matter Attribut currentMode
Switch matter Ereignis InitialPress
Switch matter Ereignis LongPress
Switch matter Ereignis LongRelease
Switch matter Ereignis MultiPressComplete
Switch matter Ereignis MultiPressOngoing
Switch matter Ereignis ShortRelease
Switch matter Ereignis SwitchLatched
Switch matter Attribut currentPosition
TemperatureControl matter Befehl SetTemperature block
TemperatureControl matter Attribut maxTemperature
TemperatureControl matter Attribut minTemperature
TemperatureControl matter Attribut selectedTemperatureLevel
TemperatureControl matter Attribut temperatureSetpoint
TemperatureMeasurement matter Attribut measuredValue
Thermostat matter Befehl SetpointRaiseLower
Thermostat matter Attribut activePresetHandle
Thermostat matter Attribut localTemperature
Thermostat matter Attribut Belegung
Thermostat matter Attribut occupiedCoolingSetpoint
Thermostat matter Attribut occupiedHeatingSetpoint
Thermostat matter Attribut outdoorTemperature
Thermostat matter Attribut setpointChangeSource
Thermostat matter Attribut systemMode
Thermostat matter Attribut temperatureSetpointHold
Thermostat matter Attribut temperatureSetpointHoldDuration
Thermostat matter Attribut thermostatRunningMode
Thermostat matter Attribut thermostatRunningState
Thermostat matter Attribut unoccupiedCoolingSetpoint
Thermostat matter Attribut unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attribut levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attribut measuredValue
WindowCovering matter Befehl DownOrClose
WindowCovering matter Befehl GoToLiftPercentage
WindowCovering matter Befehl GoToLiftValue
WindowCovering matter Befehl GoToTiltPercentage
WindowCovering matter Befehl GoToTiltValue
WindowCovering matter Befehl StopMotion
WindowCovering matter Befehl UpOrOpen
WindowCovering matter Attribut currentPositionLift
WindowCovering matter Attribut currentPositionLiftPercent100ths
WindowCovering matter Attribut currentPositionLiftPercentage
WindowCovering matter Attribut currentPositionTilt
WindowCovering matter Attribut currentPositionTiltPercent100ths
WindowCovering matter Attribut currentPositionTiltPercentage
WindowCovering matter Attribut targetPositionLiftPercent100ths
WindowCovering matter Attribut targetPositionTiltPercent100ths
ArmDisarm google Befehl ArmDisarm block
ArmDisarm google Ereignis ArmDisarmArmState
ArmDisarm google Attribut armState
ArmDisarm google Attribut currentArmLevel
ArmDisarm google Attribut isArmed
Dock google Befehl Dock
Dock google Attribut isDocked
DoorbellPress google Ereignis DoorbellPressed
ExtendedAirQuality google Ereignis AirQuality
ExtendedAirQuality google Attribut indoorAirQuality
ExtendedAirQuality google Attribut indoorMeasuredValue
ExtendedAirQuality google Attribut measuredValue
ExtendedAirQuality google Attribut outdoorAirQuality
ExtendedAirQuality google Attribut outdoorMeasuredValue
ExtendedColorControl google Befehl MoveToColorHSV
ExtendedColorControl google Befehl MoveToColorName
ExtendedColorControl google Befehl MoveToColorRGB
ExtendedColorControl google Attribut currentBlue
ExtendedColorControl google Attribut currentGreen
ExtendedColorControl google Attribut currentHue
ExtendedColorControl google Attribut currentName
ExtendedColorControl google Attribut currentRed
ExtendedColorControl google Attribut currentSaturation
ExtendedColorControl google Attribut currentValue
ExtendedFanControl google Befehl ToggleAirflowDirection
ExtendedFanControl google Attribut customFanMode
ExtendedFanControl google Attribut customFanModes
ExtendedMediaInput google Befehl NextInput
ExtendedMediaInput google Befehl PreviousInput
ExtendedMediaInput google Befehl SelectCustomInput
ExtendedMediaInput google Attribut currentCustomInput
ExtendedMediaInput google Attribut customInputsList
ExtendedMediaInput google Attribut customInputsOrdered
ExtendedOperationalState google Ereignis PauseUnpauseFollowUp
ExtendedOperationalState google Ereignis StartStopFollowUp
ExtendedPowerSource google Befehl StartCharging
ExtendedPowerSource google Befehl StopCharging
ExtendedThermostat google Attribut activePresetHandle
ExtendedThermostat google Attribut activeRemoteTemperatureSensorIds
ExtendedThermostat google Attribut averageLocalTemperature
ExtendedThermostat google Attribut extendedRunningMode
ExtendedThermostat google Attribut extendedSystemMode
LightEffects google Befehl PulseEffectSet
LightEffects google Befehl SleepEffectSet
LightEffects google Befehl StopEffect
LightEffects google Befehl WakeEffectSet
LightEffects google Attribut pulseEffectSet
LightEffects google Attribut sleepEffectSet
LightEffects google Attribut wakeEffectSet
LockUnlock google Befehl Sperren
LockUnlock google Befehl Entsperrungs block
LockUnlock google Attribut lockState
MotionDetection google Ereignis MotionDetected
MotionDetection google Attribut motionDetectionEventInProgress
ObjectDetection google Ereignis ObjectDetected
OpenClose google Befehl Schließen block
OpenClose google Befehl GoToOpenPercentage block
OpenClose google Befehl Offen Block
OpenClose google Befehl Schritt blockieren
OpenClose google Attribut openPercent
OpenClose google Attribut openState
OpenClose google Attribut targetOpenPercent
Aufzeichnen google Befehl StartRecording
Aufzeichnen google Befehl StopRecording
Aufzeichnen google Attribut isCurrentlyRecording
Ein-/Aus-Schaltflächen google Befehl ChangeToggleSettings block
Ein-/Aus-Schaltflächen google Attribut currentToggleSettings
Helligkeit google Befehl BrightnessStep
Helligkeit google Befehl MoveToBrightness
Helligkeit google Attribut currentBrightnessPercent
SimplifiedOnOff google Attribut onOff
SimplifiedThermostat google Befehl SetSystemMode
SimplifiedThermostat google Attribut systemMode
Lautstärke google Befehl MoveToVolume
Lautstärke google Befehl Stummschalten
Lautstärke google Befehl Stummschaltung aufheben
Lautstärke google Befehl VolumeStep
Lautstärke google Attribut currentVolumePercent
Lautstärke google Attribut isMuted
AreaAttendanceState google Attribut attendanceState
AreaPresenceState google Attribut presenceState