تحتاج طلبات البيانات من واجهة برمجة التطبيقات إلى واجهة برمجة التطبيقات الخاصة ببرنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" الخاصة بالعميل إلى الحصول على إذن. يؤدي طلب التفويض إلى حماية بيانات مؤسستك. للسماح بالمكالمات إلى واجهة برمجة التطبيقات لبرنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"، عليك إكمال المهام التالية:
- أنشئ حساب خدمة لطلب واجهات برمجة التطبيقات.
- خزِّن ملف مفتاح JSON للسماح بطلبات بيانات من واجهة برمجة التطبيقات.
- تفعيل واجهة برمجة التطبيقات لإتاحتها للخدمة الحساب.
- ربط حساب الخدمة لإجراء طلبات بيانات من واجهة برمجة التطبيقات نيابةً عن التنظيم.
اتبع الإرشادات أدناه لمساعدتك في إكمال المهام.
الخطوة 1: إنشاء حساب خدمة
حساب الخدمة، ويُعرف أحيانًا باسم حساب الروبوت، هو حساب Google. تمثيل التطبيقات بدلاً من المستخدمين. يطلب تطبيقك واجهات برمجة التطبيقات بالنيابة عن حساب الخدمة الخاص بك، لذلك لا يشارك المستخدمون بشكل مباشر. نظرًا لأن تطبيقك يستخدم Google APIs، استخدم وحدة التحكم في واجهة Google API لإعداد الوصول.
إنشاء مشروع في وحدة تحكم واجهة برمجة التطبيقات
من المفيد إنشاء مشروع وخدمة جديدة في وحدة تحكم واجهة برمجة التطبيقات لحساب لتطبيقك. وهذا يجعل إدارة الوصول وإدارة الموارد وإصلاح الأخطاء المفاتيح المفقودة بشكل أسهل في المستقبل. ابدأ باتباع الخطوات أدناه لإنشاء مشروع جديد في وحدة تحكم واجهة برمجة تطبيقات Google:
- انتقِل إلى وحدة تحكم واجهة برمجة التطبيقات.
- من قائمة المشاريع، اختَر أنشِئ مشروعًا.
- أدخِل اسمًا يصف تطبيقك و"إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".
- حدِّد رقم تعريف المشروع أو وافِق على الرقم التلقائي.
- انقر على إنشاء.
لمعرفة المزيد، يُرجى الاطّلاع على مستند Google Cloud Platform إدارة المشاريع في وحدة التحكم.
إضافة بيانات اعتماد جديدة للخدمة
لإضافة بيانات اعتماد جديدة وحساب خدمة إلى مشروعك، يجب اتّباع الخطوات التالية: أدناه في وحدة تحكم واجهة برمجة التطبيقات.
- افتح صفحة حسابات الخدمة. اختَر مشروعًا إذا طُلب منك ذلك.
- انقر على إنشاء حساب للخدمة ثم أدخِل اسمًا ووصفًا لحساب الخدمة. يمكنك استخدام معرّف حساب الخدمة التلقائي أو اختيار معرّف فريد مختلف. وعند الانتهاء من ذلك، انقر على إنشاء.
- قسم أذونات حساب الخدمة (اختيارية) التالي غير مطلوب. انقر على متابعة.
- انتقِل إلى القسم إنشاء مفتاح في أسفل شاشة منح المستخدمين صلاحية الوصول إلى حساب الخدمة هذا. انقر على إنشاء مفتاح.
- في اللوحة الجانبية التي تظهر، اختَر التنسيق الذي تريده للمفتاح: وننصح باختيار: JSON.
- انقر على إنشاء. يتم إنشاء زوج المفتاح العام/الخاص وتنزيله على جهازك، وهو النسخة الوحيدة من هذا المفتاح. للحصول على معلومات عن طريقة التخزين الآمن للمفتاح، يُرجى مراجعةإدارة مفاتيح حساب الخدمة.
- انقر على إغلاق في مربّع الحوار تم حفظ المفتاح الخاص على الكمبيوتر، ثم انقر على تم للرجوع إلى جدول حسابات الخدمة.
انسخ عنوان البريد الإلكتروني لحساب الخدمة واحتفظ به في متناولك. أنت بحاجة إليه لاحقًا عند ربط حساب الخدمة بمؤسستك.
الخطوة 2: تخزين ملف مفتاح JSON
تنشئ وحدة تحكم واجهة برمجة التطبيقات مفتاحَي تشفير خاصَين جديدَين يُستخدمان للمصادقة طلبات البيانات من واجهة برمجة التطبيقات التي تم إجراؤها باستخدام حساب الخدمة المفتاح الخاص موجود في مفتاح JSON تقوم بتنزيله.
ويجب الحفاظ على خصوصية المفتاح، حتى لا تضمِّنه في رمز المصدر لتطبيقك. إذا فقدت ملف المفتاح، عليك إنشاء مفتاحَين جديدَين.
لمزيد من المعلومات حول تخزين ملف المفتاح بأمان، يمكنك الاطّلاع على أفضل الممارسات باستخدام مفاتيح واجهة برمجة التطبيقات بأمان
الخطوة 3: تفعيل واجهة برمجة التطبيقات
يجب تفعيل واجهة برمجة التطبيقات قبل أن يتمكّن تطبيقك من استخدامها. تمكين واجهة برمجة تطبيقات تربطه بالمشروع الحالي في وحدة تحكم واجهة برمجة التطبيقات ويضيف المراقبة في وحدة التحكم الخاصة بك.
لتفعيل واجهة برمجة التطبيقات، اتّبِع الخطوات أدناه في وحدة تحكّم واجهة برمجة التطبيقات:
- انقر على واجهات برمجة التطبيقات الخدمات > المكتبة:
- استخدم حقل البحث للعثور على شريك توفير المتطلبات اللازمة لأجهزة Android API:
- انقر على واجهة برمجة التطبيقات للشركاء لتوفير المتطلبات اللازمة لأجهزة Android.
- انقر على تفعيل.
وبعد فترة قصيرة، تتغير حالة واجهة برمجة التطبيقات إلى "مفعّلة". إذا كنت لا ترى واجهة برمجة التطبيقات للشركاء لتوفير المتطلبات اللازمة لأجهزة Android، تأكَّد من أنّه تم إعداد مؤسستك. إلى برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". تأكد من استخدام حساب Google نفسه إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة ووحدة تحكم Google API.
الخطوة 4: ربط حساب الخدمة
ربط حساب الخدمة ببرنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" لمؤسستك يفوّض حساب الخدمة حساب الخدمة بإجراء طلبات بيانات من واجهة برمجة التطبيقات نيابةً عن التنظيم. املأ نموذج طلب الرابط لربط حساب الخدمة الخاص بك.
إذا لم تتمكّن من العثور على عنوان البريد الإلكتروني لحساب الخدمة الذي أنشأته، انسخه. من أحد الأماكن التالية:
- البريد الإلكتروني لحساب الخدمة من صفحة حسابات الخدمة في وحدة التحكم في واجهة Google API.
- حقل السمة
client_emailفي ملف مفتاح JSON.
فور تلقّي رسالة تأكيد إلكترونية تفيد بأنّ حسابك مرتبط بحسابك، ستتغيّر الخدمة يمكن لحسابك بعد ذلك إجراء اتصالات بواجهة برمجة تطبيقات العميل نيابةً عن مؤسستك.
تجربة واجهة برمجة التطبيقات
يمكنك اختبار عمل الوصول إلى واجهة برمجة التطبيقات باتّباع الخطوات الواردة في إحدى أدلة البدء السريع Java .NET Python
نطاقات الأذونات
استخدام نطاق تفويض واجهة برمجة التطبيقات
https://www.googleapis.com/auth/androidworkzerotouchemm في تطبيقك لتقديم الطلب
رمز الدخول إلى OAuth 2.0.
تتحكم معلمة النطاق في مجموعة الموارد والعمليات التي يمكن الوصول إليها يسمح الرمز المميز بالمكالمات. تكون رموز الدخول صالحة لمجموعة العمليات فقط والموارد الموضحة في نطاق طلب الرمز المميز. تغطي واجهة برمجة التطبيقات جميع الطرق والموارد مع نطاق "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" الفردي المعروض أعلاه.
لمزيد من المعلومات حول استخدام نطاقات Google API، يُرجى الاطّلاع على استخدام OAuth 2.0 للوصول إلى Google APIs