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