자동화 API 트레잇 지원

Automation API는 대부분의 트레잇을 지원하지만 트레잇의 일부 속성, 이벤트, 명령어에 대한 지원은 제한적일 수 있습니다.

Automation API가 사용 사례를 지원하는지 확인하려면 아래 표를 검색하세요.

일반적인 정보는 다음과 같습니다.

  • 앱에서 Automation API와 함께 사용할 모든 트레잇과 유형은 초기화 시 등록해야 합니다. 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에 설정되지 않으면 자동화가 생성되지 않고 'structure에서 ScheduledTimeEvent가 지원되지 않습니다'라는 메시지와 함께 오류가 발생합니다.
    • AreaPresenceState 또는 AreaAttendanceState 트레잇을 사용하려면 사용자가 GHA에서 인기척 감지를 설정해야 합니다.
    • ObjectDetection 트레잇을 사용하려면 사용자에게 활성 상태의 Nest Aware 요금제가 있어야 합니다.

자동화에서 사용할 수 있는 일부 트레잇의 단순화된 버전도 있습니다. 자세한 내용은 단순화된 트레잇을 참고하세요.

블록은 하나 이상의 기기 유형에 대한 자동화에서 명령어가 지원되지 않음을 나타냅니다. 자세한 내용은 자동화에서 차단된 작업을 참고하세요.

형질 트레잇 유형 요소 유형 요소
AssistantBroadcast google 명령어 방송
AssistantFulfillment google 명령어 OkGoogle
알림 google 명령어 SendNotifications
시간 google 이벤트 ScheduledTimeEvent
시간 google 속성 currentTime
시간 google 속성 missingStructureLocation
시간 google 속성 sunriseTime
시간 google 속성 sunsetTime
VoiceStarter google 이벤트 OkGoogleEvent
AirQuality matter 속성 airQuality
ApplicationLauncher matter 명령어 LaunchApp
ApplicationLauncher matter 명령어 StopApp
ApplicationLauncher matter 속성 currentApp
AudioOutput matter 속성 currentOutput
CarbonDioxideConcentrationMeasurement matter 속성 levelValue
CarbonDioxideConcentrationMeasurement matter 속성 measuredValue
CarbonMonoxideConcentrationMeasurement matter 속성 levelValue
CarbonMonoxideConcentrationMeasurement matter 속성 maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter 속성 measuredValue
CarbonMonoxideConcentrationMeasurement matter 속성 measurementUnit
CarbonMonoxideConcentrationMeasurement matter 속성 minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter 속성 uncertainty
채널 matter 명령어 ChangeChannelByNumber
채널 matter 명령어 SkipChannel
ColorControl matter 명령어 ColorLoopSet
ColorControl matter 명령어 MoveColor
ColorControl matter 명령어 MoveColorTemperature
ColorControl matter 명령어 MoveToColor
ColorControl matter 명령어 MoveToColorTemperature
ColorControl matter 명령어 MoveToHue
ColorControl matter 명령어 MoveToHueAndSaturation
ColorControl matter 명령어 MoveToSaturation
ColorControl matter 명령어 StepColor
ColorControl matter 명령어 StepColorTemperature
ColorControl matter 속성 colorTemperatureMireds
ColorControl matter 속성 currentHue
ColorControl matter 속성 currentX
ColorControl matter 속성 currentY
DishwasherMode matter 명령어 ChangeToMode
DishwasherMode matter 속성 currentMode
DishwasherMode matter 속성 onMode
DoorLock matter 이벤트 DoorLockAlarm
DoorLock matter 이벤트 DoorStateChange
DoorLock matter 명령어 LockDoor
DoorLock matter 이벤트 LockOperation
DoorLock matter 이벤트 LockOperationError
DoorLock matter 명령어 UnlockDoor
DoorLock matter 속성 doorClosedEvents
DoorLock matter 속성 doorOpenEvents
DoorLock matter 속성 doorState
DoorLock matter 속성 lockState
FanControl matter 명령어 단계
FanControl matter 속성 airflowDirection
FanControl matter 속성 fanMode
FanControl matter 속성 percentCurrent
FanControl matter 속성 percentSetting
FanControl matter 속성 speedCurrent
FanControl matter 속성 speedSetting
FanControl matter 속성 windSetting
FormaldehydeConcentrationMeasurement matter 속성 levelValue
FormaldehydeConcentrationMeasurement matter 속성 measuredValue
IlluminanceMeasurement matter 속성 measuredValue
LaundryWasherMode matter 명령어 ChangeToMode
LaundryWasherMode matter 속성 currentMode
LaundryWasherMode matter 속성 onMode
LevelControl matter 명령어 이동
LevelControl matter 명령어 MoveToLevel
LevelControl matter 명령어 MoveToLevelWithOnOff
LevelControl matter 명령어 MoveWithOnOff
LevelControl matter 명령어 단계
LevelControl matter 명령어 StepWithOnOff
LevelControl matter 명령어 중지
LevelControl matter 명령어 StopWithOnOff
LevelControl matter 속성 currentLevel
LevelControl matter 속성 maxLevel
LevelControl matter 속성 startUpCurrentLevel
MediaInput matter 명령어 RenameInput
MediaInput matter 명령어 SelectInput
MediaInput matter 속성 currentInput
MediaPlayback matter 명령어 FastForward
MediaPlayback matter 명령어 다음
MediaPlayback matter 명령어 일시중지
MediaPlayback matter 명령어 재생
MediaPlayback matter 명령어 이전
MediaPlayback matter 명령어 되감기
MediaPlayback matter 명령어 SkipBackward
MediaPlayback matter 명령어 SkipForward
MediaPlayback matter 이벤트 StateChanged
MediaPlayback matter 명령어 중지
MediaPlayback matter 속성 currentState
ModeSelect matter 명령어 ChangeToMode block
ModeSelect matter 속성 currentMode
ModeSelect matter 속성 onMode
NitrogenDioxideConcentrationMeasurement matter 속성 levelValue
NitrogenDioxideConcentrationMeasurement matter 속성 measuredValue
OccupancySensing matter 속성 숙박 인원
OnOff matter 명령어 사용 안함 차단
OnOff matter 명령어 사용 차단
OnOff matter 속성 onOff
OperationalState matter 이벤트 OperationCompletion
OperationalState matter 명령어 일시중지 차단
OperationalState matter 명령어 재개 블록
OperationalState matter 명령어 시작
OperationalState matter 명령어 중지
OperationalState matter 속성 currentPhase
OperationalState matter 속성 operationalState
OzoneConcentrationMeasurement matter 속성 levelValue
OzoneConcentrationMeasurement matter 속성 measuredValue
Pm10ConcentrationMeasurement matter 속성 levelValue
Pm10ConcentrationMeasurement matter 속성 measuredValue
Pm25ConcentrationMeasurement matter 속성 levelValue
Pm25ConcentrationMeasurement matter 속성 measuredValue
PowerSource matter 속성 batChargeState
PowerSource matter 속성 batChargingCurrent
PowerSource matter 속성 batTimeToFullCharge
RadonConcentrationMeasurement matter 속성 levelValue
RadonConcentrationMeasurement matter 속성 measuredValue
RelativeHumidityMeasurement matter 속성 measuredValue
RvcCleanMode matter 명령어 ChangeToMode
RvcOperationalState matter 명령어 GoHome
RvcOperationalState matter 명령어 일시중지
RvcOperationalState matter 명령어 재개
RvcOperationalState matter 속성 currentPhase
RvcOperationalState matter 속성 operationalError
RvcOperationalState matter 속성 operationalState
RvcRunMode matter 명령어 ChangeToMode
RvcRunMode matter 속성 currentMode
스위치 matter 이벤트 InitialPress
Switch matter 이벤트 LongPress
Switch matter 이벤트 LongRelease
Switch matter 이벤트 MultiPressComplete
스위치 matter 이벤트 MultiPressOngoing
Switch matter 이벤트 ShortRelease
Switch matter 이벤트 SwitchLatched
Switch matter 속성 currentPosition
TemperatureControl matter 명령어 SetTemperature 블록
TemperatureControl matter 속성 maxTemperature
TemperatureControl matter 속성 minTemperature
TemperatureControl matter 속성 selectedTemperatureLevel
TemperatureControl matter 속성 temperatureSetpoint
TemperatureMeasurement matter 속성 measuredValue
온도 조절기 matter 명령어 SetpointRaiseLower
온도 조절기 matter 속성 activePresetHandle
온도 조절기 matter 속성 localTemperature
온도 조절기 matter 속성 숙박 인원
온도 조절기 matter 속성 occupiedCoolingSetpoint
온도 조절기 matter 속성 occupiedHeatingSetpoint
온도 조절기 matter 속성 outdoorTemperature
온도 조절기 matter 속성 setpointChangeSource
온도 조절기 matter 속성 systemMode
온도 조절기 matter 속성 temperatureSetpointHold
온도 조절기 matter 속성 temperatureSetpointHoldDuration
온도 조절기 matter 속성 thermostatRunningMode
온도 조절기 matter 속성 thermostatRunningState
온도 조절기 matter 속성 unoccupiedCoolingSetpoint
온도 조절기 matter 속성 unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter 속성 levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter 속성 measuredValue
WindowCovering matter 명령어 DownOrClose
WindowCovering matter 명령어 GoToLiftPercentage
WindowCovering matter 명령어 GoToLiftValue
WindowCovering matter 명령어 GoToTiltPercentage
WindowCovering matter 명령어 GoToTiltValue
WindowCovering matter 명령어 StopMotion
WindowCovering matter 명령어 UpOrOpen
WindowCovering matter 속성 currentPositionLift
WindowCovering matter 속성 currentPositionLiftPercent100ths
WindowCovering matter 속성 currentPositionLiftPercentage
WindowCovering matter 속성 currentPositionTilt
WindowCovering matter 속성 currentPositionTiltPercent100ths
WindowCovering matter 속성 currentPositionTiltPercentage
WindowCovering matter 속성 targetPositionLiftPercent100ths
WindowCovering matter 속성 targetPositionTiltPercent100ths
ArmDisarm google 명령어 ArmDisarm block
ArmDisarm google 이벤트 ArmDisarmArmState
ArmDisarm google 속성 armState
ArmDisarm google 속성 currentArmLevel
ArmDisarm google 속성 isArmed
도크 google 명령어 Dock
도크 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 명령어 StartCharging
ExtendedPowerSource google 명령어 StopCharging
ExtendedThermostat google 속성 activePresetHandle
ExtendedThermostat google 속성 activeRemoteTemperatureSensorIds
ExtendedThermostat google 속성 averageLocalTemperature
ExtendedThermostat google 속성 extendedRunningMode
ExtendedThermostat google 속성 extendedSystemMode
LightEffects google 명령어 PulseEffectSet
LightEffects google 명령어 SleepEffectSet
LightEffects google 명령어 StopEffect
LightEffects google 명령어 WakeEffectSet
LightEffects google 속성 pulseEffectSet
LightEffects google 속성 sleepEffectSet
LightEffects google 속성 wakeEffectSet
LockUnlock google 명령어 잠금
LockUnlock google 명령어 Unlock block
LockUnlock google 속성 lockState
MotionDetection google 이벤트 MotionDetected
MotionDetection google 속성 motionDetectionEventInProgress
ObjectDetection google 이벤트 ObjectDetected
OpenClose google 명령어 닫기 블록
OpenClose google 명령어 GoToOpenPercentage 블록
OpenClose google 명령어 열기 블록
OpenClose google 명령어 Step block
OpenClose google 속성 openPercent
OpenClose google 속성 openState
OpenClose google 속성 targetOpenPercent
녹화 google 명령어 StartRecording
기록 google 명령어 StopRecording
녹화 google 속성 isCurrentlyRecording
전환 google 명령어 ChangeToggleSettings 차단
전환 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