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

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

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

    4. إذا كنت تشغّل مجموعة الاختبار لأجهزة Home Home، اختَر إتاحة حزمة تطوير البرامج (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 Bad Request مع {"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
  1. اتّبِع التعليمات الواردة في تحديد المشاكل وحلّها. أذونات "إدارة الهوية وإمكانية الوصول" للتأكُّد من أنّ حسابك يتضمّن أذونات resourcemanager.projects.get للمشروع.
  2. انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية لـ "مجموعة اختبار للمنزل المزوّد بأجهزة ذكية":
    • معلومات الحساب الأساسية
      1. الاطّلاع على عنوان البريد الإلكتروني الرئيسي لحسابك على Google
      2. الاطّلاع على معلوماتك الشخصية، بما في ذلك أي معلومات شخصية نقلتها جعله متاحًا للجميع
    • إذن الوصول الإضافي
      1. استخدام Assistant: الوصول الواسع النطاق إلى حسابك على Google
      2. فحص الأجهزة المنزلية الذكية في منزلك والتحكّم فيها رسم بياني
    إذا ظهر لك خطأ في إذن الوصول، عليك إزالة إذن الوصول أولاً ومنح جميع الأذونات في شاشة طلب الموافقة عند تسجيل الدخول مرة أخرى.

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

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

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

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

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