تستخدم واجهات برمجة التطبيقات 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، انتقِل إلى لوحة بيانات أداة اختيار المشاريع واختَر المشروع الذي تريد استخدامه لإنشاء بيانات اعتماد 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 API.
لا يتطلّب اختبار Home APIs واستخدامها التسجيل في Google Home Developer Console. ومع ذلك، سيظل عليك الحصول على موافقة على تسجيل Developer Console لنشر تطبيقك، حتى إذا كان لديك عميل OAuth تم التحقّق منه من عملية دمج أخرى.
تنطبق الاعتبارات التالية:
هناك حدّ أقصى يبلغ 100 مستخدم عند استخدام عميل OAuth حالي. للحصول على معلومات حول إضافة مستخدمين تجريبيين، يُرجى الرجوع إلى إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth بغض النظر عن عملية التحقّق من OAuth، تفرض واجهات برمجة التطبيقات Home APIs حدًا أقصى يبلغ 100 مستخدم يمكنهم منح الأذونات لتطبيقك. ويتم رفع هذا القيد عند إكمال عملية التسجيل في "Developer Console".
Developer Console registration يجب إرسال طلب الموافقة عندما تكون مستعدًا لتقييد الأذونات الممنوحة لنوع الجهاز من خلال OAuth استعدادًا لتحديث تطبيقك باستخدام واجهات برمجة التطبيقات Home API.
بالنسبة إلى Google Cloud تطبيق لا يزال في انتظار التحقّق من OAuth، لا يمكن للمستخدمين إكمال عملية OAuth حتى يكتمل التحقّق. وستؤدي محاولات منح الأذونات إلى ظهور الخطأ التالي:
Access blocked: <Project Name> has not completed the Google verification process.