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

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

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

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

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

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

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. بعد ذلك، انقر على تفويض واجهات برمجة التطبيقات:

   

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

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

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

   • عليك إبقاء التطبيق في حالة الاختبار وإضافة نفسك كمستخدم تجريبي.

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

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

   

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

   

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

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

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

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

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

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

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

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

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