Supporto dei tratti dell'API Automation

L'API Automation supporta la maggior parte dei tratti, ma il supporto di alcuni attributi, eventi e comandi in un tratto potrebbe essere limitato.

Per verificare che l'API Automation supporti il tuo caso d'uso, cerca nella tabella riportata di seguito.

In generale:

  • Tutti i tratti e i tipi che intendi utilizzare nella tua app con l'API Automation devono essere registrati all'inizializzazione. Consulta Creare un'istanza di Home.
  • Qualsiasi attributo può essere utilizzato nei comandi iniziali o nelle condizioni.
  • I dispositivi Cloud-to-cloud che non segnalano il proprio stato non possono essere utilizzati come attivatori nelle automazioni, create manualmente o tramite il rilevamento.
  • Anche se un dispositivo supporta i trait elencati qui, l'utilizzo come comando iniziale o azione nell'API Automation potrebbe essere bloccato a causa delle soglie di qualità dello stato del report:
    • L'utilizzo come comandi iniziali è bloccato per i dispositivi con un tasso di successo dello stato del report inferiore al 90%.
    • I dispositivi con un tasso di successo nell'esecuzione dei comandi inferiore al 95% sono bloccati per l'utilizzo come azioni.
  • I comandi possono essere utilizzati solo come azioni.
  • Alcuni tratti, come AssistantBroadcast, possono essere utilizzati solo nell'API Automation.
  • Il comando okGoogle è un comando a livello di struttura e può essere utilizzato per automatizzare qualsiasi dispositivo nella struttura. Tuttavia, un'app per le API Home potrebbe non avere accesso a tutti i dispositivi. Consulta la sezione Autorizzazioni di Hey Google per scoprire come vengono applicate le autorizzazioni in vari casi.
  • Alcuni tratti hanno dei prerequisiti:
    • Per utilizzare Time.ScheduledTimeEvent, la struttura in cui viene eseguita l'automazione deve avere un indirizzo stradale che è stato configurato in Google Home app (GHA). L'articolo Modificare l'indirizzo di casa di Google spiega in che modo un utente può inserire l'indirizzo della struttura. Se l'indirizzo non è configurato in GHA, la creazione dell'automazione non riesce e viene generato un errore con il messaggio "L'evento ScheduledTime non è supportato da structure".
    • Per utilizzare gli attributi AreaPresenceState o AreaAttendanceState, l'utente deve configurare il rilevamento della presenza in GHA.
    • Per utilizzare il tratto ObjectDetection, l'utente deve disporre di un abbonamento Nest Aware attivo.

Sono disponibili anche versioni semplificate di alcuni tratti da utilizzare nelle automazioni. Per ulteriori informazioni, consulta Caratteristiche semplificate.

Un blocco indica che il comando non è supportato nelle automazioni per uno o più tipi di dispositivi. Per ulteriori informazioni, consulta Azioni bloccate nelle automazioni.

Tratto Tipo di tratto Tipo di elemento Elemento
AssistantBroadcast google Comando Trasmissione
AssistantFulfillment google Comando OkGoogle
Notifica google Comando SendNotifications
Ora google Evento ScheduledTimeEvent
Ora google Attributo currentTime
Ora google Attributo missingStructureLocation
Ora google Attributo sunriseTime
Ora google Attributo sunsetTime
VoiceStarter google Evento OkGoogleEvent
AirQuality matter Attributo airQuality
ApplicationLauncher matter Comando LaunchApp
ApplicationLauncher matter Comando StopApp
ApplicationLauncher matter Attributo currentApp
AudioOutput matter Attributo currentOutput
CarbonDioxideConcentrationMeasurement matter Attributo levelValue
CarbonDioxideConcentrationMeasurement matter Attributo measuredValue
CarbonMonoxideConcentrationMeasurement matter Attributo levelValue
CarbonMonoxideConcentrationMeasurement matter Attributo maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Attributo measuredValue
CarbonMonoxideConcentrationMeasurement matter Attributo measurementUnit
CarbonMonoxideConcentrationMeasurement matter Attributo minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Attributo incertezza
Canale matter Comando ChangeChannelByNumber
Canale matter Comando SkipChannel
ColorControl matter Comando ColorLoopSet
ColorControl matter Comando MoveColor
ColorControl matter Comando MoveColorTemperature
ColorControl matter Comando MoveToColor
ColorControl matter Comando MoveToColorTemperature
ColorControl matter Comando MoveToHue
ColorControl matter Comando MoveToHueAndSaturation
ColorControl matter Comando MoveToSaturation
ColorControl matter Comando StepColor
ColorControl matter Comando StepColorTemperature
ColorControl matter Attributo colorTemperatureMireds
ColorControl matter Attributo currentHue
ColorControl matter Attributo currentX
ColorControl matter Attributo currentY
DishwasherMode matter Comando ChangeToMode
DishwasherMode matter Attributo currentMode
DishwasherMode matter Attributo onMode
DoorLock matter Evento DoorLockAlarm
DoorLock matter Evento DoorStateChange
DoorLock matter Comando LockDoor
DoorLock matter Evento LockOperation
DoorLock matter Evento LockOperationError
DoorLock matter Comando UnlockDoor
DoorLock matter Attributo doorClosedEvents
DoorLock matter Attributo doorOpenEvents
DoorLock matter Attributo doorState
DoorLock matter Attributo lockState
FanControl matter Comando Passaggio
FanControl matter Attributo airflowDirection
FanControl matter Attributo fanMode
FanControl matter Attributo percentCurrent
FanControl matter Attributo percentSetting
FanControl matter Attributo speedCurrent
FanControl matter Attributo speedSetting
FanControl matter Attributo windSetting
FormaldehydeConcentrationMeasurement matter Attributo levelValue
FormaldehydeConcentrationMeasurement matter Attributo measuredValue
IlluminanceMeasurement matter Attributo measuredValue
LaundryWasherMode matter Comando ChangeToMode
LaundryWasherMode matter Attributo currentMode
LaundryWasherMode matter Attributo onMode
LevelControl matter Comando Sposta
LevelControl matter Comando MoveToLevel
LevelControl matter Comando MoveToLevelWithOnOff
LevelControl matter Comando MoveWithOnOff
LevelControl matter Comando Passaggio
LevelControl matter Comando StepWithOnOff
LevelControl matter Comando Interrompi
LevelControl matter Comando StopWithOnOff
LevelControl matter Attributo currentLevel
LevelControl matter Attributo maxLevel
LevelControl matter Attributo startUpCurrentLevel
MediaInput matter Comando RenameInput
MediaInput matter Comando SelectInput
MediaInput matter Attributo currentInput
MediaPlayback matter Comando FastForward
MediaPlayback matter Comando Avanti
MediaPlayback matter Comando Metti in pausa
MediaPlayback matter Comando Riproduci
MediaPlayback matter Comando Indietro
MediaPlayback matter Comando Torna indietro
MediaPlayback matter Comando SkipBackward
MediaPlayback matter Comando SkipForward
MediaPlayback matter Evento StateChanged
MediaPlayback matter Comando Interrompi
MediaPlayback matter Attributo currentState
ModeSelect matter Comando ChangeToMode block
ModeSelect matter Attributo currentMode
ModeSelect matter Attributo onMode
NitrogenDioxideConcentrationMeasurement matter Attributo levelValue
NitrogenDioxideConcentrationMeasurement matter Attributo measuredValue
OccupancySensing matter Attributo numero di persone
OnOff matter Comando Off blocca
OnOff matter Comando On block
OnOff matter Attributo onOff
OperationalState matter Evento OperationCompletion
OperationalState matter Comando Blocco in pausa
OperationalState matter Comando Riprendi blocco
OperationalState matter Comando Inizia
OperationalState matter Comando Interrompi
OperationalState matter Attributo currentPhase
OperationalState matter Attributo operationalState
OzoneConcentrationMeasurement matter Attributo levelValue
OzoneConcentrationMeasurement matter Attributo measuredValue
Pm10ConcentrationMeasurement matter Attributo levelValue
Pm10ConcentrationMeasurement matter Attributo measuredValue
Pm25ConcentrationMeasurement matter Attributo levelValue
Pm25ConcentrationMeasurement matter Attributo measuredValue
PowerSource matter Attributo batChargeState
PowerSource matter Attributo batChargingCurrent
PowerSource matter Attributo batTimeToFullCharge
RadonConcentrationMeasurement matter Attributo levelValue
RadonConcentrationMeasurement matter Attributo measuredValue
RelativeHumidityMeasurement matter Attributo measuredValue
RvcCleanMode matter Comando ChangeToMode
RvcOperationalState matter Comando GoHome
RvcOperationalState matter Comando Metti in pausa
RvcOperationalState matter Comando Riprendi
RvcOperationalState matter Attributo currentPhase
RvcOperationalState matter Attributo operationalError
RvcOperationalState matter Attributo operationalState
RvcRunMode matter Comando ChangeToMode
RvcRunMode matter Attributo currentMode
Interruttore matter Evento InitialPress
Interruttore matter Evento LongPress
Interruttore matter Evento LongRelease
Interruttore matter Evento MultiPressComplete
Interruttore matter Evento MultiPressOngoing
Interruttore matter Evento ShortRelease
Interruttore matter Evento SwitchLatched
Interruttore matter Attributo currentPosition
TemperatureControl matter Comando SetTemperature blocco
TemperatureControl matter Attributo maxTemperature
TemperatureControl matter Attributo minTemperature
TemperatureControl matter Attributo selectedTemperatureLevel
TemperatureControl matter Attributo temperatureSetpoint
TemperatureMeasurement matter Attributo measuredValue
Termostato matter Comando SetpointRaiseLower
Termostato matter Attributo activePresetHandle
Termostato matter Attributo localTemperature
Termostato matter Attributo numero di persone
Termostato matter Attributo occupiedCoolingSetpoint
Termostato matter Attributo occupiedHeatingSetpoint
Termostato matter Attributo outdoorTemperature
Termostato matter Attributo setpointChangeSource
Termostato matter Attributo systemMode
Termostato matter Attributo temperatureSetpointHold
Termostato matter Attributo temperatureSetpointHoldDuration
Termostato matter Attributo thermostatRunningMode
Termostato matter Attributo thermostatRunningState
Termostato matter Attributo unoccupiedCoolingSetpoint
Termostato matter Attributo unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attributo levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attributo measuredValue
WindowCovering matter Comando DownOrClose
WindowCovering matter Comando GoToLiftPercentage
WindowCovering matter Comando GoToLiftValue
WindowCovering matter Comando GoToTiltPercentage
WindowCovering matter Comando GoToTiltValue
WindowCovering matter Comando StopMotion
WindowCovering matter Comando UpOrOpen
WindowCovering matter Attributo currentPositionLift
WindowCovering matter Attributo currentPositionLiftPercent100ths
WindowCovering matter Attributo currentPositionLiftPercentage
WindowCovering matter Attributo currentPositionTilt
WindowCovering matter Attributo currentPositionTiltPercent100ths
WindowCovering matter Attributo currentPositionTiltPercentage
WindowCovering matter Attributo targetPositionLiftPercent100ths
WindowCovering matter Attributo targetPositionTiltPercent100ths
ArmDisarm google Comando ArmDisarm block
ArmDisarm google Evento ArmDisarmArmState
ArmDisarm google Attributo armState
ArmDisarm google Attributo currentArmLevel
ArmDisarm google Attributo isArmed
Dock google Comando Dock
Dock google Attributo isDocked
DoorbellPress google Evento DoorbellPressed
ExtendedAirQuality google Evento AirQuality
ExtendedAirQuality google Attributo indoorAirQuality
ExtendedAirQuality google Attributo indoorMeasuredValue
ExtendedAirQuality google Attributo measuredValue
ExtendedAirQuality google Attributo outdoorAirQuality
ExtendedAirQuality google Attributo outdoorMeasuredValue
ExtendedColorControl google Comando MoveToColorHSV
ExtendedColorControl google Comando MoveToColorName
ExtendedColorControl google Comando MoveToColorRGB
ExtendedColorControl google Attributo currentBlue
ExtendedColorControl google Attributo currentGreen
ExtendedColorControl google Attributo currentHue
ExtendedColorControl google Attributo currentName
ExtendedColorControl google Attributo currentRed
ExtendedColorControl google Attributo currentSaturation
ExtendedColorControl google Attributo currentValue
ExtendedFanControl google Comando ToggleAirflowDirection
ExtendedFanControl google Attributo customFanMode
ExtendedFanControl google Attributo customFanModes
ExtendedMediaInput google Comando NextInput
ExtendedMediaInput google Comando PreviousInput
ExtendedMediaInput google Comando SelectCustomInput
ExtendedMediaInput google Attributo currentCustomInput
ExtendedMediaInput google Attributo customInputsList
ExtendedMediaInput google Attributo customInputsOrdered
ExtendedOperationalState google Evento PauseUnpauseFollowUp
ExtendedOperationalState google Evento StartStopFollowUp
ExtendedPowerSource google Comando StartCharging
ExtendedPowerSource google Comando StopCharging
ExtendedThermostat google Attributo activePresetHandle
ExtendedThermostat google Attributo activeRemoteTemperatureSensorIds
ExtendedThermostat google Attributo averageLocalTemperature
ExtendedThermostat google Attributo extendedRunningMode
ExtendedThermostat google Attributo extendedSystemMode
LightEffects google Comando PulseEffectSet
LightEffects google Comando SleepEffectSet
LightEffects google Comando StopEffect
LightEffects google Comando WakeEffectSet
LightEffects google Attributo pulseEffectSet
LightEffects google Attributo sleepEffectSet
LightEffects google Attributo wakeEffectSet
LockUnlock google Comando Blocca
LockUnlock google Comando Sblocca blocco
LockUnlock google Attributo lockState
MotionDetection google Evento MotionDetected
MotionDetection google Attributo motionDetectionEventInProgress
ObjectDetection google Evento ObjectDetected
OpenClose google Comando Chiudi blocco
OpenClose google Comando Blocco GoToOpenPercentage
OpenClose google Comando Apri blocco
OpenClose google Comando Blocco passaggio
OpenClose google Attributo openPercent
OpenClose google Attributo openState
OpenClose google Attributo targetOpenPercent
Registra google Comando StartRecording
Registra google Comando StopRecording
Registra google Attributo isCurrentlyRecording
Pulsanti di attivazione/disattivazione google Comando ChangeToggleSettings block
Pulsanti di attivazione/disattivazione google Attributo currentToggleSettings
Luminosità google Comando BrightnessStep
Luminosità google Comando MoveToBrightness
Luminosità google Attributo currentBrightnessPercent
SimplifiedOnOff google Attributo onOff
SimplifiedThermostat google Comando SetSystemMode
SimplifiedThermostat google Attributo systemMode
Volume google Comando MoveToVolume
Volume google Comando Disattiva audio
Volume google Comando Riattiva audio
Volume google Comando VolumeStep
Volume google Attributo currentVolumePercent
Volume google Attributo isMuted
AreaAttendanceState google Attributo attendanceState
AreaPresenceState google Attributo presenceState