مجموعة أدوات اختبار 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 المحلي إذا كان الجهاز يمكنه معالجة الغرض 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. انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية لـ "مجموعة اختبارات المنزل المزوّد بأجهزة ذكية":
    • معلومات الحساب الأساسية
      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. املأ جميع الحقول المطلوبة، ثم انقر على إرسال.