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

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

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

تشمل الاختبارات التي يتم إجراؤها من خلال Test Suite، ولكن لا على ما يلي:

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

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

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

إطلاق Test Suite

إجراء اختبار ذاتي لـ Action

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

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

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

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

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

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

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

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

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

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

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

رسائل الخطأ

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

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