Hỗ trợ đặc điểm API tự động hoá

Automation API hỗ trợ hầu hết các đặc điểm, nhưng có thể chỉ hỗ trợ một số thuộc tính, sự kiện và lệnh trong một đặc điểm.

Để xác minh rằng Automation API hỗ trợ trường hợp sử dụng của bạn, hãy tìm kiếm trong bảng bên dưới.

Nói chung:

  • Bạn phải đăng ký mọi đặc điểm và loại mà bạn dự định sử dụng trong ứng dụng bằng API Tự động hoá khi khởi chạy. Xem phần Tạo thực thể Home.
  • Bạn có thể sử dụng bất kỳ thuộc tính nào trong phần khởi động hoặc điều kiện.
  • Không thể sử dụng các thiết bị Cloud-to-cloud không báo cáo trạng thái của chúng làm trình kích hoạt trong các quy trình tự động hoá, được tạo theo cách thủ công hoặc thông qua tính năng khám phá.
  • Ngay cả khi một thiết bị hỗ trợ các đặc điểm được liệt kê ở đây, thiết bị đó vẫn có thể bị chặn sử dụng làm trình khởi động hoặc hành động trong API Tự động hoá do ngưỡng chất lượng Trạng thái báo cáo:
    • Những thiết bị có tỷ lệ thành công của Báo cáo trạng thái thấp hơn 90% sẽ bị chặn sử dụng làm trình khởi động.
    • Các thiết bị có tỷ lệ thực thi lệnh thành công thấp hơn 95% sẽ bị chặn sử dụng làm hành động.
  • Bạn chỉ có thể sử dụng lệnh dưới dạng hành động.
  • Một số đặc điểm, chẳng hạn như AssistantBroadcast, chỉ có thể sử dụng trong Automation API.
  • Lệnh okGoogle là lệnh cấp cấu trúc và có thể được dùng để tự động hoá mọi thiết bị trong cấu trúc. Tuy nhiên, ứng dụng Home API có thể không có quyền truy cập vào mọi thiết bị. Hãy xem phần Quyền của OkGoogle để biết cách thực thi quyền trong nhiều trường hợp.
  • Một số đặc điểm có điều kiện tiên quyết:
    • Để sử dụng Time.ScheduledTimeEvent, cấu trúc mà tính năng tự động hoá chạy trong đó phải có địa chỉ đường phố được thiết lập trong Google Home app (GHA). Thay đổi địa chỉ nhà trên Google giải thích cách người dùng có thể nhập địa chỉ cấu trúc. Nếu bạn không thiết lập địa chỉ trong GHA, thì hệ thống sẽ không tạo được quy trình tự động và sẽ gửi một lỗi kèm theo thông báo "structure không hỗ trợ ScheduledTimeEvent".
    • Để sử dụng các đặc điểm AreaPresenceState hoặc AreaAttendanceState, người dùng phải thiết lập tính năng cảm biến sự hiện diện trong GHA.
    • Để sử dụng đặc điểm ObjectDetection, người dùng phải có gói thuê bao Nest Aware đang hoạt động.

Bạn cũng có thể sử dụng các phiên bản đơn giản của một số đặc điểm trong quy trình tự động hoá. Để biết thêm thông tin, hãy xem phần Các đặc điểm được đơn giản hoá.

Khối cho biết lệnh không được hỗ trợ trong tính năng tự động hoá cho một hoặc nhiều loại thiết bị. Để biết thêm thông tin, hãy tham khảo phần Thao tác bị chặn trong quy trình tự động hoá.

Đặc điểm Loại đặc điểm Loại phần tử Phần tử
AssistantBroadcast google Lệnh Thông báo truyền tin
AssistantFulfillment google Lệnh OkGoogle
Thông báo google Lệnh SendNotifications
Thời gian google Sự kiện ScheduledTimeEvent
Thời gian google Thuộc tính currentTime
Thời gian google Thuộc tính missingStructureLocation
Thời gian google Thuộc tính sunriseTime
Thời gian google Thuộc tính sunsetTime
VoiceStarter google Sự kiện OkGoogleEvent
AirQuality vấn đề Thuộc tính airQuality
ApplicationLauncher vấn đề Lệnh LaunchApp
ApplicationLauncher vấn đề Lệnh StopApp
ApplicationLauncher vấn đề Thuộc tính currentApp
AudioOutput vấn đề Thuộc tính currentOutput
CarbonDioxideConcentrationMeasurement vấn đề Thuộc tính levelValue
CarbonDioxideConcentrationMeasurement vấn đề Thuộc tính measuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính levelValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính maxMeasuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính measuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính measurementUnit
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính minMeasuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính không chắc chắn
Kênh vấn đề Lệnh ChangeChannelByNumber
Kênh vấn đề Lệnh SkipChannel
ColorControl vấn đề Lệnh ColorLoopSet
ColorControl vấn đề Lệnh MoveColor
ColorControl vấn đề Lệnh MoveColorTemperature
ColorControl vấn đề Lệnh MoveToColor
ColorControl vấn đề Lệnh MoveToColorTemperature
ColorControl vấn đề Lệnh MoveToHue
ColorControl vấn đề Lệnh MoveToHueAndSaturation
ColorControl vấn đề Lệnh MoveToSaturation
ColorControl vấn đề Lệnh StepColor
ColorControl vấn đề Lệnh StepColorTemperature
ColorControl vấn đề Thuộc tính colorTemperatureMireds
ColorControl vấn đề Thuộc tính currentHue
ColorControl vấn đề Thuộc tính currentX
ColorControl vấn đề Thuộc tính currentY
DishwasherMode vấn đề Lệnh ChangeToMode
DishwasherMode vấn đề Thuộc tính currentMode
DishwasherMode vấn đề Thuộc tính onMode
DoorLock vấn đề Sự kiện DoorLockAlarm
DoorLock vấn đề Sự kiện DoorStateChange
DoorLock vấn đề Lệnh LockDoor
DoorLock vấn đề Sự kiện LockOperation
DoorLock vấn đề Sự kiện LockOperationError
DoorLock vấn đề Lệnh UnlockDoor
DoorLock vấn đề Thuộc tính doorClosedEvents
DoorLock vấn đề Thuộc tính doorOpenEvents
DoorLock vấn đề Thuộc tính doorState
DoorLock vấn đề Thuộc tính lockState
FanControl vấn đề Lệnh Bước
FanControl vấn đề Thuộc tính airflowDirection
FanControl vấn đề Thuộc tính fanMode
FanControl vấn đề Thuộc tính percentCurrent
FanControl vấn đề Thuộc tính percentSetting
FanControl vấn đề Thuộc tính speedCurrent
FanControl vấn đề Thuộc tính speedSetting
FanControl vấn đề Thuộc tính windSetting
FormaldehydeConcentrationMeasurement vấn đề Thuộc tính levelValue
FormaldehydeConcentrationMeasurement vấn đề Thuộc tính measuredValue
IlluminanceMeasurement vấn đề Thuộc tính measuredValue
LaundryWasherMode vấn đề Lệnh ChangeToMode
LaundryWasherMode vấn đề Thuộc tính currentMode
LaundryWasherMode vấn đề Thuộc tính onMode
LevelControl vấn đề Lệnh Di chuyển
LevelControl vấn đề Lệnh MoveToLevel
LevelControl vấn đề Lệnh MoveToLevelWithOnOff
LevelControl vấn đề Lệnh MoveWithOnOff
LevelControl vấn đề Lệnh Bước
LevelControl vấn đề Lệnh StepWithOnOff
LevelControl vấn đề Lệnh Dừng
LevelControl vấn đề Lệnh StopWithOnOff
LevelControl vấn đề Thuộc tính currentLevel
LevelControl vấn đề Thuộc tính maxLevel
LevelControl vấn đề Thuộc tính startUpCurrentLevel
MediaInput vấn đề Lệnh RenameInput
MediaInput vấn đề Lệnh SelectInput
MediaInput vấn đề Thuộc tính currentInput
MediaPlayback vấn đề Lệnh FastForward
MediaPlayback vấn đề Lệnh Tiếp theo
MediaPlayback vấn đề Lệnh Tạm dừng
MediaPlayback vấn đề Lệnh Phát
MediaPlayback vấn đề Lệnh Trước
MediaPlayback vấn đề Lệnh Tua lại
MediaPlayback vấn đề Lệnh SkipBackward
MediaPlayback vấn đề Lệnh SkipForward
MediaPlayback vấn đề Sự kiện StateChanged
MediaPlayback vấn đề Lệnh Dừng
MediaPlayback vấn đề Thuộc tính currentState
ModeSelect vấn đề Lệnh ChangeToMode khối
ModeSelect vấn đề Thuộc tính currentMode
ModeSelect vấn đề Thuộc tính onMode
NitrogenDioxideConcentrationMeasurement vấn đề Thuộc tính levelValue
NitrogenDioxideConcentrationMeasurement vấn đề Thuộc tính measuredValue
OccupancySensing vấn đề Thuộc tính số người lưu trú
OnOff vấn đề Lệnh Tắt chặn
OnOff vấn đề Lệnh Đang bật khối
OnOff vấn đề Thuộc tính onOff
OperationalState vấn đề Sự kiện OperationCompletion
OperationalState vấn đề Lệnh Tạm dừng khối
OperationalState vấn đề Lệnh Tiếp tục khối
OperationalState vấn đề Lệnh Bắt đầu
OperationalState vấn đề Lệnh Dừng
OperationalState vấn đề Thuộc tính currentPhase
OperationalState vấn đề Thuộc tính operationalState
OzoneConcentrationMeasurement vấn đề Thuộc tính levelValue
OzoneConcentrationMeasurement vấn đề Thuộc tính measuredValue
Pm10ConcentrationMeasurement vấn đề Thuộc tính levelValue
Pm10ConcentrationMeasurement vấn đề Thuộc tính measuredValue
Pm25ConcentrationMeasurement vấn đề Thuộc tính levelValue
Pm25ConcentrationMeasurement vấn đề Thuộc tính measuredValue
PowerSource vấn đề Thuộc tính batChargeState
PowerSource vấn đề Thuộc tính batChargingCurrent
PowerSource vấn đề Thuộc tính batTimeToFullCharge
RadonConcentrationMeasurement vấn đề Thuộc tính levelValue
RadonConcentrationMeasurement vấn đề Thuộc tính measuredValue
RelativeHumidityMeasurement vấn đề Thuộc tính measuredValue
RvcCleanMode vấn đề Lệnh ChangeToMode
RvcOperationalState vấn đề Lệnh GoHome
RvcOperationalState vấn đề Lệnh Tạm dừng
RvcOperationalState vấn đề Lệnh Tiếp tục
RvcOperationalState vấn đề Thuộc tính currentPhase
RvcOperationalState vấn đề Thuộc tính operationalError
RvcOperationalState vấn đề Thuộc tính operationalState
RvcRunMode vấn đề Lệnh ChangeToMode
RvcRunMode vấn đề Thuộc tính currentMode
Công tắc vấn đề Sự kiện InitialPress
Công tắc vấn đề Sự kiện LongPress
Công tắc vấn đề Sự kiện LongRelease
Công tắc vấn đề Sự kiện MultiPressComplete
Công tắc vấn đề Sự kiện MultiPressOngoing
Công tắc vấn đề Sự kiện ShortRelease
Công tắc vấn đề Sự kiện SwitchLatched
Công tắc vấn đề Thuộc tính currentPosition
TemperatureControl vấn đề Lệnh SetTemperature khối
TemperatureControl vấn đề Thuộc tính maxTemperature
TemperatureControl vấn đề Thuộc tính minTemperature
TemperatureControl vấn đề Thuộc tính selectedTemperatureLevel
TemperatureControl vấn đề Thuộc tính temperatureSetpoint
TemperatureMeasurement vấn đề Thuộc tính measuredValue
Máy điều nhiệt vấn đề Lệnh SetpointRaiseLower
Máy điều nhiệt vấn đề Thuộc tính activePresetHandle
Máy điều nhiệt vấn đề Thuộc tính localTemperature
Máy điều nhiệt vấn đề Thuộc tính số người lưu trú
Máy điều nhiệt vấn đề Thuộc tính occupiedCoolingSetpoint
Máy điều nhiệt vấn đề Thuộc tính occupiedHeatingSetpoint
Máy điều nhiệt vấn đề Thuộc tính outdoorTemperature
Máy điều nhiệt vấn đề Thuộc tính setpointChangeSource
Máy điều nhiệt vấn đề Thuộc tính systemMode
Máy điều nhiệt vấn đề Thuộc tính temperatureSetpointHold
Máy điều nhiệt vấn đề Thuộc tính temperatureSetpointHoldDuration
Máy điều nhiệt vấn đề Thuộc tính thermostatRunningMode
Máy điều nhiệt vấn đề Thuộc tính thermostatRunningState
Máy điều nhiệt vấn đề Thuộc tính unoccupiedCoolingSetpoint
Máy điều nhiệt vấn đề Thuộc tính unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement vấn đề Thuộc tính levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement vấn đề Thuộc tính measuredValue
WindowCovering vấn đề Lệnh DownOrClose
WindowCovering vấn đề Lệnh GoToLiftPercentage
WindowCovering vấn đề Lệnh GoToLiftValue
WindowCovering vấn đề Lệnh GoToTiltPercentage
WindowCovering vấn đề Lệnh GoToTiltValue
WindowCovering vấn đề Lệnh StopMotion
WindowCovering vấn đề Lệnh UpOrOpen
WindowCovering vấn đề Thuộc tính currentPositionLift
WindowCovering vấn đề Thuộc tính currentPositionLiftPercent100ths
WindowCovering vấn đề Thuộc tính currentPositionLiftPercentage
WindowCovering vấn đề Thuộc tính currentPositionTilt
WindowCovering vấn đề Thuộc tính currentPositionTiltPercent100ths
WindowCovering vấn đề Thuộc tính currentPositionTiltPercentage
WindowCovering vấn đề Thuộc tính targetPositionLiftPercent100ths
WindowCovering vấn đề Thuộc tính targetPositionTiltPercent100ths
ArmDisarm google Lệnh ArmDisarm khối
ArmDisarm google Sự kiện ArmDisarmArmState
ArmDisarm google Thuộc tính armState
ArmDisarm google Thuộc tính currentArmLevel
ArmDisarm google Thuộc tính isArmed
Đế sạc google Lệnh Giá đỡ
Đế sạc google Thuộc tính isDocked
DoorbellPress google Sự kiện DoorbellPressed
ExtendedAirQuality google Sự kiện AirQuality
ExtendedAirQuality google Thuộc tính indoorAirQuality
ExtendedAirQuality google Thuộc tính indoorMeasuredValue
ExtendedAirQuality google Thuộc tính measuredValue
ExtendedAirQuality google Thuộc tính outdoorAirQuality
ExtendedAirQuality google Thuộc tính outdoorMeasuredValue
ExtendedColorControl google Lệnh MoveToColorHSV
ExtendedColorControl google Lệnh MoveToColorName
ExtendedColorControl google Lệnh MoveToColorRGB
ExtendedColorControl google Thuộc tính currentBlue
ExtendedColorControl google Thuộc tính currentGreen
ExtendedColorControl google Thuộc tính currentHue
ExtendedColorControl google Thuộc tính currentName
ExtendedColorControl google Thuộc tính currentRed
ExtendedColorControl google Thuộc tính currentSaturation
ExtendedColorControl google Thuộc tính currentValue
ExtendedFanControl google Lệnh ToggleAirflowDirection
ExtendedFanControl google Thuộc tính customFanMode
ExtendedFanControl google Thuộc tính customFanModes
ExtendedMediaInput google Lệnh NextInput
ExtendedMediaInput google Lệnh PreviousInput
ExtendedMediaInput google Lệnh SelectCustomInput
ExtendedMediaInput google Thuộc tính currentCustomInput
ExtendedMediaInput google Thuộc tính customInputsList
ExtendedMediaInput google Thuộc tính customInputsOrdered
ExtendedOperationalState google Sự kiện PauseUnpauseFollowUp
ExtendedOperationalState google Sự kiện StartStopFollowUp
ExtendedPowerSource google Lệnh StartCharging
ExtendedPowerSource google Lệnh StopCharging
ExtendedThermostat google Thuộc tính activePresetHandle
ExtendedThermostat google Thuộc tính activeRemoteTemperatureSensorIds
ExtendedThermostat google Thuộc tính averageLocalTemperature
ExtendedThermostat google Thuộc tính extendedRunningMode
ExtendedThermostat google Thuộc tính extendedSystemMode
LightEffects google Lệnh PulseEffectSet
LightEffects google Lệnh SleepEffectSet
LightEffects google Lệnh StopEffect
LightEffects google Lệnh WakeEffectSet
LightEffects google Thuộc tính pulseEffectSet
LightEffects google Thuộc tính sleepEffectSet
LightEffects google Thuộc tính wakeEffectSet
LockUnlock google Lệnh Khoá
LockUnlock google Lệnh Mở khoá khối
LockUnlock google Thuộc tính lockState
MotionDetection google Sự kiện MotionDetected
MotionDetection google Thuộc tính motionDetectionEventInProgress
ObjectDetection google Sự kiện ObjectDetected
OpenClose google Lệnh Đóng khối
OpenClose google Lệnh GoToOpenPercentage khối
OpenClose google Lệnh Mở khối
OpenClose google Lệnh Bước chặn
OpenClose google Thuộc tính openPercent
OpenClose google Thuộc tính openState
OpenClose google Thuộc tính targetOpenPercent
Bản ghi google Lệnh StartRecording
Bản ghi google Lệnh StopRecording
Bản ghi google Thuộc tính isCurrentlyRecording
Nút bật/tắt google Lệnh ChangeToggleSettings block
Nút bật/tắt google Thuộc tính currentToggleSettings
Độ sáng google Lệnh BrightnessStep
Độ sáng google Lệnh MoveToBrightness
Độ sáng google Thuộc tính currentBrightnessPercent
SimplifiedOnOff google Thuộc tính onOff
SimplifiedThermostat google Lệnh SetSystemMode
SimplifiedThermostat google Thuộc tính systemMode
Dung lượng google Lệnh MoveToVolume
Tập google Lệnh Tắt tiếng
Tập google Lệnh Bật tiếng
Tập google Lệnh VolumeStep
Tập google Thuộc tính currentVolumePercent
Tập google Thuộc tính isMuted
AreaAttendanceState google Thuộc tính attendanceState
AreaPresenceState google Thuộc tính presenceState