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