آداپتورها

AdMob API توانایی فهرست کردن آداپتورهای میانجی را به صورت برنامه‌ریزی دارد، برای اطلاعات بیشتر به 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

1. فایل اسرار مشتری را بارگیری کنید و اعتبارنامه مجوز ایجاد کنید.

   اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب Google وارد سیستم شده اید که به AdMob API دسترسی دارد. برنامه شما مجاز خواهد بود از طرف هر حسابی که در حال حاضر وارد سیستم شده است به داده ها دسترسی داشته باشد.

   برای احراز هویت و مجوز، توصیه می کنیم از oauth2l ، یک ابزار خط فرمان ساده برای کار با Google OAuth 2.0 استفاده کنید. oauth2l را نصب کنید و دستور زیر را اجرا کنید و مسیری به فایل credentials.json که هنگام ثبت برنامه ابری خود دانلود می کنید جایگزین path_to_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"
        }]
     }]
   }