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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    إعدادات "مساحة اللعب"

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

    تفويض واجهات برمجة التطبيقات

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

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