إعداد التفويض

تتطلّب Search Ads 360 API من جميع الطلبات تحديد رمز دخول OAuth 2.0 للمصادقة. يمكنك اتّباع أيّ عملية سير عمل عادية لمصادقة OAuth 2.0 لإنشاء الرمز المميّز ونقله إلى Search Ads 360 API. ننصحك بالعملية الموضّحة أدناه لأنّها مناسبة لتحميل الإحالات الناجحة وتنزيل التقارير بشكلٍ مبرمَج بالكامل.

للحصول على بدائل لسير العمل الموضّح أدناه، يُرجى الاطّلاع على مقالتَي استخدام بروتوكول OAuth 2.0 للتطبيقات المثبَّتة أو استخدام بروتوكول OAuth 2.0 للتطبيقات من خادم إلى خادم. إذا كنت تستخدم سير عمل بديلاً، حدِّد القيمة التالية كمَعلمة scope عند طلب رمز تفويض 2.0 لبروتوكول OAuth:
https://www.googleapis.com/auth/doubleclicksearch
إذا اتّبعت مسار الخادم إلى الخادم، أضِف حساب الخدمة كمستخدم في "إعلانات شبكة البحث 360".

سير عمل التفويض المقترَح

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

   إذا لم يسبق لك إنشاء مشروع على Google API Console وبيانات اعتماد OAuth، اتّبِع التعليمات الواردة في مقالة إنشاء مشروع على Google API Console وبيانات اعتماد OAuth لعميلك.

   للعثور على معرّف عميل OAuth وسرّه لمشروعك، اتّبِع الخطوات التالية:

   1. افتح صفحة "بيانات الاعتماد".
   2. في عمود الاسم، انقر على اسم عميل OAuth.
   3. يتم إدراج معرّف العميل وسرّه في الصفحة.
2. افتح متصفّح ويب وسجِّل الدخول إلى Google باستخدام حساب Google لديه إذن بالوصول إلى البيانات في "إعلانات شبكة البحث 360".

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

3. احصل على رمز إعادة التنشيط من خلال استدعاء نصّ الأداة في "إعلانات شبكة البحث 360" على النحو التالي:

   sa360Api.py --login

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

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

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

   في نهاية العملية، يُخرج نص sa360Api.py سلسلة مُحدَّدة بفواصل. القيمة الأولى هي معرّف العميل الذي قدّمته، والقيمة الثانية هي سر العميل الذي قدّمته، والقيمة الثالثة هي رمز إعادة التنشيط. في المثال التالي، يظهر الرمز المميّز لإعادة التحميل بنص غامق:
   123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw

5. تخزين معرّف العميل وسرّ العميل والرمز المميّز لإعادة التحميل في قاعدة بيانات خلفية أو مكان آمن آخر يمكن لتطبيقك الوصول إليه

   احتفظ بالسلسلة بأكملها المحدّدة بفواصل في مكان مناسب إذا كنت تخطّط لاستخدام sa360Api.py لإرسال نماذج طلبات JSON إلى Search Ads 360 API. عليك تمرير السلسلة بأكملها كمَعلمة في كل مرة يتم فيها استدعاء النص البرمجي.

6. أضِف رمزًا إلى تطبيقك لتنفيذ ما يلي:
   1. استخدِم معرّف العميل وسرّ العميل والرمز المميّز لإعادة التحميل للحصول على رمز وصول جديد لبروتوكول OAuth 2.0.
   2. أرسِل طلبات إلى Search Ads 360 API باستخدام رمز الأمان الجديد.

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

   إذا لم تكن تستخدِم إحدى مكتبات البرامج، يمكنك الاطّلاع على مقالة استخدام بروتوكول OAuth 2.0 للتطبيقات المثبَّتة للحصول على اقتراحات حول الحصول على رمز مميز جديد للوصول.