آداپتورها
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
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
فایل اسرار مشتری را بارگیری کنید و اعتبارنامه مجوز ایجاد کنید.
اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب 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
آداپتورها را فهرست کنید.
اطلاعات آداپتور 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"
}]
}]
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe AdMob API allows programmatic listing of mediation adapters, including details on third-party configurations.\u003c/p\u003e\n"],["\u003cp\u003eTo use the AdMob API, OAuth 2.0 credentials with appropriate scope information (\u003ccode\u003eadmob.monetization\u003c/code\u003e or \u003ccode\u003eadmob.readonly\u003c/code\u003e) are required.\u003c/p\u003e\n"],["\u003cp\u003eYou can utilize \u003ccode\u003ecurl\u003c/code\u003e with OAuth 2.0 authentication to retrieve a list of adapters for a specific AdMob ad source.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides details like adapter name, ID, platform, supported ad formats, and configuration metadata.\u003c/p\u003e\n"]]],["The AdMob API allows programmatic listing of mediation adapters, including third-party configurations. Access requires OAuth 2.0 credentials and specific scopes like `admob.monetization` or `admob.readonly`. To use it with curl, users must first load client secrets and generate authorization credentials, potentially via `oauth2l`. Listing adapters requires the publisher ID and ad source ID in the API request, and will return the adapter information that includes details such as ID, Title, platform, and formats.\n"],null,["# Adapters\n\nThe AdMob API has the ability to list\n[mediation adapters](/admob/api/v1/adapters-reference)\nprogrammatically, see\n[`accounts.adSources.adapters.list`](/admob/api/reference/rest/v1beta/accounts.adSources.adapters/list)\nfor additional information. Adapters include details on third-party adapter\nconfigurations.\n\nExamples\n--------\n\nWith [OAuth 2.0 credentials created](/admob/api/v1/getting-started#credentials),\nyou're ready to start using the AdMob API. To request access using OAuth 2.0,\nyour application will also need the scope information.\n\nHere's the OAuth 2.0 scope information:\n\n\u003cbr /\u003e\n\n| Scope | Meaning |\n|------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/admob.monetization` | See, create, and edit your AdMob monetization settings. |\n| `https://www.googleapis.com/auth/admob.readonly` | See all AdMob data. This may include account information, inventory and mediation settings, reports, and other data. This doesn't include sensitive data, such as payments or campaign details. |\n\n\u003cbr /\u003e\n\n### curl (command line)\n\n### Requests using curl\n\n1. Load the [client secrets file](https://console.cloud.google.com/apis/credentials) and generate authorization\n credentials.\n\n The first time you perform this step you'll be asked to accept an\n authorization prompt in your browser. Before accepting, make sure you're\n signed in with a Google Account that has access to the AdMob API. Your\n app will be authorized to access data on behalf of whichever account is\n currently signed in.\n\n For authentication and authorization, we recommend using\n [oauth2l](//github.com/google/oauth2l), a simple command-line tool for\n working with Google OAuth 2.0. Install oauth2l and run the\n command below, replacing \u003cvar translate=\"no\"\u003epath_to_credentials_json\u003c/var\u003e with a path\n to a `credentials.json` file that you download when registering your\n cloud application. For the first run, the command walks you through the\n OAuth 2.0 authorization flow. Subsequent runs refresh the token\n automatically. \n\n ```\n oauth2l header --json path_to_credentials_json --scope admob.readonly\n ```\n2. List the adapters.\n\n Get AdMob adapter information by replacing \u003cvar translate=\"no\"\u003epub-XXXXXXXXXXXXXXXX\u003c/var\u003e\n with your publisher ID, see\n [how to find your publisher ID](//support.google.com/admob/answer/2784578).\n\n Replace \u003cvar translate=\"no\"\u003eSSSSSSSSSSSSSSSSSSSS\u003c/var\u003e with the ad source ID for the\n adapters of interest.\n\n Use the following command to get a list of adapters: \n\n ```\n curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \\\n -H \"$(oauth2l header --json path_to_credentials_json --scope admob.readonly)\"\n ```\n\n Sample response for the AdMob Network ad source with ID\n `5450213213286189855`: \n\n ```scdoc\n {\n \"adapters\": [\n {\n \"name\": \"accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1\",\n \"adapterId\": \"1\",\n \"title\": \"AdMob Network Android SDK\",\n \"platform\": \"ANDROID\",\n \"formats\": [\"BANNER\", \"INTERSTITIAL\",\n \"REWARDED\", \"NATIVE\", \"REWARDED_INTERSTITIAL\", \"APP_OPEN\"],\n \"adapterConfigMetadata\": [{\n \"adapterConfigMetadataId\": \"118\",\n \"adapterConfigMetadataLabel\": \"Ad unit ID\"\n }]\n },\n {\n \"name\": \"accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2\",\n \"adapterId\": \"2\",\n \"title\": \"AdMob Network iOS SDK\",\n \"platform\": \"ANDROID\",\n \"formats\": [\"BANNER\", \"INTERSTITIAL\",\n \"REWARDED\", \"NATIVE\", \"REWARDED_INTERSTITIAL\", \"APP_OPEN\"],\n \"adapterConfigMetadata\": [{\n \"adapterConfigMetadataId\": \"119\",\n \"adapterConfigMetadataLabel\": \"Ad unit ID\"\n }]\n }]\n }\n ```"]]
