بدء استخدام واجهة برمجة تطبيقات 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.