Adapters
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
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 資料。這些 AdMob 資料可能包含帳戶資訊、廣告空間和中介服務設定、報表以及其他資料。但不含付款或廣告活動詳細資料等這類機密資料。
|
curl (指令列)
使用 curl 提出要求
載入用戶端密鑰檔案並產生授權憑證。
首次執行這個步驟時，系統會要求您在瀏覽器中接受授權提示。接受前，請確認您已登入可存取 AdMob API 的 Google 帳戶。您的應用程式將獲得授權，可代表目前登入的任何帳戶存取資料。
如要進行驗證和授權，建議您使用 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
列出轉接器。
將 pub-XXXXXXXXXXXXXXXX 替換為發布商 ID，即可取得 AdMob 轉接器資訊，請參閱這篇文章，瞭解如何查看發布商 ID。
將 SSSSSSSSSSSSSSSSSSSS 替換為您感興趣的轉接程式廣告來源 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)"
範例回應：ID 為 5450213213286189855 的 AdMob 聯播網廣告來源：
{
"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"
}]
}]
}
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-31 (世界標準時間)。
[null,null,["上次更新時間：2025-08-31 (世界標準時間)。"],[[["\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 ```"]]
