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

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

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

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

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

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

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

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

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

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

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

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

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

إذا كان لديك مشروع حالي على السحابة الإلكترونية، يمكنك إعادة استخدامه من خلال ضبط معرّفات الموارد المنتظمة لإعادة التوجيه المصرّح بها كما هو موضّح في الخطوة 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" أو الحساب الإداري الذي تريد الحصول على بيانات الاعتماد الخاصة به.

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

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

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

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

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

   

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

   

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

11. ضبط مكتبة عميل لبروتوكول OAuth في Google Ads API

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

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

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

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

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

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

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