تستخدم واجهات برمجة التطبيقات Home بروتوكول OAuth 2.0 لمنح إذن الوصول إلى الأجهزة في البنية. يسمح بروتوكول OAuth للمستخدم بمنح الإذن لتطبيق أو خدمة بدون الحاجة إلى الكشف عن بيانات اعتماد تسجيل الدخول.
إذا كان لديك عميل OAuth تم إثبات ملكيته (على سبيل المثال، من تطبيق تم نشره سابقًا)، يمكنك استخدام هذا العميل لاختبار واجهات برمجة التطبيقات Home بدون إعداد عميل جديد. لمزيد من المعلومات، يُرجى الاطّلاع على في حال توفّر عميل 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 لاختبار واجهات برمجة التطبيقات الخاصة بالمنزل واستخدامها. ومع ذلك، سيظلّ عليك الحصول على تسجيل 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.