هذا الدليل مخصَّص للمطوّرين الذين يريدون استخدام واجهة برمجة تطبيقات AdMob للحصول على معلومات آليًا عن حساباتهم على AdMob.
يجب تفويض جميع طلبات البيانات من Google AdMob API من خلال OAuth2 حتى يتمكّن تطبيقك من التفاعل مع خدمات الويب بالنيابة عن المستخدم. يُمكِّن OAuth2 تطبيق عميل واجهة برمجة تطبيقات AdMob من الوصول إلى حساب مستخدم في AdMob دون الحاجة إلى معالجة أو تخزين اسم المستخدم أو كلمة المرور. للحصول على نظرة عامة حول التفويض، يُرجى الاطّلاع على التفويض.
اتّبِع الخطوات التالية لإنشاء بيانات اعتماد OAuth2 وتقديم الطلب الأول.
المتطلبات الأساسية
تحديد نوع المصادقة
اطّلِع على الجدول أدناه لمعرفة نوع المصادقة الأنسب لتطبيقك:
| اختيار نوع مصادقة OAuth2 | إذا ... |
|---|---|
| تطبيق الكمبيوتر المكتبي |
|
| تطبيق الويب |
|
إنشاء مشروع
لبدء استخدام AdMob API، عليك أولاً إنشاء أو اختيار مشروع في "وحدة تحكّم واجهة برمجة تطبيقات Google" وتفعيل واجهة برمجة التطبيقات باستخدام أداة الإعداد، التي تقدّم لك إرشادات خلال العملية وتُفعِّل AdMob API تلقائيًا.
تفعيل واجهة برمجة التطبيقات لمشروع حالي
تنطبق الخطوات التالية على المستخدمين الذين لديهم مشروع حالي ويفضّلون تفعيل AdMob API له يدويًا.
لتمكين واجهة برمجة التطبيقات لمشروعك:
- Open the API Library في Google API Console .
- If prompted, select a project, or create a new one. يسرد API Library جميع واجهات برمجة التطبيقات المتاحة ، مجمعة حسب عائلة المنتج والشعبية.
- إذا لم تكن واجهة برمجة التطبيقات التي تريد تمكينها مرئية في القائمة ، فاستخدم البحث للعثور عليها ، أو انقر فوق عرض الكل في عائلة المنتج التي تنتمي إليها.
- حدد واجهة برمجة التطبيقات التي تريد تمكينها ، ثم انقر فوق الزر تمكين .
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
إنشاء بيانات اعتماد OAuth2
سترشدك التعليمات التالية خلال عملية إنشاء معرّف مستخدم OAuth 2.0 لاستخدامه مع مسار التطبيق المثبّت.
- Go to the Credentials page.
انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
إذا لم يسبق لك ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لهذا المشروع، سيتم توجيهك إلى إجراء ذلك الآن. انقر على ضبط شاشة الموافقة. تتوفّر عدة طرق لإعداد شاشة الموافقة من أجل استخدام معرِّف عميل OAuth 2.0.
- اضبط نوع المستخدم على خارجي وحالة النشر على منشور.
أو يمكنك ضبط نوع المستخدم على خارجي وحالة النشر على اختبار، ثم إضافة مستخدمين اختباريين من خلال اختيار إضافة مستخدمين لمنحهم إذن الوصول لاستخدام معرّف عميل OAuth 2.0.
اطّلِع على معلومات إضافية عن إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
اختَر تطبيق كمبيوتر مكتبي أو تطبيق ويب كنوع التطبيق، ثم أدخِل اسمًا له وانقر على إنشاء.
عند الانتهاء، سيظهر لك معرِّف عميل 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.
إبطال الرموز المميّزة المشتركة
يمكنك إبطال الرموز المميّزة المشتركة بطريقتَين:
انتقِل إلى صفحة أذونات حسابك على Google وأبطل إذن الوصول من المشروع ذي الصلة.
بدلاً من ذلك، يمكنك إبطال الرموز المميّزة لتطبيقات الويب باستخدام Google Identity API.