تطبيق Google Home Test Suite هو تطبيق ويب يتيح لك إجراء اختبار ذاتي لإجراءك الذكي على المنزل. ينشئ Test Suite تلقائيًا حالات الاختبار ويختبرها استنادًا إلى الأجهزة والسمات المرتبطة بحسابك. عند إكمال الاختبارات، يمكنك عرض نتائج الاختبار أو ملء نموذج الإرسال لإرسال نتائج الاختبار إلى Google.
وتشمل الاختبارات التي يتم تنفيذها من خلال Test Suite، على سبيل المثال لا الحصر، ما يلي:
تأكّد من تنفيذ حالة التقرير وطلب المزامنة للأجهزة والسمات.
التحقّق من تنفيذ هدف QUERY لجهازك ونتائجه التي تتطابق مع نتائج حالة التقرير.
يمكنك تشغيل أداة Test Suite من خلال النقر على الزر أدناه:
اختبار صورتك الذاتية
يوضّح القسم التالي كيفية تنفيذ Test Suite على مشروع العملي على الجهاز الذكي والمنزل. يتطلّب Test Suite عليك تسجيل الدخول للتمكّن من فحص الأجهزة في Google Home Graph وإرسال الأوامر مباشرةً إلى Google Assistant.
لاختبار الإجراء بنفسك، اتّبِع الخطوات التالية:
- في متصفّح الويب، افتح Test Suite.
سجِّل الدخول إلى Google باستخدام الزر في أعلى يسار الصفحة.
اضبط تفاصيل المشروع:
- في الحقل رقم تعريف المشروع، أدخِل معرّف المشروع للإجراء المنزلي الذكي.
- انقر على التالي.
اضبط إعدادات الاختبار:
- في حال مصادقة إجراء المنزل الذكي، اترك قيمة حالة التقرير/مهلة مزامنة الطلب التلقائية بدون تغيير. ومع ذلك، بالنسبة إلى الاختبار، يمكنك تغيير قيمة المهلة إذا استغرق الوكيل مزيدًا من الوقت للإبلاغ عن حالة "الرسم البياني الرئيسي".
إذا كنت تُصدِّق إجراء المنزل الذكي، احرص على تفعيل خيار اختبار طلب المزامنة أثناء الاختبار، سيُطلب منك إضافة جهاز أو تحديثه أو إزالته والتحقق مما إذا كانت قائمة الأجهزة قد تغيّرت في الرسم البياني الرئيسي. تحدث الإجراءات المتعلقة بالتغيير من خلال عملية الدمج التي تختبرها. ويجب أن يكون التكامل مع الاختبار قيد التشغيل دائمًا على جهاز واحد على الأقل متصل بالمستخدم الوكيل.
إذا كنت تستخدم سمة المشهد، اختَر سمة اختبار الشاشة.
إذا كنت تشغِّل حزمة الاختبار للأجهزة المنزلية المحلية، اختَر يتوافق مع حزمة تطوير البرامج المحلية للمنزل.
- اختَر توصيل الطلب المحلي أو الإعداد السلس.
- انقر على يتوافق مع طلب البحث المحلي إذا كان الجهاز يمكنه معالجة هدف QUERY محليًا.
يمكنك تنفيذ إجراء اختبار وعرض النتائج:
- انقر على التالي لبدء إجراء الاختبارات. تعرض الواجهة الأجهزة والسمات التي يتم اختبارها.
الاطّلاع على صفحة النتائج وإرسال المحتوى:
- بعد اكتمال الاختبارات، انقر على التالي لعرض النتائج.
تشمل نتائج الاختبار عدد الاختبارات التي تم اجتيازها وتعذّر إتمامها، بالإضافة إلى نتيجة نهائية تشير إلى النسبة المئوية للاختبارات.
اختبار التحقّق من ربط الحساب
يؤدي ربط الحساب دورًا مهمًا في منظومة Google الذكية للمنزل. يتحقّق اختبار التحقّق من ربط الحسابات في Test Suite من خدمة OAuth بحثًا عن أي مشاكل محتملة.
يحتوي اختبار التحقق من ربط الحسابات على اختبارات للتحقّق من صحة رموز الدخول وإعادة تحميل الرموز المميَّزة:
اختبار التحقق من رمز الدخول
يتم اختبار رموز الدخول التي يتم عرضها من نقطة نهاية تبادل الرموز المميّزة للتأكّد من أنها بتنسيق صالح ويتم عرضها باستخدام رمز مميّز صالح لإعادة التحميل.
| عناصر الاختبار | الشرح |
|---|---|
| التحقّق مما إذا كان رمز الدخول بتنسيق JWT | لا تنصح ميزة الربط بحساب Google باستخدام رموز الدخول المميّزة بتنسيق JWT. في حال العثور على تنسيق JWT، سيظهر التحذير التالي: The access token seems to be JWT, this is not good. Because it
unnecessarily exposes information about partner implementation and we
recommend opaque symmetric encrypted access token.
|
| يُرجى التحقّق من أنّ رمز الدخول الذي يتضمّن تاريخ انتهاء صلاحية يتضمن رمزًا مميّزًا لإعادة التحميل. | يجب تقديم رمز مميّز لإعادة التحميل عندما تنتهي صلاحية رمز الدخول. سيتعذّر إجراء هذا الاختبار في حال عدم العثور على الرمز المميّز لإعادة التحميل. |
إعادة تحميل اختبار التحقّق من صحة الرمز المميّز
يتم اختبار الرموز المميّزة لإعادة التحميل للتأكّد من أنّ نقطة نهاية تبادل الرموز المميّزة تعمل بشكل صحيح على استبدالها برموز دخول جديدة.
| عناصر الاختبار | الشرح |
|---|---|
| جارٍ إعادة تحميل الرمز المميّز برمز غير صالح لإعادة التحميل، جارٍ التحقّق من استجابة الشريك. | من المفترض أن يعرض الخادم خطأ في طلب HTTP 400 غير صالح في {"error": "invalid_grant"} للإشارة إلى طلب غير صالح لإعادة تحميل الرمز المميّز.
إذا لم يتطابق الرد مع "رمز الخطأ أو الرسالة"، لن تنجح حالة الاختبار هذه. يُرجى الانتقال إلى
"استبدال رموز الدخول المميّزة" برموز الدخول للحصول على مزيد من المعلومات. |
| يمكنك اختبار ما إذا تم تعديل رمز الدخول بعد إعادة تحميل الرمز المميّز. | يجب عرض رموز الدخول الجديدة استجابةً لطلبات إعادة تحميل الرموز المميّزة. إذا كان الخادم يوفّر رمز الدخول نفسه، لن تنجح حالة الاختبار. |
| تأكَّد من أنّ رمز الدخول غير المنتهية الصلاحية لا يزال صالحًا. | سيتم عرض وقت انتهاء صلاحية رمز الدخول. |
| تحقَّق من استبدال الرمز المميّز لإعادة التحميل أثناء إعادة التحميل. | نتحقّق مما إذا كان قد تم تغيير الرموز المميّزة لإعادة التحميل بعد طلب الرمز المميّز لإعادة التحميل. في حال تغيير الرمز المميّز لإعادة التحميل، من المفترض أن يلغي الخادم رمزًا مميّزًا لعملية إعادة التحميل القديمة بعد استخدام الرمز المميّز الجديد لإعادة التحميل، وذلك لمنع حدوث شروط السباق التي قد تؤدي إلى إيقاف ربط حساب المستخدم. وسيتعذّر الاختبار إذا ألغيت صلاحية الرمز المميّز القديم لإعادة التحميل قبل استخدام الرمز الجديد. |
رسائل الخطأ
يسرد الجدول التالي بعض رسائل الخطأ الشائعة التي قد تظهر لك والطريقة المقترحة لحلّها.
| رسالة الخطأ | كيفية الحلّ |
|---|---|
| لم يتم استخدام واجهة GraphGraph API في المشروع <_id_> قبل أو تم إيقافه | تأكّد من تفعيل HomeGraph API. |
| تعذّر العثور على الكيان المطلوب | تأكَّد من أنّ agentUserId صالح ومرتبط بخدمتك. |
تأكَّد من الحصول على إذن حدث خطأ أثناء الحصول على بيانات الوحدة: خطأ getUnitData: تعذُّر استجابة Http لـ https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
إرسال نتائج الاختبار
يجب أن تجتاز نتائج Test Suite نسبة 100% من الاختبارات قبل إرسال نموذج الشهادة. إذا كانت لديك أي سمات تتطلّب الاختبار اليدوي، يجب تشغيل أداة Test Suite وإرفاق النتيجة حتى إذا لم يتم اجتيازها بنسبة %100.
لإرسال نتائج الاختبار والموافقة على إجراء المنزل الذكي، اتّبِع الخطوات التالية:
- بعد تلقّي نتائج الاختبار واستعدادك لمصادقة إجراء المنزل المزوّد بأجهزة ذكية، انقر على إرسال في أداة Test Suite.
- انقر على الزر تنزيل نتائج الاختبار لاسترداد نتائج الاختبار.
- انقر على الانتقال إلى نموذج الإرسال لإرسال نتائج الاختبار إلى Google.
املأ جميع الحقول المطلوبة، ثم انقر على إرسال.