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

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

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

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

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

• حساب Google.

• حساب Google AdMob

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

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

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

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

إنشاء مشروع

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

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

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

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.