آداپتورها

رابط برنامه‌نویسی کاربردی AdMob قابلیت فهرست کردن آداپتورهای میانجی‌گری را به صورت برنامه‌نویسی شده دارد، برای اطلاعات بیشتر به accounts.adSources.adapters.list مراجعه کنید. آداپتورها شامل جزئیاتی در مورد پیکربندی آداپتورهای شخص ثالث هستند.

مثال‌ها

با ایجاد اعتبارنامه‌های OAuth 2.0 ، شما آماده استفاده از API AdMob هستید. برای درخواست دسترسی با استفاده از OAuth 2.0، برنامه شما به اطلاعات دامنه نیز نیاز دارد.

اطلاعات مربوط به محدوده‌ی OAuth 2.0 به شرح زیر است:

محدوده معنی
https://www.googleapis.com/auth/admob.monetization تنظیمات کسب درآمد AdMob خود را مشاهده، ایجاد و ویرایش کنید.
https://www.googleapis.com/auth/admob.readonly مشاهده همه داده‌های AdMob. این ممکن است شامل اطلاعات حساب، موجودی و تنظیمات واسطه‌گری، گزارش‌ها و سایر داده‌ها باشد. این شامل داده‌های حساس مانند پرداخت‌ها یا جزئیات کمپین نمی‌شود.

کرل (خط فرمان)

درخواست‌ها با استفاده از curl

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

    اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به API 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. آداپتورها را فهرست کنید.

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

    به جای SSSSSSSSSSSSSSSSSSSS ، شناسه منبع تبلیغ (ad source ID) آداپتورهای مورد نظر را قرار دهید.

    برای دریافت لیست آداپتورها از دستور زیر استفاده کنید:

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