ساحة بروتوكول OAuth

هناك خيار آخر لإنشاء بيانات اعتماد OAuth2 وهو استخدام OAuth2 Playground. تتيح لك "مساحة OAuth2"، بالتعاون مع Google API Console، إنشاء رموز OAuth2 يدويًا.

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

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

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

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

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

1. افتح وحدة تحكّم واجهة برمجة التطبيقات في Google صفحة "بيانات الاعتماد".

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

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

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

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

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

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

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

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

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

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

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

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

3. اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لاستخدام معرّف عميل 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، من المحتمل أنّه لم يتم نشر التغييرات التي أجريتها بعد. انقر على زر الرجوع في المتصفّح، انتظر بضع دقائق، ثم حاوِل النقر على تفويض واجهات برمجة التطبيقات مرة أخرى.

7. تظهر رسالة تطلب منك السماح لتطبيقك بالاطّلاع على بياناتك في AdMob. انقر على قبول للمتابعة.

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

   

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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