محولات

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

أمثلة

بعد إنشاء بيانات اعتماد OAuth 2.0، يمكنك البدء في استخدام AdMob API. لطلب الوصول باستخدام بروتوكول 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 API. سيتم تفويض تطبيقك بالوصول إلى البيانات نيابةً عن الحساب الذي تم تسجيل الدخول إليه حاليًا.

   للمصادقة والتفويض، ننصحك باستخدام 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"
        }]
     }]
   }