مساحة لعب OAuth

هناك خيار آخر لإنشاء بيانات اعتماد OAuth2، وهو استخدام ملعب OAuth2. يتيح لك ساحة بروتوكول OAuth2، جنبًا إلى جنب مع وحدة تحكم واجهة برمجة تطبيقات Google، إنشاء رموز OAuth2 المميزة يدويًا.

المتطلبات الأساسية

قبل إنشاء بيانات الاعتماد، عليك إنشاء مشروع وضبط شاشة موافقة المستخدم وتفعيل واجهة برمجة تطبيقات AdMob.

الحصول على معرِّف العميل وسر العميل

إنشاء بيانات اعتماد

نقطة رئيسية: لاستخدام ملعب OAuth2، عليك إنشاء معرِّف عميل لتطبيق ويب. هذا هو النوع الوحيد من التطبيقات التي تعمل مع مساحة تشغيل OAuth2.

1. افتح صفحة بيانات الاعتماد لوحدة تحكم واجهة Google API.

2. من القائمة المنسدلة للمشروع، اختَر مشروعًا حاليًا أو أنشئ مشروعًا جديدًا.

   نقطة رئيسية: أنشِئ مشروعًا يحمل اسم تعريف فريدًا لكل رمز مميّز مشترَك، حتى تتمكّن من مشاركته أو revoke بسهولة.

3. في صفحة "بيانات الاعتماد"، اختَر إنشاء بيانات اعتماد، ثم اختَر معرِّف عميل OAuth.

4. ضمن نوع التطبيق، اختَر تطبيق الويب.

5. ضمن معرِّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، أضِف سطرًا يحتوي على: https://developers.google.com/oauthplayground

   نقطة رئيسية: إذا كانت لديك بيانات اعتماد حالية، يمكنك إعادة استخدامها من خلال ضبط معرّفات الموارد المنتظمة المعتمدة لإعادة التوجيه على النحو الوارد أعلاه.

6. انقر على إنشاء.

7. في صفحة "معرّف العميل"، دوِّن معرّف العميل وسر العميل. ستحتاج إليها في الخطوة التالية.

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

يجب إعداد شاشة موافقة OAuth قبل استخدام معرِّف عميل OAuth 2.0.

1. افتح صفحة "شاشة الموافقة" لوحدة تحكم Google API.

2. من القائمة المنسدلة للمشروع، حدد المشروع نفسه المستخدم لإنشاء بيانات الاعتماد.

3. اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth 2.0 لاستخدام معرِّف عميل OAuth 2.0. هناك عدة طرق للقيام بذلك:

   1. اضبط نوع المستخدم على خارجي وحالة النشر على تم النشر.
   2. أو اضبط نوع المستخدم على خارجي وحالة النشر على اختبار، ثم أضِف المستخدمون التجريبيون من خلال اختيار إضافة مستخدمين لمنحهم إذن الوصول لاستخدام معرّف عميل OAuth 2.0.

يمكنك الاطّلاع على معلومات إضافية عن إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.

إنشاء رموز مميّزة

نقطة رئيسية: يحدد مستخدم Google الذي تسجّل الدخول إليه في متصفحك حساب AdMob الذي ستتمكّن من الوصول إليه باستخدام بيانات اعتماد OAuth2 التي تنشئها. لذلك، ننصحك بتنفيذ هذه الخطوات في نافذة تصفّح متخفٍ أو في حال عدم تسجيل الدخول إلى حسابك على Google، إذ من المحتمل أن يكون المستخدم الذي تريد استخدام بيانات اعتماده هو نفسه المستخدم الذي سجّلت الدخول منه عندما حصلت على معرِّف العميل والرمز السري.

1. انتقِل إلى ملعب OAuth2، (من المفترض أن يؤدي استخدام هذا الرابط إلى تعبئة بعض القيم الرئيسية مسبقًا لك).

2. انقر على رمز الترس في أعلى يسار الصفحة، وضَع علامة في المربّع استخدام بيانات اعتماد OAuth الخاصة بك (إذا لم يكن قد تم وضع علامة فيه من قبل).

3. تأكَّد مما يلي:

   • يتم ضبط تدفق OAuth على من جهة الخادم.
   • يتم ضبط نوع الوصول على بلا اتصال بالإنترنت (يضمن ذلك الحصول على الرمز المميّز لإعادة التحميل ورمز دخول بدلاً من رمز دخول فقط).

4. أدخِل معرِّف عميل OAuth2 وسر عميل OAuth2 الذي حصلت عليه أعلاه.

   

5. في القسم بعنوان الخطوة 1: اختيار واجهات برمجة التطبيقات والسماح بها، أدخِل عنوان URL التالي في مربّع النص في الأسفل، إذا لم يكن متوفّرًا من قبل، ثم انقر على تفويض واجهات برمجة التطبيقات:

   https://www.googleapis.com/auth/admob.readonly

6. سجِّل الدخول إلى الحساب الذي تريد منح الإذن بالوصول والتفويض إذا طُلب منك ذلك. بخلاف ذلك، تأكَّد من أنّ مستخدم Google الحالي في أعلى يسار الصفحة هو حساب AdMob الذي تريد الحصول على بيانات اعتماده.

   نقطة رئيسية: إذا حصلت على معرِّف العميل والسرّ قبل بضع دقائق فقط، وظهرت لك رسالة خطأ مثل Error: redirect_uri_mismatch، من المحتمل أنّ التغييرات التي أجريتها لم يتم نشرها بعد. انقر على زر الرجوع في المتصفّح، وانتظر بضع دقائق، ثم حاوِل النقر على Authorize APIs مرة أخرى.

7. ستظهر رسالة تشير إلى أنّ تطبيقك يريد الاطّلاع على بياناتك على AdMob. انقر على قبول للمتابعة.

8. في علامة التبويب الخطوة 2 - استبدال رمز تفويض الرموز المميزة، من المفترض أن تظهر رمز تفويض. انقر على رمز تفويض Exchange للرموز المميزة.

   

9. إذا سارت الأمور على ما يرام، فمن المفترض ملء الرمز المميز لإعادة التحميل ورمز الدخول (قد تحتاج إلى إعادة توسيع الخطوة 2: استبدال رمز التفويض للرموز المميزة):

   

10. انسخ الرمز المميّز لإعادة التحميل في ملف الإعداد لمكتبة العميل التي تختارها، إلى جانب معرّف العميل وسر العميل.

11. اضبط مكتبة عملاء لبروتوكول OAuth في AdMob API.

إزالة مساحة عمل OAuth2 من معرِّف العميل

والآن بعد أن حصلت على رمز مميز للتحديث، لم تعد بحاجة إلى OAuth2 Playground ليكون عنوان URL مُعتمد لإعادة التوجيه. لإزالته من قائمة معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه:

1. انتقِل إلى صفحة بيانات الاعتماد لوحدة تحكم واجهة Google API.

2. اختَر مشروعك من القائمة المنسدلة للمشروع.

3. في صفحة "بيانات الاعتماد"، انقر على اسم معرِّف العميل لتعديله.

4. أزِل https://developers.google.com/oauthplayground من معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه. تجدر الإشارة إلى ضرورة ترك معرّف موارد منتظم (URI) لإعادة التوجيه واحد على الأقل في مكانه.

5. انقر على حفظ.

إبطال الرموز المميّزة المشتركة

يمكنك إبطال الرموز المميزة المشتركة بطريقتين:

1. انتقِل إلى صفحة أذونات حساب Google وأزِل الإذن بالوصول من المشروع ذي الصلة.

2. يمكنك بدلاً من ذلك إبطال الرموز المميّزة لتطبيق الويب باستخدام Google Identity API.