اكتملت عملية نقل البيانات إلى "مركز مطوّري Google Home".

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

تشغيل Test Suite

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

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

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

في متصفّح الويب، افتح الـ Test Suite.
سجِّل الدخول إلى Google باستخدام الزر في أعلى يسار الصفحة.

**ملاحظة مُهمّة:** تأكَّد من تسجيل الدخول باستخدام حساب مرتبط بـ عملية التكامل Cloud-to-cloud التي تريد اختبارها.
اضبط تفاصيل المشروع:
1. في حقل رقم تعريف المشروع، أدخِل معرّف مشروع إجراء المنزل المزوّد بأجهزة ذكية.
2. انقر على التالي.
اضبط إعدادات الاختبار:
1. إذا كنت بصدد الحصول على شهادة اعتماد لعملية التكامل Cloud-to-cloud، اترك القيمة التلقائية لمهلة "الإبلاغ عن الحالة"/"طلب المزامنة" بدون تغيير. ومع ذلك، لأغراض الاختبار، يمكنك تغيير قيمة المهلة إذا كان وكيلك يستغرق وقتًا أطول للإبلاغ عن الحالة إلى Home Graph.
2. إذا كنت بصدد الحصول على شهادة اعتماد لعملية التكامل Cloud-to-cloud، تأكَّد من تفعيل خيار اختبار "طلب المزامنة" : أثناء الاختبار، سيُطلب منك إضافة جهاز أو تعديله أو إزالته والتحقّق مما إذا كانت قائمة الأجهزة قد تغيّرت في Home Graph. تتم إجراءات التغيير من خلال عملية التكامل التي تختبرها. يجب أن تتضمّن عملية التكامل قيد الاختبار دائمًا جهازًا واحدًا على الأقل مرتبطًا بمستخدم الوكيل.
  
  تحذير: عند إزالة جهاز، تأكَّد من إجراء ذلك من تطبيقك التابع لجهة خارجية (وليس من Google Home app (GHA)). لا تُزِل الجهاز إذا كان هناك جهاز واحد فقط في تطبيقك مرتبطًا بالحساب، لأنّ ذلك سيؤدي إلى حدوث خطأ في المزامنة.
3. إذا كنت تستخدم سمة Scene، انقر على اختبار سمة "مشهد".
  
  ملاحظة: إذا أردت اختبار سمات باستخدام إجراء ثانوي لإثبات هوية المستخدم، انقر على خيار تفعيل إجراء ثانوي لإثبات هوية المستخدم في صفحة إعدادات الاختبار. عند تفعيل هذا الإعداد، يطلب منك تطبيق الاختبار ما إذا كان الجهاز يستجيب بتحدٍّ أثناء الاختبار. هذا الخيار مخصّص لمساعدتك في إكمال الاختبار الذاتي فقط. يجب مع ذلك إرسال الأجهزة التي تستخدم ميزة "التحقّق من هوية المستخدم الثانوي" إلى Google لإجراء عملية التحقّق اليدوي.
4. إذا كنت تُجري مجموعة الاختبارات لأجهزة Local Home، انقر على تتوفّر حزمة Local Home SDK.
  1. انقر على التنفيذ المحلي أو الإعداد السلس.
  2. انقر على يتوافق مع طلب البحث المحلي إذا كان الجهاز يمكنه التعامل مع الغرض QUERY محليًا.
نفِّذ اختبارًا واطّلِع على النتائج:
1. انقر على التالي لبدء تنفيذ الاختبارات. تعرض الواجهة الأجهزة والسمات التي يتم اختبارها.
اطّلِع على صفحة النتائج والإرسال:
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"}` لطلب الرمز المميز لإعادة التحميل غير الصالح. إذا لم تتطابق الاستجابة مع "رمز الخطأ أو الرسالة"، ستفشل حالة الاختبار هذه. يُرجى الانتقال إلى exchange refresh tokens for access tokens لمزيد من المعلومات.
اختبار ما إذا تم تعديل رمز الدخول بعد إعادة تحميل الرمز	يجب عرض رموز دخول جديدة استجابةً لطلبات الرموز المميزة لإعادة التحميل. إذا كان الخادم يعرض رمز الدخول نفسه، ستفشل حالة الاختبار.
التحقّق مما إذا كان رمز الدخول الذي لم تنتهِ صلاحيته لا يزال صالحًا	سيتم عرض وقت انتهاء صلاحية رمز الدخول.
التحقّق مما إذا تم تدوير الرمز المميز لإعادة التحميل أثناء إعادة التحميل	نتحقّق مما إذا تم تغيير الرموز المميزة لإعادة التحميل بعد طلب الرمز المميز لإعادة التحميل. إذا تغيّر الرمز المميز لإعادة التحميل، يجب أن يبطل الخادم الرمز المميز القديم لإعادة التحميل فقط بعد استخدام رمز مميز جديد لإعادة التحميل، وذلك لمنع حالات التنافس التي قد تؤدي إلى إيقاف ربط حساب المستخدم. سيفشل الاختبار إذا أبطَلت الرمز المميز لإعادة التحميل القديم قبل استخدام الرمز الجديد.

رسائل الخطأ

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

رسالة الخطأ كيفية الحلّ

لم يتم استخدام HomeGraph API في المشروع <_id_> من قبل أو أنّها غير مفعّلة تأكَّد من تفعيل HomeGraph API.

لم يتم العثور على الكيان المطلوب تأكَّد من أنّ agentUserId صالح ومرتبط بخدمتك.

رسالة الخطأ	كيفية الحلّ
لم يتم استخدام HomeGraph API في المشروع <_id_> من قبل أو أنّها غير مفعّلة	تأكَّد من تفعيل HomeGraph API.
لم يتم العثور على الكيان المطلوب	تأكَّد من أنّ `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	اتّبِع التعليمات الواردة في تحديد مشاكل أذونات إدارة الهوية وإمكانية الوصول وحلّها للتأكّد من أنّ حسابك لديه `resourcemanager.projects.get` أذونات للمشروع. انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية لـ "Test suite for منزل مزوّد بأجهزة ذكية": معلومات الحساب الأساسية الاطّلاع على عنوان البريد الإلكتروني الرئيسي لحسابك على Google الاطّلاع على معلوماتك الشخصية، بما في ذلك أيّ معلومات شخصية اخترت السماح للجميع بالاطّلاع عليها إمكانية الدخول الإضافي استخدام Assistant: لإمكانية وصول واسع النطاق لحسابك في Google التحقّق من الأجهزة المنزلية الذكية والتحكّم فيها في قاعدة بيانات Home Graph إذا ظهر لك خطأ في الأذونات، أزِل إذن الوصول أولاً وامنح جميع الأذونات في شاشة طلب الموافقة عند تسجيل الدخول مرة أخرى.

تأكَّد من حصولك على إذن 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

اتّبِع التعليمات الواردة في تحديد مشاكل أذونات إدارة الهوية وإمكانية الوصول وحلّها للتأكّد من أنّ حسابك لديه resourcemanager.projects.get أذونات للمشروع.
انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية لـ "Test suite for منزل مزوّد بأجهزة ذكية":
- معلومات الحساب الأساسية
  1. الاطّلاع على عنوان البريد الإلكتروني الرئيسي لحسابك على Google
  2. الاطّلاع على معلوماتك الشخصية، بما في ذلك أيّ معلومات شخصية اخترت السماح للجميع بالاطّلاع عليها
- إمكانية الدخول الإضافي
  1. استخدام Assistant: لإمكانية وصول واسع النطاق لحسابك في Google
  2. التحقّق من الأجهزة المنزلية الذكية والتحكّم فيها في قاعدة بيانات Home Graph
إذا ظهر لك خطأ في الأذونات، أزِل إذن الوصول أولاً وامنح جميع الأذونات في شاشة طلب الموافقة عند تسجيل الدخول مرة أخرى.

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

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

لإرسال نتائج الاختبار والحصول على شهادة اعتماد لعملية Cloud-to-cloud التكامل، يُرجى اتّباع الخطوات التالية:

بعد تلقّي نتائج الاختبارات والاستعداد للحصول على شهادة اعتماد لعملية التكامل Cloud-to-cloud، انقر على إرسال في الأداة Test Suite.
انتقِل إلى Google Home Developer Console > Cloud-to-cloud > الحصول على شهادة الاعتماد.
اختَر عملية التكامل التي تريد الحصول على شهادة اعتماد لها.
ضمن الوثائق، أدخِل معرّف نتائج Test Suite.
املأ جميع الحقول المطلوبة، ثم انقر على إرسال.

ملاحظة: يجب أن تتضمّن نتائج الاختبار التي تُرسلها نتائج اختبار "طلب المزامنة" . بعد إرسال نتائج الاختبار إلى Google، عليك إرسال Cloud-to-cloud عملية التكامل للمراجعة.