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