بدء استخدام واجهة برمجة تطبيقات AdMob

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

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

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

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

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

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

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

إنشاء مشروع

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

تمكين واجهة برمجة التطبيقات لمشروع حالي

تنطبق الخطوات التالية على المستخدمين الذين لديهم مشروع حالي ويفضّلون تفعيل واجهة برمجة تطبيقات AdMob له يدويًا.

لتمكين واجهة برمجة التطبيقات لمشروعك:

  1. Open the API Library في Google API Console .
  2. If prompted, select a project, or create a new one. يسرد API Library جميع واجهات برمجة التطبيقات المتاحة ، مجمعة حسب عائلة المنتج والشعبية.
  3. إذا لم تكن واجهة برمجة التطبيقات التي تريد تمكينها مرئية في القائمة ، فاستخدم البحث للعثور عليها ، أو انقر فوق عرض الكل في عائلة المنتج التي تنتمي إليها.
  4. حدد واجهة برمجة التطبيقات التي تريد تمكينها ، ثم انقر فوق الزر تمكين .
  5. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

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

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

  1. Go to the Credentials page.
  2. انقر على إنشاء بيانات الاعتماد > معرّف عميل OAuth.

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

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

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

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

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

تقديم طلب

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

بعد إنشاء بيانات اعتماد OAuth 2.0، ستكون جاهزًا لبدء استخدام واجهة برمجة تطبيقات AdMob. لطلب الوصول باستخدام بروتوكول 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.