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

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

تهدف ميزة OAuth2 Playground إلى المستخدمين الذين يحتاجون فقط إلى الوصول إلى حسابات حساب إداري أو مستخدم واحد على "إعلانات 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" أو الحساب الإداري الذي تريد الحصول على بيانات اعتماده.

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

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

   • اترك التطبيق في حالة "اختبار" وأضِف نفسك كمستخدم تجريبي.

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

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

   

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. انقر على حفظ.