بدء استخدام AdMob API

هذا الدليل مخصّص للمطوّرين الذين يريدون استخدام AdMob API للحصول على البيانات آليًا في حساباتهم على AdMob.

يجب أن تتم الموافقة على جميع طلبات Google AdMob API من خلال OAuth2 حتى يتمكّن تطبيقك من التفاعل مع خدمات الويب بالنيابة عن المستخدم. يتيح بروتوكول OAuth2 لتطبيق عميل AdMob API الوصول إلى حساب مستخدم على AdMob بدون الحاجة إلى معالجة اسم المستخدم أو كلمة المرور أو تخزينهما. للحصول على نظرة عامة حول التفويض، يُرجى الاطّلاع على مقالة التفويض.

اتّبِع الخطوات التالية لإنشاء بيانات اعتماد OAuth2 وإجراء طلبك الأول.

المتطلبات الأساسية

• حساب Google.

• حساب على Google AdMob

• الإلمام بأساسيات REST والموافقة على الطلبات باستخدام OAuth 2.0

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

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

اختيار نوع مصادقة OAuth2	إذا كان ...
تطبيق الكمبيوتر	تُدير جميع حساباتك على AdMob API باستخدام حساب إداري واحد على أعلى مستوى. إذا كنت مستخدمًا للمرة الأولى أو أردت البدء بسرعة باستخدام أبسط عملية إعداد يصادق تطبيقك على مستخدمي Google AdMob من جهاز واحد فقط.
تطبيق الويب	تريد المصادقة كمستخدم يمكنه منح تطبيقك الإذن بالوصول إلى بيانات حسابك على AdMob API. إذا أردت إنشاء بيانات اعتماد تفويض متعدّدة بسهولة، وذلك لإدارة حسابات تابعة لجهات خارجية مثلاً. يتطلّب تطبيقك عناوين URL لمعاودة الاتصال، وهي غير متاحة في مسار تطبيق سطح المكتب.

إنشاء مشروع

لبدء استخدام AdMob API، عليك أولاً إنشاء مشروع أو اختيار مشروع في Google API Console وتفعيل واجهة برمجة التطبيقات باستخدام أداة الإعداد التي تقدّم لك إرشادات خلال العملية وتفعّل AdMob API تلقائيًا.

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

ترشدك التعليمات التالية خلال عملية إنشاء معرّف عميل OAuth 2.0 لاستخدامه مع مسار التطبيق المثبَّت.

1. انتقِل إلى صفحة العملاء.

2. انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.

   إذا لم يسبق لك ضبط شاشة طلب الموافقة لبروتوكول OAuth لهذا المشروع، سيتم توجيهك إلى إجراء ذلك الآن. انقر على إعداد شاشة الموافقة. تتوفّر عدة طرق لضبط شاشة طلب الموافقة لاستخدام معرّف عميل OAuth 2.0.

   1. اضبط نوع المستخدم على خارجي وحالة النشر على تم النشر.

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

      يمكنك الاطّلاع على معلومات إضافية حول إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.

3. اختَر تطبيق سطح المكتب أو تطبيق الويب كنوع التطبيق، وأدخِل اسمًا له، ثم انقر على إنشاء.

بعد الانتهاء، سيظهر لك معرّف عميل OAuth 2.0 ورمز سري للعميل، ويمكنك تنزيلهما بتنسيق JSON وحفظهما لاستخدامهما لاحقًا.

تقديم طلب

تم إنشاء واجهة AdMob API استنادًا إلى HTTP وJSON، ما يتيح لأي عميل HTTP عادي إرسال طلبات إلى الواجهة وتحليل استجاباتها. في المقابل، توفّر مكتبات عملاء واجهة Google API نتائج أفضل على مستوى التكامل اللغوي والأمان المعزَّز، كما تتيح إجراء الطلبات التي تحتاج إلى إذن من المستخدم. تتوفّر مكتبات البرامج بعدّة لغات برمجة. ويغنيك استخدام هذه المكتبات عن إعداد طلبات HTTP وتحليل الاستجابات يدويًا.

بعد إنشاء بيانات اعتماد OAuth 2.0، يمكنك البدء في استخدام واجهة برمجة التطبيقات AdMob API. لطلب الوصول باستخدام بروتوكول OAuth 2.0، يحتاج تطبيقك أيضًا إلى معلومات عن النطاق:

النطاق	المعنى
https://www.googleapis.com/auth/admob.readonly	الاطّلاع على جميع بيانات AdMob وقد يشمل ذلك معلومات الحساب وإعدادات المستودع الإعلاني والتوسّط والتقارير والبيانات الأخرى. ولا يتضمّن ذلك البيانات الحسّاسة، مثل الدفعات أو تفاصيل الحملة.
https://www.googleapis.com/auth/admob.report	الاطّلاع على تقارير أداء الإعلانات والأرباح اطّلِع على رقم تعريف الناشر والمنطقة الزمنية ورمز العملة التلقائي.

يمكنك تقديم طلبك الأول لإنشاء تقرير باستخدام الأمثلة في Java أو PHP أو Python أو curl.

إبطال الرموز المميزة المشترَكة

يمكنك إبطال الرموز المميزة المشترَكة بطريقتَين:

1. انتقِل إلى صفحة أذونات حسابك على Google وأبطِل الوصول من المشروع المعنيّ.

2. بدلاً من ذلك، يمكنك إبطال رموز تطبيقات الويب باستخدام Google Identity API.