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

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

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

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

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

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

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

تشغيل Test Suite

اختبار الإجراء بنفسك

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

لاختبار تطبيقك بنفسك، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

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

اختبار التحقّق من صحة الرمز المميز لإعادة التحميل

يتم اختبار رموز التحديث للتأكّد من أنّ نقطة نهاية تبادل الرموز المميزة تبدّلها بشكلٍ سليم برموز دخول جديدة.

عناصر الاختبار الشرح
الرمز المميز لإعادة التحميل غير صالح، ويتم التحقّق من ردّ الشريك. يجب أن يعرض الخادم الخطأ "400: طلب غير صالح" في بروتوكول نقل الروابط النصية (HTTP) مع {"error": "invalid_grant"} لطلب غير صالح لرمز إعادة تحميل مميز. إذا لم تتطابق الاستجابة مع "رمز الخطأ أو الرسالة"، ستفشل حالة الاختبار هذه. يُرجى الانتقال إلى استبدال رموز إعادة التحميل المميزة برموز الدخول للحصول على مزيد من المعلومات.
اختبِر ما إذا تم تعديل رمز الدخول بعد إعادة تحميل الرمز المميز. يجب عرض رموز دخول جديدة استجابةً لطلبات الرمز المميز لإعادة التحميل. وإذا كان الخادم يوفّر رمز الدخول نفسه، ستتعذّر حالة الاختبار.
تحقَّق مما إذا كان رمز الدخول غير المنتهي الصلاحية لا يزال صالحًا. سيتم عرض وقت انتهاء صلاحية رمز الدخول.
تحقَّق مما إذا تم تدوير الرمز المميز لإعادة التحميل أثناء إعادة التحميل. نتحقّق مما إذا تم تغيير الرموز المميزة لإعادة التحميل بعد طلب رمز مميز لإعادة التحميل. في حال تغيّر الرمز المميز لإعادة التحميل، على الخادم إبطال رمز التحديث القديم فقط بعد استخدام الرمز المميز لإعادة التحميل الجديد، وذلك لمنع حدوث حالات تعارض قد تؤدي إلى إيقاف ربط حساب المستخدم. سيفشل الاختبار إذا أبطلت الرمز المميز القديم لإعادة التحميل قبل استخدام الرمز الجديد.

رسائل الخطأ

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

رسالة الخطأ كيفية حلّ المشكلة
لم يتم استخدام 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. املأ جميع الحقول المطلوبة، ثم انقر على إرسال.