پشتیبانی از ویژگی API Automation

Automation API از اکثر ویژگی ها پشتیبانی می کند، اما پشتیبانی از برخی ویژگی ها، رویدادها و دستورات در یک ویژگی ممکن است محدود باشد.

برای تأیید اینکه Automation API از موارد استفاده شما پشتیبانی می کند، در جدول زیر جستجو کنید.

به طور کلی:

  • هر گونه ویژگی و انواعی که قصد دارید در برنامه خود با Automation API استفاده کنید، باید در زمان اولیه ثبت شوند. به ایجاد نمونه خانه مراجعه کنید.
  • هر ویژگی ممکن است در شروع یا شرایط استفاده شود.
  • دستگاه‌های Cloud-to-cloud که وضعیت خود را گزارش نمی‌کنند، نمی‌توانند به‌عنوان محرک در اتوماسیون‌هایی که به صورت دستی یا از طریق کشف ایجاد می‌شوند، استفاده شوند.
  • حتی اگر دستگاهی از ویژگی‌های فهرست‌شده در اینجا پشتیبانی می‌کند، ممکن است به دلیل آستانه‌های کیفیت گزارش وضعیت ، استفاده از دستگاه به‌عنوان راه‌انداز یا اقدام در API Automation مسدود شود:
    • دستگاه‌هایی با نرخ موفقیت وضعیت گزارش کمتر از 90 درصد به‌عنوان شروع کننده استفاده نمی‌شوند.
    • دستگاه‌هایی با نرخ موفقیت اجرای فرمان کمتر از 95 درصد، از استفاده به‌عنوان کنش مسدود می‌شوند.
  • از دستورات فقط می توان به عنوان اکشن استفاده کرد.
  • برخی از ویژگی‌ها، مانند AssistantBroadcast ، فقط برای استفاده در Automation API در دسترس هستند.
  • دستور okGoogle یک دستور در سطح ساختار است و می تواند برای خودکار کردن هر دستگاهی در ساختار استفاده شود. با این حال، برنامه Home APIs ممکن است به همه دستگاه‌ها دسترسی نداشته باشد. برای مشاهده نحوه اعمال مجوزها در موارد مختلف، به مجوزهای OkGoogle مراجعه کنید.
  • برخی از صفات دارای پیش نیازهایی هستند:
    • برای استفاده از Time.ScheduledTimeEvent ، ساختاری که اتوماسیون در آن اجرا می‌شود باید دارای آدرس خیابانی باشد که در Google Home app (GHA) تنظیم شده است. تغییر آدرس خانه Google توضیح می دهد که چگونه کاربر می تواند آدرس ساختار را وارد کند. اگر آدرس در GHA تنظیم نشده باشد، اتوماسیون ایجاد نمی‌شود و خطایی با پیام "The ScheduledTimeEvent توسط structure پشتیبانی نمی‌شود" ارسال می‌شود.
    • برای استفاده از صفات AreaPresenceState یا AreaAttendanceState ، کاربر باید حسگر حضور را در GHA تنظیم کند.
    • برای استفاده از ویژگی ObjectDetection ، کاربر باید یک اشتراک Nest Aware فعال داشته باشد.

نسخه های ساده شده برخی از ویژگی ها نیز برای استفاده در اتوماسیون موجود است. برای اطلاعات بیشتر، صفات ساده شده را ببینید.

یک بلوک نشان می دهد که این فرمان در اتوماسیون برای یک یا چند نوع دستگاه پشتیبانی نمی شود. برای اطلاعات بیشتر، به اقدامات مسدود شده در اتوماسیون ها مراجعه کنید.

صفت نوع صفت نوع عنصر عنصر
AssistantBroadcast گوگل فرمان پخش می شود
AssistantFulfillment گوگل فرمان OkGoogle
اطلاع رسانی گوگل فرمان SendNotifications
زمان گوگل رویداد ScheduledTimeEvent
زمان گوگل صفت زمان جاری
زمان گوگل صفت missingStructureLocation
زمان گوگل صفت زمان طلوع آفتاب
زمان گوگل صفت زمان غروب آفتاب
VoiceStarter گوگل رویداد OkGoogleEvent
کیفیت هوا موضوع صفت کیفیت هوا
Application Launcher موضوع فرمان راه اندازی برنامه
Application Launcher موضوع فرمان StopApp
Application Launcher موضوع صفت برنامه فعلی
خروجی صدا موضوع صفت جریان خروجی
اندازه گیری غلظت دی اکسید کربن موضوع صفت سطح ارزش
اندازه گیری غلظت دی اکسید کربن موضوع صفت مقدار اندازه گیری شده
اندازه گیری غلظت مونوکسید کربن موضوع صفت سطح ارزش
اندازه گیری غلظت مونوکسید کربن موضوع صفت maxMeasuredValue
اندازه گیری غلظت مونوکسید کربن موضوع صفت مقدار اندازه گیری شده
اندازه گیری غلظت مونوکسید کربن موضوع صفت واحد اندازه گیری
اندازه گیری غلظت مونوکسید کربن موضوع صفت minMeasuredValue
اندازه گیری غلظت مونوکسید کربن موضوع صفت عدم قطعیت
کانال موضوع فرمان 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 موضوع صفت جریان ایکس
ColorControl موضوع صفت فعلیY
حالت ماشین ظرفشویی موضوع فرمان ChangeToMode
حالت ماشین ظرفشویی موضوع صفت حالت فعلی
حالت ماشین ظرفشویی موضوع صفت در حالت
قفل درب موضوع رویداد زنگ هشدار قفل در
قفل درب موضوع رویداد DoorStateChange
قفل درب موضوع فرمان قفل درب
قفل درب موضوع رویداد LockOperation
قفل درب موضوع رویداد LockOperationError
قفل درب موضوع فرمان باز کردن درب
قفل درب موضوع صفت doorClosedEvents
قفل درب موضوع صفت doorOpenEvents
قفل درب موضوع صفت درب دولت
قفل درب موضوع صفت lockState
فن کنترل موضوع فرمان مرحله
فن کنترل موضوع صفت جهت جریان هوا
فن کنترل موضوع صفت حالت فن
فن کنترل موضوع صفت درصد جریان
فن کنترل موضوع صفت درصد تنظیم
فن کنترل موضوع صفت سرعت جریان
فن کنترل موضوع صفت تنظیم سرعت
فن کنترل موضوع صفت باد تنظیم
اندازه گیری غلظت فرمالدئید موضوع صفت سطح ارزش
اندازه گیری غلظت فرمالدئید موضوع صفت مقدار اندازه گیری شده
اندازه گیری روشنایی موضوع صفت مقدار اندازه گیری شده
LaundryWasher Mode موضوع فرمان ChangeToMode
LaundryWasher Mode موضوع صفت حالت فعلی
LaundryWasher Mode موضوع صفت در حالت
LevelControl موضوع فرمان حرکت کنید
LevelControl موضوع فرمان MoveToLevel
LevelControl موضوع فرمان MoveToLevelWithOnOff
LevelControl موضوع فرمان MoveWithOnOff
LevelControl موضوع فرمان مرحله
LevelControl موضوع فرمان StepWithOnOff
LevelControl موضوع فرمان توقف کنید
LevelControl موضوع فرمان StopWithOnOff
LevelControl موضوع صفت سطح فعلی
LevelControl موضوع صفت maxLevel
LevelControl موضوع صفت startUpCurrentLevel
MediaInput موضوع فرمان RenameInput
MediaInput موضوع فرمان ورودی را انتخاب کنید
MediaInput موضوع صفت جریان ورودی
MediaPlayback موضوع فرمان FastForward
MediaPlayback موضوع فرمان بعدی
MediaPlayback موضوع فرمان مکث کنید
MediaPlayback موضوع فرمان بازی کنید
MediaPlayback موضوع فرمان قبلی
MediaPlayback موضوع فرمان عقب
MediaPlayback موضوع فرمان SkipBackward
MediaPlayback موضوع فرمان SkipForward
MediaPlayback موضوع رویداد وضعیت تغییر کرد
MediaPlayback موضوع فرمان توقف کنید
MediaPlayback موضوع صفت وضعیت فعلی
ModeSelect موضوع فرمان بلوک ChangeToMode
ModeSelect موضوع صفت حالت فعلی
ModeSelect موضوع صفت در حالت
اندازه گیری غلظت دی اکسید نیتروژن موضوع صفت سطح ارزش
اندازه گیری غلظت دی اکسید نیتروژن موضوع صفت مقدار اندازه گیری شده
Occupancy Sensing موضوع صفت اشغال
روشن خاموش موضوع فرمان بلوک خاموش
روشن خاموش موضوع فرمان در بلوک
روشن خاموش موضوع صفت روشن خاموش
حالت عملیاتی موضوع رویداد تکمیل عملیات
حالت عملیاتی موضوع فرمان بلوک مکث
حالت عملیاتی موضوع فرمان از سرگیری بلوک
حالت عملیاتی موضوع فرمان شروع کنید
حالت عملیاتی موضوع فرمان توقف کنید
حالت عملیاتی موضوع صفت فاز فعلی
حالت عملیاتی موضوع صفت حالت عملیاتی
اندازه گیری غلظت ازن موضوع صفت سطح ارزش
اندازه گیری غلظت ازن موضوع صفت مقدار اندازه گیری شده
اندازه گیری غلظت Pm10 موضوع صفت سطح ارزش
اندازه گیری غلظت Pm10 موضوع صفت مقدار اندازه گیری شده
اندازه گیری غلظت Pm25 موضوع صفت سطح ارزش
اندازه گیری غلظت Pm25 موضوع صفت مقدار اندازه گیری شده
منبع تغذیه موضوع صفت batChargeState
منبع تغذیه موضوع صفت batChargingCurrent
منبع تغذیه موضوع صفت batTimeToFullCharge
اندازه گیری غلظت رادون موضوع صفت سطح ارزش
اندازه گیری غلظت رادون موضوع صفت مقدار اندازه گیری شده
اندازه گیری رطوبت نسبی موضوع صفت مقدار اندازه گیری شده
RvcCleanMode موضوع فرمان ChangeToMode
RvcOperationalState موضوع فرمان GoHome
RvcOperationalState موضوع فرمان مکث کنید
RvcOperationalState موضوع فرمان رزومه
RvcOperationalState موضوع صفت فاز فعلی
RvcOperationalState موضوع صفت خطای عملیاتی
RvcOperationalState موضوع صفت حالت عملیاتی
RvcRunMode موضوع فرمان ChangeToMode
RvcRunMode موضوع صفت حالت فعلی
سوئیچ موضوع رویداد InitialPress
سوئیچ موضوع رویداد Long Press
سوئیچ موضوع رویداد LongRelease
سوئیچ موضوع رویداد MultiPressComplete
سوئیچ موضوع رویداد MultiPressOngoing
سوئیچ موضوع رویداد ShortRelease
سوئیچ موضوع رویداد SwitchLatched
سوئیچ موضوع صفت موقعیت فعلی
کنترل دما موضوع فرمان بلوک SetTemperature
کنترل دما موضوع صفت حداکثر دما
کنترل دما موضوع صفت دقیقه دما
کنترل دما موضوع صفت انتخاب درجه حرارت
کنترل دما موضوع صفت درجه تنظیم نقطه
اندازه گیری دما موضوع صفت مقدار اندازه گیری شده
ترموستات موضوع فرمان SetpointRaiseLower
ترموستات موضوع صفت activePresetHandle
ترموستات موضوع صفت دمای محلی
ترموستات موضوع صفت اشغال
ترموستات موضوع صفت occupiedCoolingSetpoint
ترموستات موضوع صفت occupiedHeatingSetpoint
ترموستات موضوع صفت دمای بیرون
ترموستات موضوع صفت setpointChangeSource
ترموستات موضوع صفت systemMode
ترموستات موضوع صفت temperatureSetpointHold
ترموستات موضوع صفت temperatureSetpointHoldDuration
ترموستات موضوع صفت ترموستات Running Mode
ترموستات موضوع صفت ترموستات Running State
ترموستات موضوع صفت CoolingSetpoint unoccupied
ترموستات موضوع صفت نقطه تنظیم گرمایش خالی
مجموع فرار ترکیبات آلی غلظت غلظت موضوع صفت سطح ارزش
مجموع فرار ترکیبات آلی غلظت غلظت موضوع صفت مقدار اندازه گیری شده
پوشش پنجره موضوع فرمان DownOrClose
پوشش پنجره موضوع فرمان GoToLiftPercentage
پوشش پنجره موضوع فرمان GoToLiftValue
پوشش پنجره موضوع فرمان GoToTiltPercentage
پوشش پنجره موضوع فرمان GoToTiltValue
پوشش پنجره موضوع فرمان StopMotion
پوشش پنجره موضوع فرمان UpOrOpen
پوشش پنجره موضوع صفت فعلی موقعیت بالا بردن
پوشش پنجره موضوع صفت فعلی PositionLiftPercent100ths
پوشش پنجره موضوع صفت CurrentPositionLiftPercentage
پوشش پنجره موضوع صفت فعلی موقعیت شیب
پوشش پنجره موضوع صفت CurrentPositionTiltPercent100ths
پوشش پنجره موضوع صفت CurrentPositionTiltPercentage
پوشش پنجره موضوع صفت targetPositionLiftPercent100ths
پوشش پنجره موضوع صفت targetPositionTiltPercent100ths
خلع سلاح گوگل فرمان بلوک ArmDisarm
خلع سلاح گوگل رویداد ArmDiarmArmState
خلع سلاح گوگل صفت armState
خلع سلاح گوگل صفت currentArmLevel
خلع سلاح گوگل صفت مسلح است
بارانداز گوگل فرمان بارانداز
بارانداز گوگل صفت متصل است
Doorbell Press گوگل رویداد زنگ در زده شد
ExtendedAirQuality گوگل رویداد کیفیت هوا
ExtendedAirQuality گوگل صفت کیفیت هوای داخلی
ExtendedAirQuality گوگل صفت indoorMeasuredValue
ExtendedAirQuality گوگل صفت مقدار اندازه گیری شده
ExtendedAirQuality گوگل صفت کیفیت هوا در فضای باز
ExtendedAirQuality گوگل صفت outdoorMeasuredValue
ExtendedColorControl گوگل فرمان MoveToColorHSV
ExtendedColorControl گوگل فرمان MoveToColorName
ExtendedColorControl گوگل فرمان MoveToColorRGB
ExtendedColorControl گوگل صفت آبی جاری
ExtendedColorControl گوگل صفت جریان سبز
ExtendedColorControl گوگل صفت CurrentHue
ExtendedColorControl گوگل صفت نام فعلی
ExtendedColorControl گوگل صفت قرمز فعلی
ExtendedColorControl گوگل صفت اشباع جاری
ExtendedColorControl گوگل صفت مقدار فعلی
ExtendedFanControl گوگل فرمان تغییر جهت جریان هوا
ExtendedFanControl گوگل صفت customFanMode
ExtendedFanControl گوگل صفت حالت های سفارشی فن
ExtendedMediaInput گوگل فرمان NextInput
ExtendedMediaInput گوگل فرمان ورودی قبلی
ExtendedMediaInput گوگل فرمان CustomInput را انتخاب کنید
ExtendedMediaInput گوگل صفت CurrentCustomInput
ExtendedMediaInput گوگل صفت customInputsList
ExtendedMediaInput گوگل صفت customInputsOrdered
ExtendedOperationalState گوگل رویداد PauseUnpauseFollowUp
ExtendedOperationalState گوگل رویداد StartStopFollowUp
ExtendedPowerSource گوگل فرمان شروع شارژ
ExtendedPowerSource گوگل فرمان توقف شارژ
ترموستات تمدید شده گوگل صفت activePresetHandle
ترموستات تمدید شده گوگل صفت فعال RemoteTemperatureSensorIds
ترموستات تمدید شده گوگل صفت میانگین دمای محلی
ترموستات تمدید شده گوگل صفت ExtendedRunningMode
ترموستات تمدید شده گوگل صفت ExtendedSystemMode
Light Effects گوگل فرمان PulseEffectSet
Light Effects گوگل فرمان SleepEffectSet
Light Effects گوگل فرمان StopEffect
Light Effects گوگل فرمان WakeEffectSet
Light Effects گوگل صفت pulseEffectSet
Light Effects گوگل صفت sleepEffectSet
Light Effects گوگل صفت wakeEffectSet
قفل باز کردن گوگل فرمان قفل کنید
قفل باز کردن گوگل فرمان بلوک را باز کنید
قفل باز کردن گوگل صفت lockState
تشخیص حرکت گوگل رویداد MotionDetected
تشخیص حرکت گوگل صفت motionDetectionEventInProgress
Object Detection گوگل رویداد ObjectDetected
باز بستن گوگل فرمان بلوک را ببندید
باز بستن گوگل فرمان بلوک GoToOpenPercentage
باز بستن گوگل فرمان بلوک را باز کنید
باز بستن گوگل فرمان بلوک گام
باز بستن گوگل صفت باز درصد
باز بستن گوگل صفت open State
باز بستن گوگل صفت targetOpenPercent
ضبط کنید گوگل فرمان شروع ضبط
ضبط کنید گوگل فرمان توقف ضبط
ضبط کنید گوگل صفت در حال ضبط است
تغییر وضعیت می دهد گوگل فرمان بلوک ChangeToggleSettings
تغییر وضعیت می دهد گوگل صفت currentToggleSettings
روشنایی گوگل فرمان BrightnessStep
روشنایی گوگل فرمان MoveToBrightness
روشنایی گوگل صفت روشنایی فعلی درصد
SimplifiedOnOff گوگل صفت روشن خاموش
ترموستات ساده شده گوگل فرمان SetSystemMode
ترموستات ساده شده گوگل صفت systemMode
حجم گوگل فرمان MoveToVolume
حجم گوگل فرمان بی صدا
حجم گوگل فرمان باصدا کردن
حجم گوگل فرمان VolumeStep
حجم گوگل صفت فعلی حجم درصد
حجم گوگل صفت خاموش است
منطقه حضور دولت گوگل صفت ایالت حضور
AreaPresenceState گوگل صفت حضور دولت