مجموعة أدوات اختبار Google Home

السحابة الإلكترونية إلى السحابة الإلكترونية    حزمة تطوير البرامج للمنزل المحلي

Google Home Test Suite هو تطبيق ويب يتيح لك إجراء اختبار ذاتي لتنفيذ الإجراءات المنزلية الذكية. تعمل ميزة Test Suite على إنشاء حالات الاختبار وتنفيذها تلقائيًا استنادًا إلى الأجهزة والسمات المرتبطة بحسابك. عند إكمال الاختبارات، يمكنك الاطلاع على نتائج الاختبار أو ملء نموذج الإرسال لإرسال نتائج الاختبار إلى Google.

تتضمّن الاختبارات التي يتم تنفيذها من خلال Test Suite، على سبيل المثال لا الحصر، ما يلي:

• يتحقّق من تنفيذ حالة التقرير وطلب المزامنة على أجهزتك وسماتك.

• للتحقق من تنفيذ هدف QUERY على جهازك وأن نتائجه تتطابق مع نتائج "حالة التقرير".

يمكنك تشغيل أداة Test Suite من خلال النقر على الزر أدناه:

إطلاق Test Suite

إجراء اختبار ذاتي لـ Action

يصف القسم التالي طريقة تشغيل Test Suite على جهازك ومشروع الإجراء الخاص بالمنزل المزوّد بأجهزة ذكية. يتطلّب "Test Suite" تسجيل الدخول لفحص الأجهزة في "Google Home Graph" وإرسال الطلبات مباشرةً إلى "Google Assistant".

لإجراء اختبار ذاتي لـ Action الخاص بك، اتبع الخطوات التالية:

1. في متصفّح الويب، افتح Test Suite.

2. سجّل الدخول إلى Google باستخدام الزر في أعلى يسار الشاشة.

3. اضبط تفاصيل المشروع:

   1. في حقل رقم تعريف المشروع، أدخِل معرِّف المشروع الخاص بإجراء المنزل المزوّد بأجهزة ذكية.
   2. انقر على التالي.

4. ضبط إعدادات الاختبار:

   1. في حال اعتماد إجراء المنزل المزوّد بأجهزة ذكية، اترك القيمة التلقائية الإبلاغ عن حالة/مهلة طلب المزامنة بدون تغيير. ومع ذلك، لأغراض الاختبار، يمكنك تغيير قيمة المهلة إذا استغرق وكيلك وقتًا أطول لإبلاغ Google Home Graph.

   2. عند اعتماد الإجراء الخاص بمنزلك المزوّد بأجهزة ذكية، احرص على تفعيل خيار اختبار طلب المزامنة. وأثناء الاختبار، سيُطلب منك إضافة جهاز أو تحديثه أو إزالته والتحقق مما إذا كانت قائمة الأجهزة قد تغيّرت في الرسم البياني المنزلي. تحدث إجراءات التغيير من خلال التكامل الذي تختبره. يجب أن يتضمن الدمج قيد الاختبار دائمًا جهازًا واحدًا على الأقل مرفقًا بمستخدم الوكيل.

   3. إذا كنت تستخدم سمة Scene، اختَر سمة "مشهد الاختبار".

   4. إذا كنت تشغّل حزمة اختبار الأجهزة المنزلية المحلية، اختَر تتوافق مع حزمة تطوير البرامج (SDK) الخاصة بالمنازل المحلية.

      1. اختَر توصيل الطلبات على الجهاز أو الإعداد السلس.
      2. انقر على إتاحة الاستعلام المحلي إذا كان الجهاز يمكنه معالجة طلب البحث محليًا.

5. نفِّذ تشغيل اختباري واعرض النتائج:

   1. انقر على التالي لبدء إجراء الاختبارات. تعرض الواجهة الأجهزة والسمات التي يتم اختبارها.

6. الاطّلاع على صفحة النتائج والإرسال:

   1. بعد اكتمال الاختبارات، انقر على التالي لعرض النتائج.

تتضمن نتائج الاختبار عدد الاختبارات التي تم اجتيازها والفشل، ودرجة نهائية تشير إلى النسبة المئوية للاجتيازات.

اختبار التحقّق من ربط الحسابات

يؤدي ربط الحسابات دورًا مهمًا في المنظومة المتكاملة للمنازل المزوّدة بأجهزة ذكية في 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"} إلى طلب رمز مميّز غير صالح لإعادة التحميل. إذا لم يتطابق الردّ مع "رمز الخطأ أو الرسالة"، لن تنجح حالة الاختبار هذه. لمزيد من المعلومات، يمكنك الانتقال إلى رموز إعادة التحميل المميّزة لرموز الدخول.
يمكنك اختبار ما إذا كان قد تم تعديل رمز الدخول بعد إعادة تحميل الرمز المميّز.	يجب عرض رموز الدخول الجديدة استجابةً لطلبات الرمز المميّز لإعادة التحميل. إذا كان الخادم يوفّر رمز الدخول نفسه، لن تنجح حالة الاختبار.
تحقَّق مما إذا كان رمز الدخول غير منتهي الصلاحية لا يزال صالحًا.	سيتم عرض وقت انتهاء صلاحية رمز الدخول.
تحقَّق مما إذا تم تغيير الرمز المميّز لإعادة التحميل أثناء عملية إعادة التحميل.	نتحقق مما إذا كانت الرموز المميّزة للتحديث قد تغيّرت بعد طلب الرمز المميّز لإعادة التحميل. وإذا تغيّر الرمز المميّز لإعادة التحميل، يجب أن يوقف الخادم الرمز المميّز القديم لإعادة التحميل فقط بعد استخدام رمز مميّز جديد لإعادة التحميل، وذلك لمنع شروط السباق التي قد تؤدي إلى إيقاف ربط حساب المستخدم. ولن ينجح الاختبار في حال إلغاء صلاحية الرمز المميّز القديم لإعادة التحميل قبل استخدام الرمز الجديد.

رسائل الخطأ

يسرد الجدول التالي بعض رسائل الخطأ الشائعة التي قد تظهر لك والطريقة المقترحة لحلها.

رسالة الخطأ	كيفية الحل
لم يتم استخدام HomeGraph API في المشروع <_id_> قبل إيقافه أو إيقافه	تأكَّد من تفعيل HomeGraph API.
تعذّر العثور على الكيان المطلوب	تأكَّد من أنّ agentUserId صالح ومرتبط بخدمتك.
تأكَّد من أنّ لديك إذن "resourcemanager.projects.get" في المشروع "${your project id}" ومن منح جميع الأذونات في شاشة الموافقة. حدث خطأ أثناء الحصول على بيانات الوحدة: خطأ getModuleData: استجابة فشل Http لـ https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	اتّبِع التعليمات الواردة في تحديد المشاكل وحلّها في أذونات "إدارة الهوية وإمكانية الوصول" للتأكّد من أنّ حسابك يتضمّن أذونات resourcemanager.projects.get للمشروع. انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية المتعلّقة بـ "مجموعة اختبارية للمنزل المزوّد بأجهزة ذكية": معلومات الحساب الأساسية الاطّلاع على عنوان البريد الإلكتروني الرئيسي لحسابك على Google الاطّلاع على معلوماتك الشخصية، بما في ذلك أي معلومات شخصية اخترت أن تكون متاحة للجميع أذونات الوصول الإضافية استخدام Assistant: وصول واسع النطاق إلى حسابك على Google فحص الأجهزة المنزلية الذكية والتحكّم فيها في الرسم البياني للمنزل إذا ظهر لك خطأ متعلق بالإذن، عليك إزالة إذن الوصول أولاً ومنح جميع الأذونات في شاشة الموافقة عند تسجيل الدخول مرة أخرى.

إرسال نتائج الاختبار

يجب أن تجتاز نتائج Test Suite% 100 من الاختبارات قبل إرسال نموذج الشهادة. إذا كانت لديك أي سمات تتطلب اختبارًا يدويًا، لا يزال بإمكانك تشغيل أداة Test Suite وإرفاق النتيجة حتى إذا لم يتم اجتيازها بنسبة %100.

لإرسال نتائج الاختبار واعتماد إجراء المنزل المزوّد بأجهزة ذكية، اتّبِع الخطوات التالية:

1. بعد تلقّي نتائج الاختبار واستعدادك لاعتماد الإجراء الخاص بمنزلك المزوّد بأجهزة ذكية، انقر على إرسال في أداة Test Suite.
2. انقر على زر تنزيل نتائج الاختبار لاسترداد نتائج الاختبار.
3. انقر على الانتقال إلى نموذج الإرسال لإرسال نتائج الاختبار إلى Google.

4. املأ كل الحقول المطلوبة، ثمّ انقر على إرسال.