Compatibilité avec les traits de l'API Automation

L'API Automation est compatible avec la plupart des caractéristiques, mais la compatibilité avec certains attributs, événements et commandes d'une caractéristique peut être limitée.

Pour vérifier que l'API Automation est compatible avec votre cas d'utilisation, recherchez dans le tableau ci-dessous.

En règle générale :

  • Tous les traits et types que vous prévoyez d'utiliser dans votre application avec l'API Automation doivent être enregistrés lors de l'initialisation. Consultez la section Créer une instance Home.
  • Vous pouvez utiliser n'importe quel attribut dans des déclencheurs ou des conditions.
  • Les appareils Cloud-to-cloud qui ne signalent pas leur état ne peuvent pas être utilisés comme déclencheurs dans les automatisations, créées manuellement ou via la découverte.
  • Même si un appareil est compatible avec les caractéristiques listées ici, il peut être bloqué en tant que déclencheur ou action dans l'API Automation en raison des seuils de qualité de l'état du rapport :
    • Les appareils dont le taux de réussite du rapport d'état est inférieur à 90% ne peuvent pas être utilisés comme déclencheurs.
    • Les appareils dont le taux de réussite de l'exécution des commandes est inférieur à 95% ne peuvent pas être utilisés comme actions.
  • Les commandes ne peuvent être utilisées qu'en tant qu'actions.
  • Certaines caractéristiques, comme AssistantBroadcast, ne sont disponibles que dans l'API Automation.
  • La commande okGoogle est une commande au niveau de la structure et peut être utilisée pour automatiser n'importe quel appareil de la structure. Toutefois, il est possible qu'une application utilisant les API Home n'ait pas accès à tous les appareils. Consultez la section Autorisations Ok Google pour découvrir comment les autorisations sont appliquées dans différents cas.
  • Certaines caractéristiques nécessitent des prérequis :
    • Pour utiliser Time.ScheduledTimeEvent, la structure dans laquelle l'automatisation s'exécute doit disposer d'une adresse qui a été configurée dans Google Home app (GHA). Modifier l'adresse Google explique comment un utilisateur peut saisir l'adresse de la structure. Si l'adresse n'est pas configurée dans GHA, la création de l'automatisation échoue et une erreur est générée avec le message "Le ScheduledTimeEvent n'est pas compatible avec structure."
    • Pour utiliser les traits AreaPresenceState ou AreaAttendanceState, l'utilisateur doit configurer la détection de présence dans le GHA.
    • Pour utiliser la caractéristique ObjectDetection, l'utilisateur doit disposer d'un abonnement Nest Aware valide.

Des versions simplifiées de certaines caractéristiques sont également disponibles pour les automatisations. Pour en savoir plus, consultez la section Caractéristiques simplifiées.

Un bloc indique que la commande n'est pas compatible avec les automatisations pour un ou plusieurs types d'appareils. Pour en savoir plus, consultez la section Actions bloquées dans les automatisations.

Trait Type de trait Type d'élément Élément
AssistantBroadcast google Commande Annonce
AssistantFulfillment google Commande OkGoogle
Notification google Commande SendNotifications
Heure google Événement ScheduledTimeEvent
Heure google Attribut currentTime
Heure google Attribut missingStructureLocation
Heure google Attribut sunriseTime
Heure google Attribut sunsetTime
VoiceStarter google Événement OkGoogleEvent
AirQuality matter Attribut airQuality
ApplicationLauncher matter Commande LaunchApp
ApplicationLauncher matter Commande StopApp
ApplicationLauncher matter Attribut currentApp
AudioOutput matter Attribut currentOutput
CarbonDioxideConcentrationMeasurement matter Attribut levelValue
CarbonDioxideConcentrationMeasurement matière Attribut measuredValue
CarbonMonoxideConcentrationMeasurement matière Attribut levelValue
CarbonMonoxideConcentrationMeasurement matter Attribut maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matière Attribut measuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut measurementUnit
CarbonMonoxideConcentrationMeasurement matter Attribut minMeasuredValue
CarbonMonoxideConcentrationMeasurement matière Attribut uncertainty
Chaîne matter Commande ChangeChannelByNumber
Chaîne matter Commande SkipChannel
ColorControl matter Commande ColorLoopSet
ColorControl matière Commande MoveColor
ColorControl matter Commande MoveColorTemperature
ColorControl matter Commande MoveToColor
ColorControl matière Commande MoveToColorTemperature
ColorControl matière Commande MoveToHue
ColorControl matière Commande MoveToHueAndSaturation
ColorControl matter Commande MoveToSaturation
ColorControl matter Commande StepColor
ColorControl matter Commande StepColorTemperature
ColorControl matière Attribut colorTemperatureMireds
ColorControl matter Attribut currentHue
ColorControl matter Attribut currentX
ColorControl matière Attribut currentY
DishwasherMode matière Commande ChangeToMode
DishwasherMode matter Attribut currentMode
DishwasherMode matter Attribut onMode
DoorLock matter Événement DoorLockAlarm
DoorLock matière Événement DoorStateChange
DoorLock matter Commande LockDoor
DoorLock matière Événement LockOperation
DoorLock matter Événement LockOperationError
DoorLock matter Commande UnlockDoor
DoorLock matter Attribut doorClosedEvents
DoorLock matter Attribut doorOpenEvents
DoorLock matter Attribut doorState
DoorLock matter Attribut lockState
FanControl matter Commande étape
FanControl matter Attribut airflowDirection
FanControl matter Attribut fanMode
FanControl matter Attribut percentCurrent
FanControl matière Attribut percentSetting
FanControl matter Attribut speedCurrent
FanControl matière Attribut speedSetting
FanControl matière Attribut windSetting
FormaldehydeConcentrationMeasurement matière Attribut levelValue
FormaldehydeConcentrationMeasurement matière Attribut measuredValue
IlluminanceMeasurement matter Attribut measuredValue
LaundryWasherMode matter Commande ChangeToMode
LaundryWasherMode matter Attribut currentMode
LaundryWasherMode matter Attribut onMode
LevelControl matière Commande Déplacer
LevelControl matière Commande MoveToLevel
LevelControl matière Commande MoveToLevelWithOnOff
LevelControl matter Commande MoveWithOnOff
LevelControl matter Commande étape
LevelControl matière Commande StepWithOnOff
LevelControl matter Commande Arrêter
LevelControl matter Commande StopWithOnOff
LevelControl matière Attribut currentLevel
LevelControl matter Attribut maxLevel
LevelControl matière Attribut startUpCurrentLevel
MediaInput matter Commande RenameInput
MediaInput matter Commande SelectInput
MediaInput matter Attribut currentInput
MediaPlayback matière Commande FastForward
MediaPlayback matière Commande Suivant
MediaPlayback matter Commande Mettre en pause
MediaPlayback matter Commande Jouer
MediaPlayback matter Commande Précédent
MediaPlayback matter Commande Retour arrière
MediaPlayback matière Commande SkipBackward
MediaPlayback matière Commande SkipForward
MediaPlayback matter Événement StateChanged
MediaPlayback matière Commande Arrêter
MediaPlayback matter Attribut currentState
ModeSelect matière Commande ChangeToMode block
ModeSelect matter Attribut currentMode
ModeSelect matter Attribut onMode
NitrogenDioxideConcentrationMeasurement matière Attribut levelValue
NitrogenDioxideConcentrationMeasurement matière Attribut measuredValue
OccupancySensing matter Attribut occupation
OnOff matière Commande Désactivé bloquer
OnOff matter Commande Activer le blocage
OnOff matter Attribut onOff
OperationalState matière Événement OperationCompletion
OperationalState matter Commande Mettre en pause bloc
OperationalState matter Commande Bloc de reprise
OperationalState matter Commande Démarrer
OperationalState matter Commande Arrêter
OperationalState matter Attribut currentPhase
OperationalState matter Attribut operationalState
OzoneConcentrationMeasurement matter Attribut levelValue
OzoneConcentrationMeasurement matière Attribut measuredValue
Pm10ConcentrationMeasurement matière Attribut levelValue
Pm10ConcentrationMeasurement matière Attribut measuredValue
Pm25ConcentrationMeasurement matière Attribut levelValue
Pm25ConcentrationMeasurement matière Attribut measuredValue
PowerSource matter Attribut batChargeState
PowerSource matter Attribut batChargingCurrent
PowerSource matter Attribut batTimeToFullCharge
RadonConcentrationMeasurement matter Attribut levelValue
RadonConcentrationMeasurement matière Attribut measuredValue
RelativeHumidityMeasurement matter Attribut measuredValue
RvcCleanMode matter Commande ChangeToMode
RvcOperationalState matter Commande GoHome
RvcOperationalState matter Commande Mettre en pause
RvcOperationalState matter Commande Reprendre
RvcOperationalState matter Attribut currentPhase
RvcOperationalState matter Attribut operationalError
RvcOperationalState matter Attribut operationalState
RvcRunMode matière Commande ChangeToMode
RvcRunMode matter Attribut currentMode
Commutateur matter Événement InitialPress
Commutateur matière Événement LongPress
Commutateur matter Événement LongRelease
Commutateur matter Événement MultiPressComplete
Commutateur matter Événement MultiPressOngoing
Commutateur matter Événement ShortRelease
Commutateur matter Événement SwitchLatched
Commutateur matière Attribut currentPosition
TemperatureControl matter Commande SetTemperature block
TemperatureControl matière Attribut maxTemperature
TemperatureControl matter Attribut minTemperature
TemperatureControl matter Attribut selectedTemperatureLevel
TemperatureControl matière Attribut temperatureSetpoint
TemperatureMeasurement matter Attribut measuredValue
Thermostat matter Commande SetpointRaiseLower
Thermostat matter Attribut activePresetHandle
Thermostat matter Attribut localTemperature
Thermostat matter Attribut occupation
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 matière Attribut thermostatRunningMode
Thermostat matter Attribut thermostatRunningState
Thermostat matter Attribut unoccupiedCoolingSetpoint
Thermostat matter Attribut unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attribut levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attribut measuredValue
WindowCovering matter Commande DownOrClose
WindowCovering matter Commande GoToLiftPercentage
WindowCovering matter Commande GoToLiftValue
WindowCovering matière Commande GoToTiltPercentage
WindowCovering matière Commande GoToTiltValue
WindowCovering matter Commande StopMotion
WindowCovering matière Commande UpOrOpen
WindowCovering matière 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 Commande ArmDisarm block
ArmDisarm google Événement ArmDisarmArmState
ArmDisarm google Attribut armState
ArmDisarm google Attribut currentArmLevel
ArmDisarm google Attribut isArmed
Station d'accueil google Commande Station d'accueil
Station d'accueil google Attribut isDocked
DoorbellPress google Événement DoorbellPressed
ExtendedAirQuality google Événement AirQuality
ExtendedAirQuality google Attribut indoorAirQuality
ExtendedAirQuality google Attribut indoorMeasuredValue
ExtendedAirQuality google Attribut measuredValue
ExtendedAirQuality google Attribut outdoorAirQuality
ExtendedAirQuality google Attribut outdoorMeasuredValue
ExtendedColorControl google Commande MoveToColorHSV
ExtendedColorControl google Commande MoveToColorName
ExtendedColorControl google Commande 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 Commande ToggleAirflowDirection
ExtendedFanControl google Attribut customFanMode
ExtendedFanControl google Attribut customFanModes
ExtendedMediaInput google Commande NextInput
ExtendedMediaInput google Commande PreviousInput
ExtendedMediaInput google Commande SelectCustomInput
ExtendedMediaInput google Attribut currentCustomInput
ExtendedMediaInput google Attribut customInputsList
ExtendedMediaInput google Attribut customInputsOrdered
ExtendedOperationalState google Événement PauseUnpauseFollowUp
ExtendedOperationalState google Événement StartStopFollowUp
ExtendedPowerSource google Commande StartCharging
ExtendedPowerSource google Commande StopCharging
ExtendedThermostat google Attribut activePresetHandle
ExtendedThermostat google Attribut activeRemoteTemperatureSensorIds
ExtendedThermostat google Attribut averageLocalTemperature
ExtendedThermostat google Attribut extendedRunningMode
ExtendedThermostat google Attribut extendedSystemMode
LightEffects google Commande PulseEffectSet
LightEffects google Commande SleepEffectSet
LightEffects google Commande StopEffect
LightEffects google Commande WakeEffectSet
LightEffects google Attribut pulseEffectSet
LightEffects google Attribut sleepEffectSet
LightEffects google Attribut wakeEffectSet
LockUnlock google Commande Serrure
LockUnlock google Commande Déverrouiller le bloc
LockUnlock google Attribut lockState
MotionDetection google Événement MotionDetected
MotionDetection google Attribut motionDetectionEventInProgress
ObjectDetection google Événement ObjectDetected
OpenClose google Commande Close block
OpenClose google Commande GoToOpenPercentage bloc
OpenClose google Commande Open block
OpenClose google Commande Étape bloc
OpenClose google Attribut openPercent
OpenClose google Attribut openState
OpenClose google Attribut targetOpenPercent
Enregistrer google Commande StartRecording
Enregistrer google Commande StopRecording
Enregistrer google Attribut isCurrentlyRecording
Boutons d'activation/de désactivation google Commande ChangeToggleSettings block
Boutons d'activation/de désactivation google Attribut currentToggleSettings
Luminosité google Commande BrightnessStep
Luminosité google Commande MoveToBrightness
Luminosité google Attribut currentBrightnessPercent
SimplifiedOnOff google Attribut onOff
SimplifiedThermostat google Commande SetSystemMode
SimplifiedThermostat google Attribut systemMode
Volume google Commande MoveToVolume
Volume google Commande Couper le son
Volume google Commande Réactiver le son
Volume google Commande VolumeStep
Volume google Attribut currentVolumePercent
Volume google Attribut isMuted
AreaAttendanceState google Attribut attendanceState
AreaPresenceState google Attribut presenceState