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

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

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

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

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

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

تشغيل Test Suite

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

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

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

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

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

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

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

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

    1. إذا كنت بصدد الحصول على شهادة اعتماد لعملية التكامل Cloud-to-cloud، لا تغيِّر القيمة التلقائية لمهلة "الإبلاغ عن الحالة"/"طلب المزامنة". ومع ذلك، لأغراض الاختبار، يمكنك تغيير قيمة المهلة إذا كان وكيلك يستغرق وقتًا أطول للإبلاغ عن الحالة في قاعدة بيانات Home Graph.

    2. إذا كنت بصدد الحصول على شهادة اعتماد لعملية التكامل Cloud-to-cloud، تأكَّد من تفعيل خيار اختبار "طلب المزامنة" : أثناء الاختبار، سيُطلب منك إضافة جهاز أو تعديله أو إزالته والتحقّق مما إذا كانت قائمة الأجهزة قد تغيّرت في قاعدة بيانات Home Graph. تتم إجراءات التغيير من خلال عملية التكامل التي تختبرها. يجب أن تتضمّن عملية التكامل قيد الاختبار دائمًا جهازًا واحدًا على الأقل مرتبطًا بمستخدم الوكيل.

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

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

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

  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 Bad Request مع {"error": "invalid_grant"} لطلب رمز مميّز غير صالح لإعادة التحميل. إذا لم تتطابق الاستجابة مع "رمز الخطأ أو الرسالة"، سيتعذّر اجتياز حالة الاختبار هذه. يُرجى الانتقال إلى exchange refresh tokens for access tokens لمزيد من المعلومات.
اختبار ما إذا تم تعديل رمز الدخول بعد إعادة تحميل الرمز المميّز يجب عرض رموز دخول جديدة استجابةً لطلبات الرموز المميّزة لإعادة التحميل إذا كان الخادم يعرض رمز الدخول نفسه، سيتعذّر اجتياز حالة الاختبار.
التحقّق مما إذا كان رمز الدخول الذي لم تنتهِ صلاحيته لا يزال صالحًا سيتم عرض وقت انتهاء صلاحية رمز الدخول.
التحقّق مما إذا تم تدوير الرمز المميّز لإعادة التحميل أثناء إعادة التحميل نتحقّق مما إذا تم تغيير الرموز المميّزة لإعادة التحميل بعد طلب رمز مميّز لإعادة التحميل. إذا تغيّر الرمز المميّز لإعادة التحميل، يجب أن يبطل الخادم رمزًا مميّزًا قديمًا لإعادة التحميل بعد استخدام رمز مميّز جديد لإعادة التحميل فقط، وذلك لمنع حالات التنافس التي قد تؤدي إلى إيقاف ربط حساب المستخدم. سيتعذّر اجتياز الاختبار إذا أبطَلت الرمز المميّز القديم لإعادة التحميل قبل استخدام الرمز الجديد.

رسائل الخطأ

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

رسالة الخطأ كيفية الحلّ
لم يتم استخدام HomeGraph API في المشروع <_id_> من قبل أو أنّها غير مفعّلة تأكَّد من تفعيل HomeGraph API.
لم يتم العثور على الكيان المطلوب تأكَّد من أنّ agentUserId صالح ومرتبط بخدمتك.

تأكَّد من حصولك على إذن resourcemanager.projects.get في المشروع ${your project id} ومن منح جميع الأذونات في شاشة الموافقة.

Error getting module data: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. اتّبِع التعليمات الواردة في تحديد مشاكل أذونات إدارة الهوية والوصول وحلّها للتأكّد من أنّ حسابك لديه resourcemanager.projects.get أذونات للمشروع.
  2. انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية لـ "Test suite for smart home":
    • معلومات الحساب الأساسية
      1. الاطّلاع على عنوان البريد الإلكتروني الرئيسي لحسابك على Google
      2. الاطّلاع على معلوماتك الشخصية، بما في ذلك أيّ معلومات شخصية اخترت السماح للجميع بالاطّلاع عليها
    • إمكانية الدخول الإضافي
      1. استخدام Assistant: إمكانية وصول واسعة إلى حسابك على Google
      2. التحقّق من الأجهزة المنزلية الذكية والتحكّم فيها في قاعدة البيانات Home Graph
    إذا ظهر لك خطأ في الأذونات، أزِل إذن الوصول أولاً وامنح جميع الأذونات في شاشة الموافقة عند تسجيل الدخول مرة أخرى.

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

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

لإرسال نتائج الاختبار والحصول على شهادة اعتماد لعملية Cloud-to-cloud التكامل، اتّبِع الخطوات التالية:

  1. بعد تلقّي نتائج الاختبارات والاستعداد للحصول على شهادة اعتماد لعملية التكامل Cloud-to-cloud، انقر على إرسال في الأداة Test Suite.
  2. انتقِل إلى Google Home Developer Console > Cloud-to-cloud > الحصول على الشهادة.
  3. اختَر عملية التكامل التي تريد الحصول على شهادة اعتماد لها.
  4. ضمن الوثائق، أدخِل معرّف نتائج Test Suite.

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