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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تحذير: يحدّد مستخدم 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. إذا سارت الأمور على ما يرام، من المفترض أن يتم ملء حقلَي Refresh token (رمز إعادة التحميل) وAccess token (رمز الوصول) (قد تحتاج إلى إعادة توسيعالخطوة 2: تبديل رمز التفويض بالرموز المميّزة):

   

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

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

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

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

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

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

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

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

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