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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تحذير: إنّ مستخدِم "إعلانات شبكة البحث 360" الذي سجّلت الدخول إليه في متصفّحك يحدّد الحسابات التي يمكنك الوصول إليها باستخدام بيانات اعتماد OAuth2 التي تنشئها. لذلك، ننصحك بتنفيذ هذه الخطوات في نافذة تصفّح متخفٍ أو في حال عدم تسجيل الدخول إلى حسابك على "إعلانات شبكة البحث 360"، فمن المحتمل أن يكون المستخدم الذي تريد استخدام بيانات اعتماده ليس هو نفسه المستخدم الذي سجّلت الدخول إليه عندما حصلت على معرّف العميل والسر.

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

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

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

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

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

   

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

   

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

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

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

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

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

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

   

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

   

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

11. ضبط مكتبة عملاء لبروتوكول OAuth في واجهة برمجة التطبيقات لإعداد التقارير في "إعلانات شبكة البحث 360"

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

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

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

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

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

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

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