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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. انقر على رمز الترس في أعلى يسار الصفحة وضَع علامة في المربّع استخدام بيانات اعتماد OAuth الخاصة بك (إذا لم تكن قد وضعت علامة عليه).

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

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

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

    إعدادات Playground

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

    السماح لواجهات برمجة التطبيقات

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

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

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

    رمز مميّز لرمز المصادقة في Playground

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

    الرمز المميّز لإعادة تحميل Playground

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

  11. ضبط مكتبة برمجية لبروتوكول OAuth في Search Ads 360 Reporting API

إزالة OAuth2 Playground من معرّف العميل

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

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

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

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

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

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