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

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

إنّ ملعب OAuth2 مخصّص للمستخدمين الذين يحتاجون إلى الوصول إلى الحسابات لحساب إداري واحد أو مستخدم على "إعلانات Google". إذا كنت بحاجة إلى طلب بيانات الاعتماد من عدة مستخدمين، من الأفضل ضبط مكتبة برامج لبروتوكول OAuth في Google Ads API.

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

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

إذا لم يكن لديك مشروع حالي على السحابة الإلكترونية:

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

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

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

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

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

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

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

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

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

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

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

2. انقر على رمز الترس في أعلى الجانب الأيسر وحدد المربع استخدام بيانات اعتماد OAuth (إذا لم يكن محددًا بالفعل).

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

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

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

   

5. في القسم بعنوان الخطوة 1 - اختيار واجهات برمجة التطبيقات وتفويضها، انقر على Google Ads API من القائمة واختَر نطاقها https://www.googleapis.com/auth/adwords. بعد ذلك، انقر على تفويض واجهات برمجة التطبيقات:

   

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

   إذا حصلت على معرّف العميل وسره قبل بضع دقائق فقط، وظهرت لك رسالة خطأ مثل خطأ: إعادة توجيه_uri_mismatch، قد لا يتمّ نشر التغييرات التي أجريتها. انقر على زر الرجوع في المتصفح، وانتظِر بضع دقائق، ثم حاوِل النقر على تفويض واجهات برمجة التطبيقات مرة أخرى.
   إذا ظهرت لك رسالة خطأ تفيد بأنّ المطوّر لم يمنحك إذن الوصول وأنّ التطبيق قيد الاختبار حاليًا، عليك الانتقال إلى صفحة شاشة موافقة OAuth في مشروع Google Cloud Platform وتنفيذ أحد الإجراءات التالية:

   • انشر التطبيق.

   • عليك إبقاء التطبيق في حالة الاختبار وإضافة نفسك كمستخدم تجريبي.

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

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

   

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

   

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

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

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

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

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

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

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

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

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