תמיכה במאפיינים של Automation API

Automation API תומך ברוב המאפיינים, אבל יכול להיות שתהיה תמיכה מוגבלת במאפיינים מסוימים, באירועים ובפקודות.

כדי לוודא ש-Automation API תומך בתרחיש לדוגמה שלכם, תוכלו לחפש בטבלה שבהמשך.

ככלל:

  • צריך לרשום את כל המאפיינים והסוגים שבהם אתם מתכוונים להשתמש באפליקציה באמצעות Automation API במהלך האינטליקציה. איך יוצרים מכונה ביתית
  • אפשר להשתמש בכל מאפיין בתור אות לתחילת פעולה או תנאי.
  • אי אפשר להשתמש במכשירי Cloud-to-cloud שלא מדווחים על המצב שלהם כטריגרים בתהליכים אוטומטיים שנוצרים באופן ידני או באמצעות Discovery.
  • גם אם מכשיר תומך בתכונות שמפורטות כאן, יכול להיות שהוא ייחסם לשימוש כסימן להתחלת פעולה או כפעולה ב-Automation API בגלל ערכי הסף של איכות Report State:
    • מכשירים עם שיעור הצלחה של דיווח על מצב נמוך מ-90% חסומים לשימוש כסימנים לתחילת פעולה.
    • מכשירי שבהם שיעור ההצלחה של ביצוע הפקודה נמוך מ-95% חסומים לשימוש כפעולות.
  • אפשר להשתמש בפקודות רק כפעולות.
  • מאפיינים מסוימים, כמו AssistantBroadcast, זמינים לשימוש רק ב-Automation API.
  • הפקודה okGoogle היא פקודה ברמת המבנה, וניתן להשתמש בה כדי להפוך כל מכשיר במבנה לאוטומטי. עם זאת, יכול להיות שלאפליקציה עם ממשקי Home API לא תהיה גישה לכל המכשירים. במאמר הרשאות OkGoogle מוסבר איך ההרשאות נאכפות במקרים שונים.
  • לחלק מהתכונות יש דרישות מוקדמות:
    • כדי להשתמש ב-Time.ScheduledTimeEvent, למבנה שבו פועל האוטומציה צריכה להיות כתובת רחוב שהוגדרה ב-Google Home app (GHA). במאמר שינוי כתובת הבית ב-Google מוסבר איך משתמשים יכולים להזין את כתובת המבנה. אם לא מגדירים את הכתובת ב-GHA, לא ניתן ליצור את האוטומציה ותופיע הודעת השגיאה "The ScheduledTimeEvent is not supported by the structure".
    • כדי להשתמש במאפיינים AreaPresenceState או AreaAttendanceState, המשתמש צריך להגדיר את חיישן הנוכחות ב-GHA.
    • כדי להשתמש במאפיין ObjectDetection, למשתמש צריך להיות מינוי פעיל ל-Nest Aware.

יש גם גרסאות פשוטות יותר של מאפיינים מסוימים שזמינות לשימוש בתהליכים אוטומטיים. מידע נוסף זמין במאמר מאפיינים פשוטים.

חסימה מציינת שהפקודה לא נתמכת בתהליכים אוטומטיים לסוג מכשיר אחד או יותר. מידע נוסף זמין במאמר פעולות חסרות גישה בתהליכים אוטומטיים.

מאפיין סוג המאפיין סוג הרכיב רכיב
AssistantBroadcast google פקודה שידור
AssistantFulfillment google פקודה OkGoogle
התראה google פקודה SendNotifications
Time google אירוע ScheduledTimeEvent
Time google מאפיין currentTime
Time google מאפיין missingStructureLocation
Time google מאפיין sunriseTime
Time 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 מאפיין אי-ודאות
ערוץ 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 פקודה Stop
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 פקודה Play
MediaPlayback matter פקודה הקודם
MediaPlayback matter פקודה הרצה אחורה
MediaPlayback matter פקודה SkipBackward
MediaPlayback matter פקודה SkipForward
MediaPlayback matter אירוע StateChanged
MediaPlayback matter פקודה Stop
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 פקודה Stop
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
מתג matter אירוע LongPress
Switch matter אירוע LongRelease
Switch matter אירוע MultiPressComplete
מתג matter אירוע MultiPressOngoing
מתג matter אירוע ShortRelease
מתג matter אירוע SwitchLatched
מתג matter מאפיין currentPosition
TemperatureControl matter פקודה SetTemperature block
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
Dock google פקודה Dock
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 פקודה ביטול הנעילה חסימה
LockUnlock google מאפיין lockState
MotionDetection google אירוע MotionDetected
MotionDetection google מאפיין motionDetectionEventInProgress
ObjectDetection google אירוע ObjectDetected
OpenClose google פקודה סגירה חסימה
OpenClose google פקודה GoToOpenPercentage block
OpenClose google פקודה פתיחת חסימה
OpenClose google פקודה שלב חסימה
OpenClose google מאפיין openPercent
OpenClose google מאפיין openState
OpenClose google מאפיין targetOpenPercent
רשומה google פקודה StartRecording
רשומה google פקודה StopRecording
רשומה google מאפיין isCurrentlyRecording
לחצני החלפת מצב google פקודה ChangeToggleSettings block
לחצני החלפת מצב 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