تستخدم Home APIs بروتوكول OAuth 2.0 لمنح إذن الوصول إلى الأجهزة في البنية. يسمح بروتوكول OAuth للمستخدم بمنح الإذن لتطبيق أو خدمة بدون الحاجة إلى الكشف عن بيانات تسجيل الدخول.
إذا كان لديك عميل OAuth تم التحقّق منه (على سبيل المثال، من تطبيق منشور)، يمكنك استخدام هذا العميل لاختبار Home APIs بدون إعداد عميل جديد. لمزيد من المعلومات، يُرجى الاطّلاع على قسم إذا كان لديك عميل OAuth حالي.
توقيع التطبيق
أولاً، أنشئ شهادة تصحيح الأخطاء عن طريق تشغيل تطبيقك في Android Studio. عند تشغيل تطبيق أو تصحيح أخطائه في Android Studio، يتم تلقائيًا إنشاء شهادة تصحيح أخطاء مخصّصة للتطوير و تصحيح الأخطاء. للحصول على شرح كامل، يُرجى الاطّلاع على مقالة استوديو Android: توقيع إصدار تصحيح الأخطاء .
بعد تشغيل التطبيق:
وصِّل جهازك الجوّال بجهاز الكمبيوتر المحلي. Android Studio سيعرض الأجهزة المتصلة حسب رقم الطراز. اختَر جهازك من القائمة، ثم انقر على تشغيل المشروع. يؤدي ذلك إلى إنشاء "التطبيق النموذجي" وتثبيته على جهازك الجوّال.
للحصول على تعليمات أكثر تفصيلاً، يُرجى الاطّلاع على مقالة تشغيل التطبيقات على جهاز مادي على الموقع الإلكتروني لمطوّري تطبيقات Android.
أوقِف التطبيق قيد التشغيل.
احصل على الملف المرجعي SHA-1 لشهادة تصحيح الأخطاء باتّباع التعليمات المفصّلة في مقالة إعداد OAuth 2.0 / التطبيقات الأصلية / Android على الموقع الإلكتروني لمساعدة Google Cloud Console.
إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- في Google Cloud Console، انتقِل إلى لوحة بيانات أداة اختيار المشاريع واختَر المشروع الذي تريد استخدامه لإنشاء بيانات اعتماد OAuth.
- انتقِل إلى صفحة واجهات برمجة التطبيقات والخدمات ، وانقر على بيانات الاعتماد في قائمة التنقّل.
إذا لم تكن قد ضبطت شاشة طلب الموافقة لمشروع Google Cloud هذا، سيظهر الزر ضبط شاشة طلب الموافقة. في هذه الحالة، اضبط شاشة طلب الموافقة باستخدام الإجراء التالي. بخلاف ذلك، انتقِل إلى القسم التالي.
- انقر على ضبط شاشة طلب الموافقة. تظهر صفحة شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- اختَر داخلي أو خارجي، حسب حالة الاستخدام، ثم انقر على إنشاء. تظهر لوحة شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- أدخِل المعلومات في صفحة معلومات التطبيق وفقًا للتعليمات التي تظهر على الشاشة، ثم انقر على حفظ ومتابعة. تظهر لوحة النطاقات.
- لست بحاجة إلى إضافة أي نطاقات، لذا انقر على حفظ ومتابعة. تظهر لوحة المستخدمون الذين سيجرون الاختبار.
- انقر على الجمهور ، ثم انقر على الزر + إضافة مستخدمين.
- أدخِل عنوان البريد الإلكتروني للمستخدم الاختباري وانقر على الزر حفظ.
- انقر على حفظ ومتابعة. تظهر لوحة الملخّص.
- راجِع معلومات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، ثم انقر على الرجوع إلى لوحة البيانات.
لمعرفة التفاصيل الكاملة، يُرجى الاطّلاع على مقالة إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth على الموقع الإلكتروني لمساعدة Google Cloud Console.
تسجيل التطبيق وإنشاء بيانات الاعتماد
لتسجيل التطبيق في OAuth 2.0 وإنشاء بيانات اعتماد OAuth، اتّبِع الـ تعليمات الواردة في إعداد OAuth 2.0. عليك تحديد نوع التطبيق، وهو تطبيق أصلي/تطبيق Android.
أضِف الملف المرجعي SHA-1 الذي حصلت عليه من توقيع التطبيق إلى عميل OAuth الذي أعددته على Google Cloud Console باتّباع التعليمات الواردة في إعداد OAuth 2.0 / التطبيقات الأصلية على الموقع الإلكتروني لمساعدة Google Cloud Console.
بعد توصيل جهازك الجوّال بجهاز الكمبيوتر المحلي، اختَر جهازك من القائمة، ثم انقر على تشغيل المشروع مرة أخرى لتشغيله. للحصول على تعليمات أكثر تفصيلاً، يُرجى الاطّلاع على مقالة تشغيل التطبيقات على جهاز مادي على الموقع الإلكتروني لمطوّري تطبيقات Android.
إذا كان لديك عميل OAuth حالي
إذا كان لديك عميل OAuth تم التحقّق منه لتطبيق منشور، يمكنك استخدام عميل OAuth الحالي لاختبار Home APIs.
ليس مطلوبًا التسجيل في Google Home Developer Console لاختبار Home APIs واستخدامها. ومع ذلك، سيظل عليك الحصول على تسجيل معتمَد Developer Console لنشر تطبيقك، حتى إذا كان لديك عميل OAuth تم التحقّق منه من عملية دمج أخرى.
تنطبق الاعتبارات التالية:
يتم فرض حد أقصى يبلغ 100 مستخدم عند استخدام عميل OAuth حالي. للحصول على معلومات حول إضافة مستخدمين سيُجرون الاختبار، يُرجى الرجوع إلى إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. بغض النظر عن عملية التحقّق من OAuth، يتم فرض حد أقصى يبلغ 100 مستخدم يمكنهم منح الأذونات لتطبيقك، وذلك من قِبل Home APIs. يتم رفع هذا الحد عند إكمال عملية التسجيل.Developer Console
Developer Console للموافقة عليها عندما تكون مستعدًا لتقييد منح أذونات أنواع الأجهزة من خلال OAuth استعدادًا لتعديل تطبيقك باستخدام Home APIs.
بالنسبة إلى تطبيقات Google Cloud التي لا تزال في انتظار التحقّق من OAuth، لا يمكن للمستخدمين إكمال مسار OAuth إلى أن تكتمل عملية التحقّق. ستفشل محاولات منح الأذونات وسيظهر الخطأ التالي:
Access blocked: <Project Name> has not completed the Google verification process.