Compatibilidad con los atributos de la API de Automation

La API de Automation admite la mayoría de los atributos, pero es posible que la compatibilidad con algunos atributos, eventos y comandos en un atributo sea limitada.

Para verificar que la API de Automation admita tu caso de uso, busca en la siguiente tabla.

En general, debes hacer lo siguiente:

  • Todos los atributos y tipos que quieras usar en tu app con la API de Automation deben registrarse durante la inicialización. Consulta Cómo crear una instancia de Home.
  • Se puede usar cualquier atributo en los activadores o las condiciones.
  • Los dispositivos Cloud-to-cloud que no informan su estado no se pueden usar como activadores en automatizaciones, ya sea que se creen de forma manual o a través del descubrimiento.
  • Incluso si un dispositivo admite las características que se enumeran aquí, es posible que se bloquee su uso como activador o acción en la API de Automation debido a los umbrales de calidad de Report State:
    • Los dispositivos con una tasa de éxito de estado del informe inferior al 90% se bloquean para que no se usen como activadores.
    • Los dispositivos con una tasa de éxito de ejecución de comandos inferior al 95% no se pueden usar como acciones.
  • Los comandos solo se pueden usar como acciones.
  • Algunos atributos, como AssistantBroadcast, solo están disponibles para usarse en la API de Automation.
  • El comando okGoogle es un comando a nivel de la estructura y se puede usar para automatizar cualquier dispositivo en la estructura. Sin embargo, es posible que una app de las APIs de Home no tenga acceso a todos los dispositivos. Consulta Permisos de Asistente de Google para ver cómo se aplican los permisos en varios casos.
  • Algunos atributos tienen requisitos previos:
    • Para usar Time.ScheduledTimeEvent, la estructura en la que se ejecuta la automatización debe tener una dirección que se configuró en Google Home app (GHA). En Cómo cambiar la dirección particular de Google, se explica cómo un usuario puede ingresar la dirección de la estructura. Si la dirección no está configurada en GHA, no se crea la automatización y se genera un error con el mensaje "structure no admite ScheduledTimeEvent".
    • Para usar los atributos AreaPresenceState o AreaAttendanceState, el usuario debe configurar el sensor de presencia en GHA.
    • Para usar el atributo ObjectDetection, el usuario debe tener una suscripción activa a Nest Aware.

Las versiones simplificadas de algunos atributos también están disponibles para usarlas en automatizaciones. Para obtener más información, consulta Rasgos simplificados.

Un bloque indica que el comando no es compatible con las automatizaciones de uno o más tipos de dispositivos. Para obtener más información, consulta Acciones bloqueadas en las automatizaciones.

Rasgo Tipo de atributo Tipo de elemento Elemento
AssistantBroadcast google Comando Transmisión
AssistantFulfillment google Comando OkGoogle
Notificación google Comando SendNotifications
Hora google Evento ScheduledTimeEvent
Hora google Atributo currentTime
Hora google Atributo missingStructureLocation
Hora google Atributo sunriseTime
Hora google Atributo sunsetTime
VoiceStarter google Evento OkGoogleEvent
AirQuality matter Atributo airQuality
ApplicationLauncher matter Comando LaunchApp
ApplicationLauncher materia Comando StopApp
ApplicationLauncher materia Atributo currentApp
AudioOutput materia Atributo currentOutput
CarbonDioxideConcentrationMeasurement matter Atributo levelValue
CarbonDioxideConcentrationMeasurement matter Atributo measuredValue
CarbonMonoxideConcentrationMeasurement matter Atributo levelValue
CarbonMonoxideConcentrationMeasurement materia Atributo maxMeasuredValue
CarbonMonoxideConcentrationMeasurement materia Atributo measuredValue
CarbonMonoxideConcentrationMeasurement matter Atributo measurementUnit
CarbonMonoxideConcentrationMeasurement matter Atributo minMeasuredValue
CarbonMonoxideConcentrationMeasurement materia Atributo incertidumbre
Canal materia Comando ChangeChannelByNumber
Canal matter Comando SkipChannel
ColorControl matter Comando ColorLoopSet
ColorControl matter Comando MoveColor
ColorControl matter Comando MoveColorTemperature
ColorControl matter Comando MoveToColor
ColorControl materia Comando MoveToColorTemperature
ColorControl matter Comando MoveToHue
ColorControl materia Comando MoveToHueAndSaturation
ColorControl materia Comando MoveToSaturation
ColorControl matter Comando StepColor
ColorControl matter Comando StepColorTemperature
ColorControl matter Atributo colorTemperatureMireds
ColorControl matter Atributo currentHue
ColorControl matter Atributo currentX
ColorControl matter Atributo currentY
DishwasherMode matter Comando ChangeToMode
DishwasherMode materia Atributo currentMode
DishwasherMode matter Atributo onMode
DoorLock matter Evento DoorLockAlarm
DoorLock matter Evento DoorStateChange
DoorLock matter Comando LockDoor
DoorLock matter Evento LockOperation
DoorLock materia Evento LockOperationError
DoorLock materia Comando UnlockDoor
DoorLock materia Atributo doorClosedEvents
DoorLock materia Atributo doorOpenEvents
DoorLock materia Atributo doorState
DoorLock materia Atributo lockState
FanControl matter Comando Paso
FanControl materia Atributo airflowDirection
FanControl matter Atributo fanMode
FanControl matter Atributo percentCurrent
FanControl materia Atributo percentSetting
FanControl materia Atributo speedCurrent
FanControl materia Atributo speedSetting
FanControl materia Atributo windSetting
FormaldehydeConcentrationMeasurement materia Atributo levelValue
FormaldehydeConcentrationMeasurement materia Atributo measuredValue
IlluminanceMeasurement matter Atributo measuredValue
LaundryWasherMode materia Comando ChangeToMode
LaundryWasherMode matter Atributo currentMode
LaundryWasherMode materia Atributo onMode
LevelControl matter Comando Mover
LevelControl materia Comando MoveToLevel
LevelControl materia Comando MoveToLevelWithOnOff
LevelControl materia Comando MoveWithOnOff
LevelControl matter Comando Paso
LevelControl matter Comando StepWithOnOff
LevelControl matter Comando Detener
LevelControl matter Comando StopWithOnOff
LevelControl matter Atributo currentLevel
LevelControl matter Atributo maxLevel
LevelControl materia Atributo startUpCurrentLevel
MediaInput materia Comando RenameInput
MediaInput matter Comando SelectInput
MediaInput materia Atributo currentInput
MediaPlayback matter Comando FastForward
MediaPlayback matter Comando Siguiente
MediaPlayback materia Comando Pausar
MediaPlayback matter Comando Jugar
MediaPlayback materia Comando Anterior
MediaPlayback matter Comando Retroceder
MediaPlayback matter Comando SkipBackward
MediaPlayback matter Comando SkipForward
MediaPlayback matter Evento StateChanged
MediaPlayback materia Comando Detener
MediaPlayback materia Atributo currentState
ModeSelect matter Comando ChangeToMode block
ModeSelect materia Atributo currentMode
ModeSelect matter Atributo onMode
NitrogenDioxideConcentrationMeasurement materia Atributo levelValue
NitrogenDioxideConcentrationMeasurement matter Atributo measuredValue
OccupancySensing matter Atributo ocupación
OnOff matter Comando Desactivado bloquear
OnOff matter Comando En bloque
OnOff matter Atributo onOff
OperationalState matter Evento OperationCompletion
OperationalState matter Comando Pausa bloque
OperationalState matter Comando Reanudar bloque
OperationalState matter Comando Inicio
OperationalState matter Comando Detener
OperationalState matter Atributo currentPhase
OperationalState matter Atributo operationalState
OzoneConcentrationMeasurement matter Atributo levelValue
OzoneConcentrationMeasurement matter Atributo measuredValue
Pm10ConcentrationMeasurement matter Atributo levelValue
Pm10ConcentrationMeasurement matter Atributo measuredValue
Pm25ConcentrationMeasurement materia Atributo levelValue
Pm25ConcentrationMeasurement materia Atributo measuredValue
PowerSource matter Atributo batChargeState
PowerSource materia Atributo batChargingCurrent
PowerSource matter Atributo batTimeToFullCharge
RadonConcentrationMeasurement matter Atributo levelValue
RadonConcentrationMeasurement matter Atributo measuredValue
RelativeHumidityMeasurement matter Atributo measuredValue
RvcCleanMode matter Comando ChangeToMode
RvcOperationalState materia Comando GoHome
RvcOperationalState matter Comando Pausar
RvcOperationalState materia Comando Reanudar
RvcOperationalState materia Atributo currentPhase
RvcOperationalState materia Atributo operationalError
RvcOperationalState matter Atributo operationalState
RvcRunMode matter Comando ChangeToMode
RvcRunMode matter Atributo currentMode
Interruptor matter Evento InitialPress
Interruptor matter Evento LongPress
Interruptor materia Evento LongRelease
Interruptor materia Evento MultiPressComplete
Interruptor materia Evento MultiPressOngoing
Interruptor materia Evento ShortRelease
Interruptor materia Evento SwitchLatched
Interruptor matter Atributo currentPosition
TemperatureControl matter Comando SetTemperature bloque
TemperatureControl materia Atributo maxTemperature
TemperatureControl materia Atributo minTemperature
TemperatureControl materia Atributo selectedTemperatureLevel
TemperatureControl materia Atributo temperatureSetpoint
TemperatureMeasurement matter Atributo measuredValue
Termostato matter Comando SetpointRaiseLower
Termostato matter Atributo activePresetHandle
Termostato matter Atributo localTemperature
Termostato materia Atributo ocupación
Termostato matter Atributo occupiedCoolingSetpoint
Termostato materia Atributo occupiedHeatingSetpoint
Termostato matter Atributo outdoorTemperature
Termostato materia Atributo setpointChangeSource
Termostato materia Atributo systemMode
Termostato materia Atributo temperatureSetpointHold
Termostato matter Atributo temperatureSetpointHoldDuration
Termostato matter Atributo thermostatRunningMode
Termostato matter Atributo thermostatRunningState
Termostato matter Atributo unoccupiedCoolingSetpoint
Termostato matter Atributo unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Atributo levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Atributo measuredValue
WindowCovering matter Comando DownOrClose
WindowCovering matter Comando GoToLiftPercentage
WindowCovering matter Comando GoToLiftValue
WindowCovering matter Comando GoToTiltPercentage
WindowCovering materia Comando GoToTiltValue
WindowCovering matter Comando StopMotion
WindowCovering matter Comando UpOrOpen
WindowCovering materia Atributo currentPositionLift
WindowCovering materia Atributo currentPositionLiftPercent100ths
WindowCovering materia Atributo currentPositionLiftPercentage
WindowCovering materia Atributo currentPositionTilt
WindowCovering materia Atributo currentPositionTiltPercent100ths
WindowCovering matter Atributo currentPositionTiltPercentage
WindowCovering materia Atributo targetPositionLiftPercent100ths
WindowCovering materia Atributo targetPositionTiltPercent100ths
ArmDisarm google Comando ArmDisarm block
ArmDisarm google Evento ArmDisarmArmState
ArmDisarm google Atributo armState
ArmDisarm google Atributo currentArmLevel
ArmDisarm google Atributo isArmed
Estación de carga google Comando Estación de carga
Estación de carga google Atributo isDocked
DoorbellPress google Evento DoorbellPressed
ExtendedAirQuality google Evento AirQuality
ExtendedAirQuality google Atributo indoorAirQuality
ExtendedAirQuality google Atributo indoorMeasuredValue
ExtendedAirQuality google Atributo measuredValue
ExtendedAirQuality google Atributo outdoorAirQuality
ExtendedAirQuality google Atributo outdoorMeasuredValue
ExtendedColorControl google Comando MoveToColorHSV
ExtendedColorControl google Comando MoveToColorName
ExtendedColorControl google Comando MoveToColorRGB
ExtendedColorControl google Atributo currentBlue
ExtendedColorControl google Atributo currentGreen
ExtendedColorControl google Atributo currentHue
ExtendedColorControl google Atributo currentName
ExtendedColorControl google Atributo currentRed
ExtendedColorControl google Atributo currentSaturation
ExtendedColorControl google Atributo currentValue
ExtendedFanControl google Comando ToggleAirflowDirection
ExtendedFanControl google Atributo customFanMode
ExtendedFanControl google Atributo customFanModes
ExtendedMediaInput google Comando NextInput
ExtendedMediaInput google Comando PreviousInput
ExtendedMediaInput google Comando SelectCustomInput
ExtendedMediaInput google Atributo currentCustomInput
ExtendedMediaInput google Atributo customInputsList
ExtendedMediaInput google Atributo customInputsOrdered
ExtendedOperationalState google Evento PauseUnpauseFollowUp
ExtendedOperationalState google Evento StartStopFollowUp
ExtendedPowerSource google Comando StartCharging
ExtendedPowerSource google Comando StopCharging
ExtendedThermostat google Atributo activePresetHandle
ExtendedThermostat google Atributo activeRemoteTemperatureSensorIds
ExtendedThermostat google Atributo averageLocalTemperature
ExtendedThermostat google Atributo extendedRunningMode
ExtendedThermostat google Atributo extendedSystemMode
LightEffects google Comando PulseEffectSet
LightEffects google Comando SleepEffectSet
LightEffects google Comando StopEffect
LightEffects google Comando WakeEffectSet
LightEffects google Atributo pulseEffectSet
LightEffects google Atributo sleepEffectSet
LightEffects google Atributo wakeEffectSet
LockUnlock google Comando Bloquear
LockUnlock google Comando Desbloquear bloque
LockUnlock google Atributo lockState
MotionDetection google Evento MotionDetected
MotionDetection google Atributo motionDetectionEventInProgress
ObjectDetection google Evento ObjectDetected
OpenClose google Comando Cerrar bloque
OpenClose google Comando GoToOpenPercentage bloque
OpenClose google Comando Bloque abierto
OpenClose google Comando Paso bloque
OpenClose google Atributo openPercent
OpenClose google Atributo openState
OpenClose google Atributo targetOpenPercent
Registro google Comando StartRecording
Registro google Comando StopRecording
Registro google Atributo isCurrentlyRecording
Activadores google Comando ChangeToggleSettings bloque
Activadores google Atributo currentToggleSettings
Brillo google Comando BrightnessStep
Brillo google Comando MoveToBrightness
Brillo google Atributo currentBrightnessPercent
SimplifiedOnOff google Atributo onOff
SimplifiedThermostat google Comando SetSystemMode
SimplifiedThermostat google Atributo systemMode
Volumen google Comando MoveToVolume
Volumen google Comando Silenciar
Volumen google Comando Activar sonido
Volumen google Comando VolumeStep
Volumen google Atributo currentVolumePercent
Volumen google Atributo isMuted
AreaAttendanceState google Atributo attendanceState
AreaPresenceState google Atributo presenceState