Suporte a características da API Automation

A API Automation oferece suporte à maioria dos traços, mas o suporte a alguns atributos, eventos e comandos em um traço pode ser limitado.

Para verificar se a API Automation oferece suporte ao seu caso de uso, pesquise na tabela abaixo.

Em geral:

  • Todas as características e tipos que você pretende usar no app com a API Automation precisam ser registrados na inicialização. Consulte Criar uma instância do Google Home.
  • Qualquer atributo pode ser usado em ativações ou condições.
  • Os dispositivos Cloud-to-cloud que não informam o estado não podem ser usados como acionadores em automações, criadas manualmente ou pela descoberta.
  • Mesmo que um dispositivo ofereça suporte às características listadas aqui, ele pode ser bloqueado para uso como um iniciador ou ação na API Automation devido aos limites de qualidade do Report State:
    • Os dispositivos com uma taxa de sucesso de estado de relatório inferior a 90% são bloqueados para uso como inicializadores.
    • Dispositivos com uma taxa de sucesso de execução de comando inferior a 95% são bloqueados para uso como ações.
  • Os comandos só podem ser usados como ações.
  • Alguns atributos, como AssistantBroadcast, estão disponíveis apenas para uso na API Automation.
  • O comando okGoogle é um comando no nível da estrutura e pode ser usado para automatizar qualquer dispositivo na estrutura. No entanto, um app de APIs Home pode não ter acesso a todos os dispositivos. Consulte Permissões do OkGoogle para saber como as permissões são aplicadas em vários casos.
  • Algumas características têm pré-requisitos:
    • Para usar Time.ScheduledTimeEvent, a estrutura em que a automação é executada precisa ter um endereço que tenha sido configurado no Google Home app (GHA). Alterar o endereço residencial do Google explica como um usuário pode inserir o endereço da estrutura. Se o endereço não for configurado no GHA, a automação não será criada e um erro será gerado com a mensagem "O ScheduledTimeEvent não é compatível com o structure".
    • Para usar os atributos AreaPresenceState ou AreaAttendanceState, o usuário precisa configurar o sensor de presença no GHA.
    • Para usar o atributo ObjectDetection, o usuário precisa ter uma assinatura ativa do Nest Aware.

Versões simplificadas de algumas características também estão disponíveis para uso em automações. Para mais informações, consulte Atributos simplificados.

Um bloqueio indica que o comando não tem suporte em automações para um ou mais tipos de dispositivo. Para mais informações, consulte Ações bloqueadas nas automações.

Traço Tipo de traço Tipo de elemento Elemento
AssistantBroadcast google Comando Transmissão
AssistantFulfillment google Comando OkGoogle
Notificação google Comando SendNotifications
Tempo google Evento ScheduledTimeEvent
Tempo google Atributo currentTime
Tempo google Atributo missingStructureLocation
Tempo google Atributo sunriseTime
Tempo google Atributo sunsetTime
VoiceStarter google Evento OkGoogleEvent
AirQuality questão Atributo airQuality
ApplicationLauncher questão Comando LaunchApp
ApplicationLauncher questão Comando StopApp
ApplicationLauncher questão Atributo currentApp
AudioOutput questão Atributo currentOutput
CarbonDioxideConcentrationMeasurement questão Atributo levelValue
CarbonDioxideConcentrationMeasurement questão Atributo measuredValue
CarbonMonoxideConcentrationMeasurement questão Atributo levelValue
CarbonMonoxideConcentrationMeasurement questão Atributo maxMeasuredValue
CarbonMonoxideConcentrationMeasurement questão Atributo measuredValue
CarbonMonoxideConcentrationMeasurement questão Atributo measurementUnit
CarbonMonoxideConcentrationMeasurement questão Atributo minMeasuredValue
CarbonMonoxideConcentrationMeasurement questão Atributo incerteza
Canal questão Comando ChangeChannelByNumber
Canal questão Comando SkipChannel
ColorControl questão Comando ColorLoopSet
ColorControl questão Comando MoveColor
ColorControl questão Comando MoveColorTemperature
ColorControl questão Comando MoveToColor
ColorControl questão Comando MoveToColorTemperature
ColorControl matéria Comando MoveToHue
ColorControl questão Comando MoveToHueAndSaturation
ColorControl matéria Comando MoveToSaturation
ColorControl matéria Comando StepColor
ColorControl questão Comando StepColorTemperature
ColorControl questão Atributo colorTemperatureMireds
ColorControl questão Atributo currentHue
ColorControl questão Atributo currentX
ColorControl questão Atributo currentY
DishwasherMode questão Comando ChangeToMode
DishwasherMode questão Atributo currentMode
DishwasherMode questão Atributo onMode
DoorLock matéria Evento DoorLockAlarm
DoorLock questão Evento DoorStateChange
DoorLock matéria Comando LockDoor
DoorLock questão Evento LockOperation
DoorLock matéria Evento LockOperationError
DoorLock matéria Comando UnlockDoor
DoorLock matéria Atributo doorClosedEvents
DoorLock matéria Atributo doorOpenEvents
DoorLock matéria Atributo doorState
DoorLock questão Atributo lockState
FanControl questão Comando Etapa
FanControl questão Atributo airflowDirection
FanControl questão Atributo fanMode
FanControl questão Atributo percentCurrent
FanControl questão Atributo percentSetting
FanControl questão Atributo speedCurrent
FanControl questão Atributo speedSetting
FanControl questão Atributo windSetting
FormaldehydeConcentrationMeasurement questão Atributo levelValue
FormaldehydeConcentrationMeasurement questão Atributo measuredValue
IlluminanceMeasurement questão Atributo measuredValue
LaundryWasherMode questão Comando ChangeToMode
LaundryWasherMode questão Atributo currentMode
LaundryWasherMode questão Atributo onMode
LevelControl questão Comando Mover
LevelControl questão Comando MoveToLevel
LevelControl questão Comando MoveToLevelWithOnOff
LevelControl questão Comando MoveWithOnOff
LevelControl questão Comando Etapa
LevelControl questão Comando StepWithOnOff
LevelControl questão Comando Parar
LevelControl questão Comando StopWithOnOff
LevelControl questão Atributo currentLevel
LevelControl matéria Atributo maxLevel
LevelControl questão Atributo startUpCurrentLevel
MediaInput questão Comando RenameInput
MediaInput matéria Comando SelectInput
MediaInput matéria Atributo currentInput
MediaPlayback matéria Comando FastForward
MediaPlayback questão Comando Próxima
MediaPlayback questão Comando Pausar
MediaPlayback questão Comando Tocar
MediaPlayback questão Comando Anterior
MediaPlayback questão Comando Voltar
MediaPlayback questão Comando SkipBackward
MediaPlayback questão Comando SkipForward
MediaPlayback questão Evento StateChanged
MediaPlayback questão Comando Parar
MediaPlayback questão Atributo currentState
ModeSelect questão Comando ChangeToMode block
ModeSelect questão Atributo currentMode
ModeSelect questão Atributo onMode
NitrogenDioxideConcentrationMeasurement questão Atributo levelValue
NitrogenDioxideConcentrationMeasurement questão Atributo measuredValue
OccupancySensing questão Atributo ocupação
OnOff questão Comando Desativado bloquear
OnOff questão Comando Em bloqueio
OnOff questão Atributo onOff
OperationalState questão Evento OperationCompletion
OperationalState questão Comando Pausa bloco
OperationalState questão Comando Retomar bloco
OperationalState questão Comando Começar
OperationalState questão Comando Parar
OperationalState questão Atributo currentPhase
OperationalState questão Atributo operationalState
OzoneConcentrationMeasurement questão Atributo levelValue
OzoneConcentrationMeasurement questão Atributo measuredValue
Pm10ConcentrationMeasurement questão Atributo levelValue
Pm10ConcentrationMeasurement questão Atributo measuredValue
Pm25ConcentrationMeasurement questão Atributo levelValue
Pm25ConcentrationMeasurement questão Atributo measuredValue
PowerSource questão Atributo batChargeState
PowerSource questão Atributo batChargingCurrent
PowerSource questão Atributo batTimeToFullCharge
RadonConcentrationMeasurement questão Atributo levelValue
RadonConcentrationMeasurement questão Atributo measuredValue
RelativeHumidityMeasurement questão Atributo measuredValue
RvcCleanMode questão Comando ChangeToMode
RvcOperationalState matéria Comando GoHome
RvcOperationalState questão Comando Pausa
RvcOperationalState questão Comando Retomar
RvcOperationalState questão Atributo currentPhase
RvcOperationalState questão Atributo operationalError
RvcOperationalState questão Atributo operationalState
RvcRunMode questão Comando ChangeToMode
RvcRunMode questão Atributo currentMode
Interruptor questão Evento InitialPress
Interruptor questão Evento LongPress
Interruptor questão Evento LongRelease
Interruptor questão Evento MultiPressComplete
Interruptor questão Evento MultiPressOngoing
Interruptor questão Evento ShortRelease
Interruptor questão Evento SwitchLatched
Interruptor questão Atributo currentPosition
TemperatureControl questão Comando SetTemperature block
TemperatureControl questão Atributo maxTemperature
TemperatureControl questão Atributo minTemperature
TemperatureControl questão Atributo selectedTemperatureLevel
TemperatureControl questão Atributo temperatureSetpoint
TemperatureMeasurement matéria Atributo measuredValue
Termostato matéria Comando SetpointRaiseLower
Termostato questão Atributo activePresetHandle
Termostato questão Atributo localTemperature
Termostato questão Atributo ocupação
Termostato questão Atributo occupiedCoolingSetpoint
Termostato questão Atributo occupiedHeatingSetpoint
Termostato questão Atributo outdoorTemperature
Termostato questão Atributo setpointChangeSource
Termostato questão Atributo systemMode
Termostato questão Atributo temperatureSetpointHold
Termostato questão Atributo temperatureSetpointHoldDuration
Termostato questão Atributo thermostatRunningMode
Termostato questão Atributo thermostatRunningState
Termostato questão Atributo unoccupiedCoolingSetpoint
Termostato questão Atributo unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement questão Atributo levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement questão Atributo measuredValue
WindowCovering matéria Comando DownOrClose
WindowCovering questão Comando GoToLiftPercentage
WindowCovering questão Comando GoToLiftValue
WindowCovering matéria Comando GoToTiltPercentage
WindowCovering questão Comando GoToTiltValue
WindowCovering questão Comando StopMotion
WindowCovering questão Comando UpOrOpen
WindowCovering questão Atributo currentPositionLift
WindowCovering questão Atributo currentPositionLiftPercent100ths
WindowCovering questão Atributo currentPositionLiftPercentage
WindowCovering questão Atributo currentPositionTilt
WindowCovering questão Atributo currentPositionTiltPercent100ths
WindowCovering questão Atributo currentPositionTiltPercentage
WindowCovering questão Atributo targetPositionLiftPercent100ths
WindowCovering questão Atributo targetPositionTiltPercent100ths
ArmDisarm google Comando ArmDisarm block
ArmDisarm google Evento ArmDisarmArmState
ArmDisarm google Atributo armState
ArmDisarm google Atributo currentArmLevel
ArmDisarm google Atributo isArmed
Dock google Comando Dock
Dock 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 Trava
LockUnlock google Comando Desbloquear bloquear
LockUnlock google Atributo lockState
MotionDetection google Evento MotionDetected
MotionDetection google Atributo motionDetectionEventInProgress
ObjectDetection google Evento ObjectDetected
OpenClose google Comando Fechar bloco
OpenClose google Comando GoToOpenPercentage block
OpenClose google Comando Abrir bloco
OpenClose google Comando Etapa bloqueio
OpenClose google Atributo openPercent
OpenClose google Atributo openState
OpenClose google Atributo targetOpenPercent
Registro google Comando StartRecording
Registro google Comando StopRecording
Registro google Atributo isCurrentlyRecording
Ativar google Comando ChangeToggleSettings block
Alternar google Atributo currentToggleSettings
Brilho google Comando BrightnessStep
Brilho google Comando MoveToBrightness
Brilho google Atributo currentBrightnessPercent
SimplifiedOnOff google Atributo onOff
SimplifiedThermostat google Comando SetSystemMode
SimplifiedThermostat google Atributo systemMode
Volume google Comando MoveToVolume
Volume google Comando Desativar som
Volume google Comando Ativar a voz
Volume google Comando VolumeStep
Volume google Atributo currentVolumePercent
Volume google Atributo isMuted
AreaAttendanceState google Atributo attendanceState
AreaPresenceState google Atributo presenceState