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

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

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

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

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

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

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

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

تشغيل Test Suite

اختبار تطبيقك

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

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

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

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

  3. تكوين تفاصيل المشروع:

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

اختبار التحقق من رمز التحديث

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

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

رسائل الخطأ

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

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