تتوافق Automation API مع معظم السمات، ولكن قد يكون توافقها مع بعض السمات والأحداث والأوامر في السمة محدودًا.
للتأكّد من أنّ Automation API متوافقة مع حالة الاستخدام، ابحث في الجدول أدناه.
وبوجه عام:
- يجب تسجيل أي سمات وأنواع تريد استخدامها في تطبيقك مع واجهة برمجة التطبيقات Automation API عند بدء التشغيل. راجِع مقالة إنشاء مثيل Home.
- يمكن استخدام أيّ سمة في العناصر الأساسية أو الشروط.
- لا يمكن استخدام Cloud-to-cloud جهاز لا يُبلغ عن حالته كعامل تشغيل في عمليات التشغيل الآلي التي تم إنشاؤها يدويًا أو من خلال الاستكشاف.
- حتى إذا كان الجهاز متوافقًا مع السمات المدرَجة هنا، قد يتم
حظره من الاستخدام كإجراء تفعيل أو إجراء في Automation API بسببعدم استيفاء الحد الأدنى لجودة حالة التقرير:
- يتم حظر استخدام الأجهزة التي تقلّ فيها نسبة نجاح إعداد تقارير الحالة عن% 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.
- لاستخدام
تتوفّر أيضًا إصدارات مبسّطة لبعض السمات لاستخدامها في عمليات التشغيل الآلي. لمزيد من المعلومات، يمكنك الاطّلاع على السمات المبسّطة.
يشير المربّع إلى أنّ الطلب غير متوافق مع عمليات التشغيل الآلي لنوع واحد أو أكثر من أنواع الأجهزة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الإجراءات المحظورة في الإجراءات المبرمَجة.