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

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

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

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

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

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

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

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

  1. بعد تلقّي نتائج الاختبار واستعدادك لاعتماد عملية دمج Cloud-to-cloud، انقر على إرسال في أداة Test Suite.
  2. انقر على الزر تنزيل نتائج الاختبار لاسترداد نتائج الاختبار.
  3. انقر على الانتقال إلى نموذج الإرسال لإرسال نتائج الاختبار إلى Google.

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