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

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

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

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

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

ملاحظة مهمة: إذا كان الإجراء الخاص بك يستخدم التحقّق الثانوي من المستخدم أو سمات معينة، مثل CameraStream أو Locator أو RunCycle أو سمات خاضعة للقيادة فقط مثل Channel، قد نطلب منك شحن جهازك المنزلي الذكي إلى Google لإجراء اختبار يدوي.

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

إطلاق Test Suite

الاختبار الذاتي للإجراء الخاص بك

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

ملاحظة: السماح بالنوافذ المنبثقة لصفحة Test Suite. في حال عدم السماح بالنوافذ المنبثقة، قد لا يظهر زر المساعدة.

لإجراء اختبار ذاتي للإجراء، يُرجى اتّباع الخطوات التالية:

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

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

   ملاحظة: يُرجى التأكّد من تسجيل الدخول باستخدام حساب مرتبط بمشروع إجراءات المنزل المزوّد بأجهزة ذكية الذي تريد اختباره.

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

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

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

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

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

      تحذير: عند إزالة جهاز، يجب التأكّد من تنفيذ هذا الإجراء من تطبيقك التابع لجهة خارجية (وليس من Google Home app (GHA)). يُرجى عدم إزالة الجهاز إذا كان هناك جهاز واحد فقط في تطبيقك مرتبط بالحساب، لأنّ ذلك سيؤدي إلى حدوث خطأ في المزامنة.

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

      ملاحظة: إذا كنت تريد اختبار السمات باستخدام التحقّق الثانوي من المستخدم، حدِّد الخيار تفعيل عملية التحقُّق الثانوي من المستخدِم في صفحة إعدادات الاختبار. عند تمكين هذا الإعداد، سيطالبك تطبيق الاختبار بما إذا كان الجهاز يستجيب لتحدٍ أثناء الاختبار. هذا الخيار هو فقط لمساعدتك في إكمال الاختبار الذاتي. لا يزال يجب إرسال الأجهزة التي تستخدم عملية إثبات هوية المستخدم الثانوي إلى Google لإجراء التحقق اليدوي.

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

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

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

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

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

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

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

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

يؤدي ربط الحسابات دورًا مهمًا في المنظومة المتكاملة للمنزل المزوّد بأجهزة ذكية من Google. يتحقّق اختبار التحقق من ربط الحسابات في Test Suite في خدمة OAuth بحثًا عن أي مشاكل محتمَلة.

يحتوي اختبار التحقق من ربط الحساب على اختبارات للتحقق من صحة رموز الدخول والرموز المميزة لإعادة التحميل:

اختبار التحقّق من صحة رمز الدخول

يتم اختبار رموز الدخول التي يتم عرضها من نقطة نهاية تبادل الرموز المميزة للتأكّد من أنّ تنسيقها صالح ويتم عرضها باستخدام رمز مميّز صالح لإعادة التحميل.

عناصر الاختبار	الشرح
التحقّق مما إذا كان رمز الدخول بتنسيق JWT	لا ننصح باستخدام رموز الدخول بتنسيق JWT عند ربط حساب Google. وفي حال العثور على تنسيق 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 فحص الأجهزة المنزلية الذكية والتحكّم فيها في قاعدة البيانات Home Graph إذا ظهر لك خطأ متعلق بالإذن، عليك إزالة إذن الوصول أولاً ومنح جميع الأذونات التي تظهر في شاشة طلب الموافقة عند تسجيل الدخول مرة أخرى.

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

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

ملاحظة: ليس كل الحقول المطلوبة، مثل نتائج Test Suite، متاحة للتحميل في وحدة التحكّم. يجب أن يقترن ما ترسله بطلب شهادة من أجل مواصلة عملية الاعتماد وإصدار شهادة.

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

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

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

   ملاحظة: يجب أن تتضمّن نتائج الاختبار التي ترسلها نتائج اختبار "طلب المزامنة". بعد إرسال نتائج الاختبار إلى Google، عليك إرسال إجراء المنزل المزوّد بأجهزة ذكية للمراجعة.