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

Cloud-to-cloud    حزمة SDK المحلية للمنزل

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

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

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

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

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

إطلاق Test Suite

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

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

لإجراء اختبار ذاتي للإجراء الخاص بك، يُرجى اتّباع الخطوات التالية:

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

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

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

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

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

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

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

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

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

رسائل الخطأ

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

رسالة الخطأ كيفية الحل
لم يتم استخدام واجهة برمجة التطبيقات HomeGraph في المشروع <_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.

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

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

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