محولات

تتيح واجهة برمجة تطبيقات AdMob إمكانية إدراج محوّلات التوسّط آليًا. يُرجى الاطّلاع على accounts.adSources.adapters.list لمزيد من المعلومات. تتضمّن المحوّلات تفاصيل حول إعدادات المحوّلات الخارجية.

أمثلة

بعد إنشاء بيانات اعتماد OAuth 2.0، يمكنك البدء في استخدام واجهة برمجة تطبيقات AdMob. لطلب الدخول باستخدام بروتوكول OAuth 2.0، سيحتاج تطبيقك أيضًا إلى معلومات عن النطاق.

في ما يلي معلومات عن نطاق OAuth 2.0:

النطاق	المعنى
https://www.googleapis.com/auth/admob.monetization	الاطّلاع على إعدادات تحقيق الربح المادي في AdMob وإنشاؤها وتعديلها
https://www.googleapis.com/auth/admob.readonly	الاطّلاع على جميع بيانات AdMob وقد يتضمّن ذلك معلومات الحساب وإعدادات المستودع والتوسّط والتقارير والبيانات الأخرى. ولا يتضمّن ذلك البيانات الحسّاسة، مثل الدفعات أو تفاصيل الحملة.

‫curl (سطر الأوامر)

الطلبات باستخدام curl

1. تحميل ملف الأسرار وإنشاء بيانات اعتماد التفويض

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

   للمصادقة والتفويض، ننصحك باستخدام oauth2l، وهي أداة بسيطة لسطر الأوامر للتعامل مع بروتوكول Google OAuth 2.0. ثبِّت أداة oauth2l وشغِّل الأمر أدناه، مع استبدال path_to_credentials_json بمسار يؤدي إلى ملف credentials.json الذي تنزّله عند تسجيل تطبيقك المستند إلى السحابة الإلكترونية. في التشغيل الأول، يرشدك الأمر خلال عملية تفويض OAuth 2.0. وفي عمليات التشغيل اللاحقة، يتم تلقائيًا إعادة تحميل الرمز المميّز.

   oauth2l header --json path_to_credentials_json --scope admob.readonly
   

2. إدراج المحوّلات

   يمكنك الحصول على معلومات عن محوّل AdMob من خلال استبدال pub-XXXXXXXXXXXXXXXX بالرقم التعريفي للناشر. تعرَّف على كيفية العثور على الرقم التعريفي للناشر.

   استبدِل SSSSSSSSSSSSSSSSSSSS بمعرّف مصدر الإعلان للمحوّلات التي تهمّك.

   استخدِم الأمر التالي للحصول على قائمة بالمحوّلات:

   curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
    -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
   

   في ما يلي نموذج استجابة لمصدر إعلانات "شبكة AdMob" الذي يحمل المعرّف 5450213213286189855:

   {
    "adapters": [
     {
        "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
        "adapterId": "1",
        "title": "AdMob Network Android SDK",
        "platform": "ANDROID",
        "formats": ["BANNER", "INTERSTITIAL",
          "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
        "adapterConfigMetadata": [{
          "adapterConfigMetadataId": "118",
          "adapterConfigMetadataLabel": "Ad unit ID"
        }]
     },
     {
        "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
        "adapterId": "2",
        "title": "AdMob Network iOS SDK",
        "platform": "ANDROID",
        "formats": ["BANNER", "INTERSTITIAL",
          "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
        "adapterConfigMetadata": [{
          "adapterConfigMetadataId": "119",
          "adapterConfigMetadataLabel": "Ad unit ID"
        }]
     }]
   }