تتطلّب واجهة برمجة تطبيقات "إعلانات شبكة البحث 360" جميع الطلبات لتحديد رمز دخول OAuth 2.0 للمصادقة. يمكنك اتباع أي مهام عادية لمصادقة OAuth 2.0 لإنشاء الرمز المميز وتمريره إلى واجهة برمجة التطبيقات في "إعلانات شبكة البحث 360". نقترح سير العمل الموضّح أدناه لأنه مناسب لتحميلات الإحالات الناجحة المبرمَجة بالكامل وتنزيلات التقارير.
للحصول على بدائل لسير العمل الموضح أدناه، يُرجى الاطّلاع على استخدام OAuth 2.0 للتطبيقات المثبّتة أو استخدام OAuth 2.0 لخادم إلى تطبيقات الخادم. إذا كنت تستخدم سير عمل بديل،
حدِّد القيمة التالية على أنها المعلمة scope عند طلب رمز تفويض
OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
في حال اتّباع الخادم إلى مسار الخادم، أضِف حساب الخدمة كمستخدم في "إعلانات شبكة البحث 360".
سير عمل التفويض المقترح
- انتقِل إلى وحدة التحكم في واجهة Google API واختَر مشروعك.
إذا لم يسبق لك إنشاء مشروع وحدة تحكم Google API وبيانات اعتماد OAuth، اتّبع التعليمات الواردة في إنشاء مشروع وحدة تحكم Google API وبيانات اعتماد OAuth لعميلك.
للعثور على معرِّف عميل OAuth لمشروعك وسرِّه، يمكنك إجراء ما يلي:
- افتح صفحة بيانات الاعتماد.
- في عمود الاسم، انقر على اسم برنامج OAuth.
- يتم إدراج معرّف وسر العميل في الصفحة.
- افتح متصفح ويب وسجّل الدخول إلى Google
باستخدام حساب Google يتمتع
بالإذن للوصول إلى البيانات في "إعلانات شبكة البحث 360".
هذا هو حساب Google الذي سيستخدمه عميل واجهة برمجة التطبيقات للمصادقة مع "إعلانات شبكة البحث 360". إذا غادر مالك حساب Google شركتك وأزلت إمكانية الوصول إلى "إعلانات شبكة البحث 360" من الحساب، عليك تكرار سير عمل التفويض هذا وتحديد حساب Google مختلف.
- احصل على رمز مميز لإعادة التحميل من خلال استدعاء النص البرمجي لأداة "إعلانات شبكة البحث 360" على النحو التالي:
sa360Api.py --loginيرشدك النص البرمجي خلال عملية استخدام معرّف وسر عميل Oauth للحصول على الرمز المميز لإعادة التحميل. الرمز المميز لإعادة التحميل صالح فقط لحساب Google الذي سجّلت الدخول إليه أثناء الخطوة السابقة.
في إطار هذه العملية، ينشئ النص البرمجي عنوان URL ويرشدك إلى زيارة عنوان URL في متصفّح ويب.
-
عندما يطلب منك المتصفّح السماح لبرنامج OAuth بالوصول إلى بيانات "إعلانات شبكة البحث 360"، تأكّد من ظهور حساب Google الذي سجّلت الدخول إليه في وقت سابق. (إذا سجّلت الدخول إلى عدة حسابات على Google، قد يظهر لك حساب مختلف).
في نهاية العملية، يُخرِج النص البرمجي
sa360Api.pyسلسلة مفصولة بفواصل. القيمة الأولى هي رقم تعريف العميل الذي قدمته، والقيمة الثانية هي سر العميل الذي قدمته، والقيمة الثالثة هي الرمز المميز للتحديث. في المثال التالي، يظهر الرمز المميز لإعادة التحميل بنص غامق:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw - تخزين معرِّف العميل وسر العميل والرمز المميز للتحديث في قاعدة بيانات خلفية أو موقع آمن آخر يمكن لتطبيقك الدخول إليه.
يجب الاحتفاظ بالسلسلة المفصولة بفواصل بالكامل في مكان مناسب إذا كنت تخطّط لاستخدام
sa360Api.pyلإرسال نموذج من طلبات JSON إلى واجهة برمجة التطبيقات في "إعلانات شبكة البحث 360". يجب إدخال السلسلة بأكملها كمعلَمة في كل مرة يتم فيها استدعاء النص البرمجي. - أضِف الرمز إلى تطبيقك الذي ينفّذ ما يلي:
- استخدِم معرِّف العميل وسر العميل والرمز المميز لإعادة التحميل للحصول على رمز دخول جديد إلى OAuth 2.0.
- يمكنك إرسال طلبات إلى واجهة برمجة التطبيقات في "إعلانات شبكة البحث 360" باستخدام رمز الدخول الجديد.
إذا كنت تستخدم مكتبات العملاء، يصف القسم التالي إعداد تطبيقك كيفية إضافة رمز التفويض هذا إلى تطبيقك.
إذا كنت لا تستخدم إحدى مكتبات العملاء، فراجع استخدام OAuth 2.0 للتطبيقات المثبتة للحصول على اقتراحات بشأن الحصول على رمز دخول حديث.