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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    الرمز المميّز لرمز المصادقة في "مساحة اللعب"

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

    الرمز المميّز لإعادة التحميل في "مساحة اللعب"

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

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

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

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

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

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

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

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

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