Automation API の特性サポート

Automation API はほとんどの特徴をサポートしていますが、特徴の一部属性、イベント、コマンドのサポートが制限される場合があります。

Automation API がユースケースをサポートしていることを確認するには、次の表で検索します。

一般的には次のようになります。

  • Automation API でアプリで使用する特徴と型は、初期化時に登録する必要があります。Google Home インスタンスを作成するをご覧ください。
  • 開始条件や条件では、任意の属性を使用できます。
  • 状態を報告しない Cloud-to-cloud デバイスは、手動または検出によって作成された自動化のトリガーとして使用できません。
  • デバイスがここに記載されているトレイトをサポートしている場合でも、Report State の品質しきい値が原因で、Automation API で開始条件またはアクションとして使用できない場合があります。
    • Report State の成功率が 90% 未満のデバイスは、開始デバイスとして使用できません。
    • コマンド実行の成功率が 95% 未満のデバイスは、アクションとして使用できなくなります。
  • コマンドはアクションとしてのみ使用できます。
  • AssistantBroadcast などの一部の特性は、Automation API でのみ使用できます。
  • okGoogle コマンドは構造レベルのコマンドであり、構造内の任意のデバイスを自動化するために使用できます。ただし、Home APIs アプリがすべてのデバイスにアクセスできるとは限りません。さまざまなケースで権限が適用される仕組みについては、OkGoogle の権限をご覧ください。
  • 一部の特性には前提条件があります。
    • Time.ScheduledTimeEvent を使用するには、自動化が実行される構造物に、Google Home app (GHA) で設定された住所が必要です。Google の住所を変更するでは、建物の住所を入力する方法について説明しています。GHA でアドレスが設定されていない場合、自動化は作成されず、「ScheduledTimeEvent は structure でサポートされていません」というメッセージとともにエラーがスローされます。
    • AreaPresenceState または AreaAttendanceState の特徴を使用するには、ユーザーが GHA で在宅確認を設定する必要があります。
    • ObjectDetection トレイトを使用するには、有効な Google Nest Aware 定期購入が必要です。

一部の特徴の簡素化されたバージョンは、自動化で使用することもできます。詳細については、簡素化された特性をご覧ください。

ブロックは、1 つ以上のデバイスタイプの自動化でコマンドがサポートされていないことを示します。詳しくは、自動化でブロックされるアクションをご覧ください。

トレイト 特性のタイプ 要素の種類 要素
AssistantBroadcast google コマンド ブロードキャスト
AssistantFulfillment google コマンド OkGoogle
通知 google コマンド SendNotifications
時間 google イベント ScheduledTimeEvent
時間 google 属性 currentTime
時間 google 属性 missingStructureLocation
時間 google 属性 sunriseTime
時間 google 属性 sunsetTime
VoiceStarter google イベント OkGoogleEvent
AirQuality 問題 属性 airQuality
ApplicationLauncher 問題 コマンド LaunchApp
ApplicationLauncher 問題 コマンド StopApp
ApplicationLauncher 問題 属性 currentApp
AudioOutput 問題 属性 currentOutput
CarbonDioxideConcentrationMeasurement 問題 属性 レベル値
CarbonDioxideConcentrationMeasurement 問題 属性 measuredValue
CarbonMonoxideConcentrationMeasurement 問題 属性 レベル値
炭素モノキシド濃度測定 問題 属性 maxMeasuredValue
CarbonMonoxideConcentrationMeasurement 問題 属性 measuredValue
炭素モノキシド濃度測定 問題 属性 measurementUnit
炭素モノキシド濃度測定 問題 属性 minMeasuredValue
炭素モノキシド濃度測定 問題 属性 uncertainty
チャンネル 問題 コマンド ChangeChannelByNumber
チャンネル 問題 コマンド SkipChannel
ColorControl 問題 コマンド ColorLoopSet
ColorControl 問題 コマンド MoveColor
ColorControl 問題 コマンド MoveColorTemperature
ColorControl 問題 コマンド MoveToColor
ColorControl 問題 コマンド MoveToColorTemperature
ColorControl 問題 コマンド MoveToHue
ColorControl 問題 コマンド MoveToHueAndSaturation
ColorControl 問題 コマンド MoveToSaturation
ColorControl 問題 コマンド StepColor
ColorControl 問題 コマンド StepColorTemperature
ColorControl 問題 属性 colorTemperatureMireds
ColorControl 問題 属性 currentHue
ColorControl 問題 属性 currentX
ColorControl 問題 属性 currentY
DishwasherMode 問題 コマンド ChangeToMode
DishwasherMode 問題 属性 currentMode
DishwasherMode 問題 属性 onMode
DoorLock 問題 イベント DoorLockAlarm
DoorLock 問題 イベント DoorStateChange
DoorLock 問題 コマンド LockDoor
DoorLock 問題 イベント LockOperation
DoorLock matter イベント LockOperationError
DoorLock 問題 コマンド UnlockDoor
DoorLock 問題 属性 doorClosedEvents
DoorLock 問題 属性 doorOpenEvents
DoorLock 問題 属性 doorState
DoorLock 問題 属性 lockState
FanControl 問題 コマンド ステップ
FanControl 問題 属性 airflowDirection
FanControl 問題 属性 FANMODE
FanControl matter 属性 percentCurrent
FanControl 問題 属性 percentSetting
FanControl 問題 属性 speedCurrent
FanControl 問題 属性 speedSetting
FanControl 問題 属性 windSetting
FormaldehydeConcentrationMeasurement 問題 属性 レベル値
FormaldehydeConcentrationMeasurement 問題 属性 measuredValue
IlluminanceMeasurement 問題 属性 measuredValue
LaundryWasherMode 問題 コマンド ChangeToMode
LaundryWasherMode 問題 属性 currentMode
LaundryWasherMode 問題 属性 onMode
LevelControl 問題 コマンド 移動
LevelControl 問題 コマンド MoveToLevel
LevelControl 問題 コマンド MoveToLevelWithOnOff
LevelControl 問題 コマンド MoveWithOnOff
LevelControl 問題 コマンド ステップ
LevelControl 問題 コマンド StepWithOnOff
LevelControl 問題 コマンド 停止
LevelControl 問題 コマンド StopWithOnOff
LevelControl 問題 属性 currentLevel
LevelControl 問題 属性 maxLevel
LevelControl 問題 属性 startUpCurrentLevel
MediaInput 問題 コマンド RenameInput
MediaInput 問題 コマンド SelectInput
MediaInput 問題 属性 currentInput
MediaPlayback 問題 コマンド 早送り
MediaPlayback 問題 コマンド 次へ
MediaPlayback 問題 コマンド 一時停止
MediaPlayback 問題 コマンド 再生
MediaPlayback 問題 コマンド 前へ
MediaPlayback 問題 コマンド 巻き戻し
MediaPlayback 問題 コマンド SkipBackward
MediaPlayback 問題 コマンド вперед
MediaPlayback 問題 イベント StateChanged
MediaPlayback 問題 コマンド 停止
MediaPlayback 問題 属性 currentState
ModeSelect 問題 コマンド ChangeToMode block
ModeSelect 問題 属性 currentMode
ModeSelect 問題 属性 onMode
NitrogenDioxideConcentrationMeasurement 問題 属性 レベル値
NitrogenDioxideConcentrationMeasurement 問題 属性 measuredValue
OccupancySensing 問題 属性 定員
OnOff 問題 コマンド オフ ブロック
OnOff 問題 コマンド オン ブロック
OnOff matter 属性 onOff
OperationalState 問題 イベント OperationCompletion
OperationalState 問題 コマンド 一時停止 ブロック
OperationalState 問題 コマンド 再開 ブロック
OperationalState 問題 コマンド 開始
OperationalState 問題 コマンド 停止
OperationalState 問題 属性 currentPhase
OperationalState 問題 属性 operationalState
OzoneConcentrationMeasurement 問題 属性 レベル値
OzoneConcentrationMeasurement 問題 属性 measuredValue
Pm10ConcentrationMeasurement 問題 属性 レベル値
Pm10ConcentrationMeasurement 問題 属性 measuredValue
Pm25ConcentrationMeasurement 問題 属性 レベル値
Pm25ConcentrationMeasurement 問題 属性 measuredValue
PowerSource 問題 属性 batChargeState
PowerSource 問題 属性 batChargingCurrent
PowerSource 問題 属性 batTimeToFullCharge
RadonConcentrationMeasurement 問題 属性 レベル値
RadonConcentrationMeasurement 問題 属性 measuredValue
RelativeHumidityMeasurement 問題 属性 measuredValue
RvcCleanMode 問題 コマンド ChangeToMode
RvcOperationalState 問題 コマンド GoHome
RvcOperationalState 問題 コマンド 一時停止
RvcOperationalState 問題 コマンド 再開
RvcOperationalState 問題 属性 currentPhase
RvcOperationalState 問題 属性 operationalError
RvcOperationalState 問題 属性 operationalState
RvcRunMode 問題 コマンド ChangeToMode
RvcRunMode 問題 属性 currentMode
スイッチ 問題 イベント InitialPress
スイッチ 問題 イベント LongPress
スイッチ 問題 イベント LongRelease
スイッチ 問題 イベント MultiPressComplete
スイッチ 問題 イベント MultiPressOngoing
スイッチ 問題 イベント ShortRelease
スイッチ 問題 イベント スイッチが固定されている
スイッチ 問題 属性 currentPosition
TemperatureControl 問題 コマンド SetTemperature ブロック
TemperatureControl 問題 属性 maxTemperature
TemperatureControl 問題 属性 minTemperature
TemperatureControl 問題 属性 selectedTemperatureLevel
TemperatureControl 問題 属性 temperatureSetpoint
TemperatureMeasurement 問題 属性 measuredValue
サーモスタット 問題 コマンド SetpointRaiseLower
サーモスタット 問題 属性 activePresetHandle
サーモスタット 問題 属性 localTemperature
サーモスタット 問題 属性 定員
サーモスタット 問題 属性 occupiedCoolingSetpoint
サーモスタット 問題 属性 occupiedHeatingSetpoint
サーモスタット 問題 属性 outdoorTemperature
サーモスタット 問題 属性 setpointChangeSource
サーモスタット 問題 属性 systemMode
サーモスタット 問題 属性 temperatureSetpointHold
サーモスタット matter 属性 temperatureSetpointHoldDuration
サーモスタット 問題 属性 thermostatRunningMode
サーモスタット 問題 属性 thermostatRunningState
サーモスタット 問題 属性 unoccupiedCoolingSetpoint
サーモスタット 問題 属性 unoccupiedHeatingSetpoint
揮発性有機化合物の総濃度測定 問題 属性 レベル値
揮発性有機化合物の総濃度測定 問題 属性 measuredValue
WindowCovering 問題 コマンド DownOrClose
WindowCovering 問題 コマンド GoToLiftPercentage
WindowCovering 問題 コマンド GoToLiftValue
WindowCovering 問題 コマンド GoToTiltPercentage
WindowCovering 問題 コマンド GoToTiltValue
WindowCovering 問題 コマンド StopMotion
WindowCovering 問題 コマンド UpOrOpen
WindowCovering 問題 属性 currentPositionLift
WindowCovering 問題 属性 currentPositionLiftPercent100ths
WindowCovering 問題 属性 currentPositionLiftPercentage
WindowCovering 問題 属性 currentPositionTilt
WindowCovering 問題 属性 currentPositionTiltPercent100ths
WindowCovering 問題 属性 currentPositionTiltPercentage
WindowCovering 問題 属性 targetPositionLiftPercent100ths
WindowCovering 問題 属性 targetPositionTiltPercent100ths
ArmDisarm google コマンド ArmDisarm ブロック
ArmDisarm google イベント ArmDisarmArmState
ArmDisarm google 属性 armState
ArmDisarm google 属性 currentArmLevel
ArmDisarm google 属性 isArmed
充電ホルダー google コマンド ホルダー
充電ホルダー google 属性 isDocked
DoorbellPress google イベント DoorbellPressed
ExtendedAirQuality google イベント AirQuality
ExtendedAirQuality google 属性 indoorAirQuality
ExtendedAirQuality google 属性 indoorMeasuredValue
ExtendedAirQuality google 属性 measuredValue
ExtendedAirQuality google 属性 outdoorAirQuality
ExtendedAirQuality google 属性 outdoorMeasuredValue
ExtendedColorControl google コマンド MoveToColorHSV
ExtendedColorControl google コマンド MoveToColorName
ExtendedColorControl google コマンド MoveToColorRGB
ExtendedColorControl google 属性 currentBlue
ExtendedColorControl google 属性 currentGreen
ExtendedColorControl google 属性 currentHue
ExtendedColorControl google 属性 currentName
ExtendedColorControl google 属性 currentRed
ExtendedColorControl google 属性 currentSaturation
ExtendedColorControl google 属性 currentValue
ExtendedFanControl google コマンド ToggleAirflowDirection
ExtendedFanControl google 属性 customFanMode
ExtendedFanControl google 属性 customFanModes
ExtendedMediaInput google コマンド NextInput
ExtendedMediaInput google コマンド PreviousInput
ExtendedMediaInput google コマンド SelectCustomInput
ExtendedMediaInput google 属性 currentCustomInput
ExtendedMediaInput google 属性 customInputsList
ExtendedMediaInput google 属性 customInputsOrdered
ExtendedOperationalState google イベント PauseUnpauseFollowUp
ExtendedOperationalState google イベント StartStopFollowUp
ExtendedPowerSource google コマンド 充電を開始
ExtendedPowerSource google コマンド StopCharging
ExtendedThermostat google 属性 activePresetHandle
ExtendedThermostat google 属性 activeRemoteTemperatureSensorIds
ExtendedThermostat google 属性 averageLocalTemperature
ExtendedThermostat google 属性 extendedRunningMode
ExtendedThermostat google 属性 extendedSystemMode
LightEffects google コマンド pulsEffectSet
LightEffects google コマンド SleepEffectSet
LightEffects google コマンド StopEffect
LightEffects google コマンド WakeEffectSet
LightEffects google 属性 pulsEffectSet
LightEffects google 属性 sleepEffectSet
LightEffects google 属性 wakeEffectSet
LockUnlock google コマンド ロック
LockUnlock google コマンド ロック解除 ブロック
LockUnlock google 属性 lockState
MotionDetection google イベント MotionDetected
MotionDetection google 属性 motionDetectionEventInProgress
ObjectDetection google イベント ObjectDetected
OpenClose google コマンド 閉じる ブロック
OpenClose google コマンド GoToOpenPercentage ブロック
OpenClose google コマンド 開く ブロック
OpenClose google コマンド ステップ ブロック
OpenClose google 属性 openPercent
OpenClose google 属性 openState
OpenClose google 属性 targetOpenPercent
記録 google コマンド StartRecording
録画 google コマンド StopRecording
記録 google 属性 isCurrentlyRecording
Toggles google コマンド ChangeToggleSettings ブロック
Toggles google 属性 currentToggleSettings
明るさ google コマンド BrightnessStep
明るさ google コマンド MoveToBrightness
明るさ google 属性 currentBrightnessPercent
SimplifiedOnOff google 属性 onOff
SimplifiedThermostat google コマンド SetSystemMode
SimplifiedThermostat google 属性 systemMode
ボリューム google コマンド MoveToVolume
ボリューム google コマンド ミュート
ボリューム google コマンド ミュートを解除
ボリューム google コマンド VolumeStep
ボリューム google 属性 currentVolumePercent
ボリューム google 属性 isMuted
AreaAttendanceState google 属性 attendanceState
AreaPresenceState google 属性 presenceState