يجب أن تحصل جميع طلبات بيانات Google Ad Manager API على الموافقة من خلال OAuth2، وهو معيار مفتوح يسمح للمستخدمين بمنح الأذونات للتطبيقات الخارجية، لكي يتمكّن التطبيق من التفاعل مع خدمات الويب نيابةً عن المستخدم. يتيح بروتوكول OAuth2 لتطبيق عميل Ad Manager API الوصول إلى حساب مستخدم على "مدير الإعلانات" بدون الحاجة إلى معالجة أو تخزين اسم المستخدم أو كلمة المرور الخاصَّين بالمستخدم.
إنشاء بيانات اعتماد OAuth2
اتّبِع الخطوات التالية لإنشاء بيانات اعتماد OAuth2.
1. تحديد نوع المصادقة
راجِع الجدول أدناه لمعرفة نوع المصادقة الأنسب لتطبيق Ad Manager API:
| اختيار نوع مصادقة OAuth2 | |
|---|---|
| حساب الخدمة |
حدِّد هذا الخيار إذا كنت تحتاج فقط إلى الوصول إلى بياناتك في "مدير إعلانات Google". مزيد من المعلومات |
| تطبيق ويب |
اختَر هذا الخيار إذا كنت تريد المصادقة كمستخدم يمنح الإذن لتطبيقك بالوصول إلى بياناته في "مدير الإعلانات". مزيد من المعلومات |
2. إنشاء بيانات اعتماد OAuth2
بعد تحديد نوع المصادقة، انقر على علامة التبويب المقابلة أدناه واتّبِع التعليمات لإنشاء بيانات اعتماد OAuth2:
- افتح صفحة بيانات الاعتماد في Google API Console.
- من القائمة المنسدلة للمشروع، اختَر إنشاء مشروع جديد، وأدخِل اسمًا للمشروع، ويمكنك تعديل رقم تعريف المشروع المقدَّم. انقر على إنشاء.
- في صفحة "بيانات الاعتماد"، انقر على إنشاء بيانات اعتماد، ثم اختَر مفتاح حساب الخدمة.
- اختَر حساب خدمة جديد، ثم اختَر JSON.
- انقر على إنشاء لتنزيل ملف يحتوي على مفتاح خاص.
- افتح صفحة بيانات الاعتماد في Google API Console.
- من القائمة المنسدلة للمشروع، اختَر إنشاء مشروع جديد، وأدخِل اسمًا للمشروع (ويمكنك تعديل رقم تعريف المشروع المقدَّم)، ثم انقر على إنشاء.
- في صفحة "بيانات الاعتماد"، انقر على إنشاء بيانات اعتماد، ثم على معرِّف عميل OAuth.
- قد يُطلب منك تحديد اسم منتج في صفحة "شاشة طلب الموافقة"، وفي هذه الحالة، انقر على ضبط شاشة طلب الموافقة، وقدِّم المعلومات المطلوبة، ثم انقر على حفظ للعودة إلى صفحة "بيانات الاعتماد".
- اختَر تطبيق ويب في حقل نوع التطبيق. اتّبِع التعليمات لإدخال مصادر JavaScript أو معرّفات الموارد المنتظمة (URI) لإعادة التوجيه أو كليهما.
- انقر على إنشاء.
- في الصفحة التي تظهر، انسخ معرِّف العميل وسر العميل إلى الحافظة، لأنّك ستحتاج إليهما عند ضبط مكتبة العميل.
3- ضبط إعدادات شبكة "إدارة الإعلانات"
إذا كنت مطوّرًا تابعًا لجهة خارجية، قد تحتاج إلى أن يكمل عميلك هذه الخطوة نيابةً عنك.
- انتقِل إلى شبكة "إدارة الإعلانات".
- انقر على علامة التبويب المشرف.
- تأكَّد من تفعيل الوصول إلى واجهة برمجة التطبيقات.
- انقر على الزر إضافة مستخدم حساب خدمة.
- املأ النموذج باستخدام عنوان البريد الإلكتروني لحساب الخدمة. يجب منح مستخدم حساب الخدمة أذونات للوصول إلى الكيانات كما لو كان مستخدم حساب الخدمة هذا سيصل إلى الكيانات على واجهة المستخدم.
- انقر على الزر حفظ. من المفترض أن تظهر رسالة تؤكّد إضافة حساب الخدمة.
- يمكنك الاطّلاع على مستخدمي حسابات الخدمة الحاليين من خلال الانتقال إلى علامة التبويب "المستخدمون"، ثم النقر على فلتر حساب الخدمة.
- انتقِل إلى شبكة "إدارة الإعلانات".
- انقر على علامة التبويب المشرف.
- تأكَّد من تفعيل الوصول إلى واجهة برمجة التطبيقات.
4. ضبط مكتبة برامج واستخدامها
اتّبِع الدليل المناسب أدناه لاستخدام بيانات الاعتماد في مكتبة العميل:
جافا
NET.
Python
PHP
Ruby
إذا اخترت عدم استخدام إحدى مكتبات العملاء، عليك تنفيذ مسار حساب الخدمة أو تطبيق الويب في OAuth2 بنفسك.
وراء الكواليس
تتولى مكتبات البرامج لدينا تلقائيًا معالجة التفاصيل الموضّحة أدناه، لذا يمكنك مواصلة القراءة فقط إذا كنت مهتمًا بما يحدث وراء الكواليس. هذا القسم مخصّص للمستخدمين المتقدّمين الذين لديهم دراية بمواصفات OAuth2 ويعرفون كيفية استخدام OAuth2 مع Google APIs.
عنوان طلب HTTP
يجب أن يتضمّن عنوان HTTP في كل طلب إلى Ad Manager API رمز وصول بهذا الشكل:
Authorization: Bearer ACCESS_TOKEN
على سبيل المثال:
POST … HTTP/1.1 Host: … Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg Content-Type: text/xml;charset=UTF-8 Content-Length: … <?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"> … </soap:Envelope>
النطاق
يمكن أن يمنح رمز الدخول الواحد مستويات مختلفة من الوصول إلى واجهات برمجة تطبيقات متعددة. تتحكّم مَعلمة متغيّرة تُسمّى scope في مجموعة الموارد والعمليات التي يسمح بها رمز الدخول. أثناء طلب رمز الدخول، يرسل تطبيقك قيمة واحدة أو أكثر في المَعلمة scope.
يحتوي "مدير الإعلانات" على نطاق واحد فقط، كما هو موضّح أدناه. يجب إجراء التفويض على مستوى المستخدم داخل المنتج.
| النطاق | الأذونات |
|---|---|
https://www.googleapis.com/auth/admanager |
يمكنك الاطّلاع على حملاتك وإدارتها في "إدارة إعلانات Google". |