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

ملاحظة مهمة: ستؤثّر أدوار وأذونات المستخدمين الجديدة في البيانات التي تعرضها واجهة برمجة تطبيقات AdMob. مزيد من المعلومات

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

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

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

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

• حساب Google.

• حساب على Google AdMob

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

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

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

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

نقطة أساسية: سيظل بإمكانك اختيار مسار تطبيق سطح المكتب حتى إذا كنت بصدد تطوير تطبيق سيتم تشغيله على خادم. ويكمن الاختلاف في ما إذا كان يتم إكمال تفويض OAuth محليًا أو عن بُعد. يتطلّب تنفيذ عملية تخويل في تطبيق على الكمبيوتر المكتبي إكمالها على الجهاز المحلي، بينما تتيح عملية التخويل على الويب إكمالها على خادم التخويل التابع لـ Google.

إنشاء مشروع

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

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

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

ملاحظة: عند تفعيل مسار OAuth للمرة الأولى، سيُطلب منك تقديم معرّف الناشر على AdMob وقبول طلب الإذن في المتصفّح. قبل قبول الدعوة، تأكَّد من تسجيل الدخول باستخدام حساب Google لديه إذن الوصول إلى حسابك على AdMob. بعد ذلك، يتم منح تطبيقك الإذن بالوصول إلى البيانات نيابةً عن أي حساب تم تسجيل الدخول إليه حاليًا.

بعد إنشاء بيانات اعتماد 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.