المصادقة

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

إنشاء بيانات اعتماد OAuth2

نفِّذ الخطوات التالية لإنشاء بيانات اعتماد OAuth2.

1- تحديد نوع المصادقة

راجع الجدول أدناه لمعرفة نوع المصادقة الأنسب لتطبيق واجهة برمجة تطبيقات "مدير الإعلانات":

اختيار نوع مصادقة OAuth2
حساب الخدمة

يمكنك اختيار ذلك إذا كنت تحتاج فقط إلى الوصول إلى بياناتك في "مدير الإعلانات".

مزيد من المعلومات
تطبيق الويب

حدِّد هذا الخيار إذا كنت تريد المصادقة بصفتك أي مستخدم يمنح تطبيقك الإذن بالوصول إلى بياناته على "مدير الإعلانات".

مزيد من المعلومات

2. إنشاء بيانات اعتماد OAuth2

بعد تحديد نوع المصادقة، انقر على علامة التبويب المقابلة أدناه واتبع التعليمات لإنشاء بيانات اعتماد OAuth2:

حساب الخدمة
  1. افتح صفحة بيانات اعتماد وحدة تحكّم Google API.
  2. من القائمة المنسدلة للمشروع، اختَر إنشاء مشروع جديد وأدخِل اسمًا للمشروع ويمكنك اختياريًا تعديل رقم تعريف المشروع المقدَّم. انقر على إنشاء.
  3. في صفحة "بيانات الاعتماد"، اختَر إنشاء بيانات اعتماد، ثم اختَر مفتاح حساب الخدمة.
  4. اختَر حساب خدمة جديد، ثم اختَر JSON.
  5. انقر على إنشاء لتنزيل ملف يحتوي على مفتاح خاص.
تطبيق الويب
  1. افتح صفحة بيانات اعتماد وحدة تحكّم Google API.
  2. من القائمة المنسدلة للمشروع، اختَر إنشاء مشروع جديد وأدخِل اسمًا للمشروع (ويمكنك اختياريًا تعديل رقم تعريف المشروع المقدَّم) وانقر على إنشاء.
  3. في صفحة "بيانات الاعتماد"، اختَر إنشاء بيانات اعتماد، ثم اختَر معرِّف عميل OAuth.
  4. قد يُطلب منك ضبط اسم منتج على صفحة "شاشة الموافقة"، وإذا كان الأمر كذلك، انقر على إعداد شاشة الموافقة، ووفِّر المعلومات المطلوبة، ثم انقر على حفظ للعودة إلى صفحة "بيانات الاعتماد".
  5. اختَر تطبيق الويب من أجل نوع التطبيق. اتّبِع التعليمات لإدخال مصادر JavaScript أو عناوين URL لإعادة التوجيه أو كليهما.
  6. انقر على إنشاء.
  7. في الصفحة التي تظهر، انسخ معرّف العميل وسر العميل إلى الحافظة، حيث ستحتاج إليهما عند ضبط مكتبة البرامج.
لقطة شاشة لمعرّف العميل وسر العميل

3. إعداد شبكة "مدير الإعلانات"

إذا كنت مطوّر برامج تابعًا لجهة خارجية، قد تحتاج إلى أن تطلب من عميلك تنفيذ هذه الخطوة نيابةً عنك.

حساب الخدمة
  1. انتقِل إلى شبكة "مدير الإعلانات".
  2. انقر على علامة التبويب المدير.
  3. تأكَّد من تفعيل الوصول إلى واجهة برمجة التطبيقات.
  4. انقر على الزر إضافة مستخدم حساب خدمة.
  5. املأ النموذج باستخدام البريد الإلكتروني لحساب الخدمة. يجب منح مستخدم حساب الخدمة أذونات للوصول إلى الكيانات كما لو كان مستخدم حساب الخدمة هذا سيصل إلى الكيانات على واجهة المستخدم.
  6. انقر على الزر حفظ. من المفترض أن تظهر رسالة لتأكيد إضافة حساب الخدمة.
  7. يمكنك عرض مستخدمي حساب الخدمة الحاليين بالانتقال إلى علامة التبويب "المستخدمون"، ثم النقر على فلتر حساب الخدمة.
تطبيق الويب
  1. انتقِل إلى شبكة "مدير الإعلانات".
  2. انقر على علامة التبويب المدير.
  3. تأكَّد من تفعيل الوصول إلى واجهة برمجة التطبيقات.

4. ضبط مكتبة برامج واستخدامها

يُرجى اتباع الدليل المناسب أدناه لاستخدام بيانات الاعتماد في مكتبة البرامج:

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

لقطات من وراء الكواليس

تراعي مكتبات العملاء لدينا تلقائيًا التفاصيل الواردة أدناه، لذا يُرجى مواصلة القراءة فقط إذا كنت مهتمًا بما يحدث وراء الكواليس. هذا القسم مخصَّص للمستخدمين المتقدمين الذين لديهم دراية بمواصفات OAuth2 ويعرفون كيفية استخدام OAuth2 مع Google APIs.

عنوان طلب HTTP

يجب أن يتضمّن عنوان HTTP في كل طلب إلى واجهة برمجة تطبيقات "مدير الإعلانات" رمز دخول في هذا النموذج:

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.

يحتوي "مدير إعلانات Google" على نطاق واحد فقط موضّح أدناه. يجب إجراء التفويض على مستوى المستخدم داخل المنتج.

النطاق الأذونات
https://www.googleapis.com/auth/dfp يمكنك عرض حملاتك وإدارتها على "مدير إعلانات Google".