آداپتورها

‫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 (خط فرمان)

درخواست‌های استفاده از 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. آداپتورها را فهرست کنید.

   با جایگزین کردن pub-XXXXXXXXXXXXXXXX با شناسه ناشرتان، اطلاعات سازگار AdMob را دریافت کنید، در نحوه پیدا کردن شناسه ناشر ببینید.

   ‫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"
        }]
     }]
   }