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

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

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

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

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

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

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

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

إنشاء مشروع

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

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

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

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

  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 API استنادًا إلى HTTP وJSON، ما يتيح لأي عميل HTTP عادي إرسال طلبات إلى الواجهة وتحليل استجاباتها. في المقابل، توفّر مكتبات عملاء واجهة برمجة التطبيقات في Google نتائج أفضل على مستوى التكامل اللغوي وأمان مُحسَّنًا، كما تتيح إمكانية إجراء الطلبات المعتمَدة. تتوفر مكتبات العميل بعدد من لغات البرمجة، ويغنيك استخدامها عن إعداد طلبات 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.