REST Resource: accounts.adUnits.adUnitMappings
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:AdUnitMapping
將 AdMob 廣告單元對應至第三方廣告單元的設定。
JSON 表示法 |
{
"name": string,
"adapterId": string,
"state": enum (State ),
"adUnitConfigurations": {
string: string,
...
},
"displayName": string
} |
欄位 |
name |
string
此廣告單元對應的資源名稱。 格式為:accounts/{publisherId}/adUnits/{ad_unit_id_fragment}/adUnitMappings/{adUnitMappings/{adUnitMappings},範例:accounts/pub-1234567890123456/adUnits/0123456789/adUnitMappings/987654321
|
adapterId |
string (int64 format)
這個廣告單元對應所使用的中介服務廣告來源轉接程式 ID。 轉接程式會決定 ad_network_settings 中需要的資訊。
|
state |
enum (State )
僅供輸出。這個廣告單元對應的狀態。
|
adUnitConfigurations |
map (key: string (int64 format), value: string)
用於向第三方廣告聯播網發出廣告請求的指定廣告單元設定。 使用者針對廣告聯播網要求的鍵/值組合,以及鍵/值組合。 如要進一步瞭解如何調整聯播網設定,請參閱 https://support.google.com/admob/answer/3245073。 這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" } 。
|
displayName |
string
選用設定。此廣告單元對應執行個體的顯示名稱。
|
州
廣告單元對應狀態。新建的廣告單元對應設為「已啟用」。
僅供輸出。
列舉 |
STATE_UNSPECIFIED |
預設值。 |
ENABLED |
廣告單元對應已啟用,並用於放送廣告或收集統計資料。 |
方法 |
|
在特定 AdMob 帳戶和廣告單元下,建立廣告單元對應。 |
|
列出指定 AdMob 帳戶和廣告單元下的廣告單元對應。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[null,null,["上次更新時間:2025-08-21 (世界標準時間)。"],[[["\u003cp\u003eAdUnitMapping settings allow you to link an AdMob ad unit to a third-party ad unit for mediation.\u003c/p\u003e\n"],["\u003cp\u003eThe mapping includes configurations like adapter ID, state (enabled/disabled), and custom network settings.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage these mappings through methods to create and list them for specific AdMob accounts and ad units.\u003c/p\u003e\n"],["\u003cp\u003eAd unit mappings start in an enabled state and can be used to serve ads or gather statistics.\u003c/p\u003e\n"]]],["AdUnitMapping resources connect AdMob ad units to third-party ad units. Key actions involve creating and listing these mappings. Each mapping includes a name, adapter ID, state (like ENABLED), and ad unit configurations—settings for the third-party ad network. The `displayName` is an optional name for the mapping. The `State` field indicates the mapping's status. `adUnitConfigurations` contains key-value pairs for the third party settings.\n"],null,["# REST Resource: accounts.adUnits.adUnitMappings\n\n- [Resource: AdUnitMapping](#AdUnitMapping)\n - [JSON representation](#AdUnitMapping.SCHEMA_REPRESENTATION)\n- [State](#State)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AdUnitMapping\n-----------------------\n\nSettings to map an AdMob ad unit to a 3rd party ad unit.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"adapterId\": string, \"state\": enum (/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings#State), \"adUnitConfigurations\": { string: string, ... }, \"displayName\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of this ad unit mapping. Format is: accounts/{publisherId}/adUnits/{ad_unit_id_fragment}/adUnitMappings/{adUnitMappingId} Example: accounts/pub-1234567890123456/adUnits/0123456789/adUnitMappings/987654321 |\n| `adapterId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of mediation ad source adapter used by this ad unit mapping. The adapter determines the information needed in the ad_network_settings. |\n| `state` | `enum (`[State](/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings#State)`)` Output only. The status of this ad unit mapping. |\n| `adUnitConfigurations` | `map (key: string (`[int64](https://developers.google.com/discovery/v1/type-format)` format), value: string)` Settings for the specified ad unit to make an ad request to 3rd party ad network. Key-value pairs with values set by the user for the keys requested by the ad network. Please see \u003chttps://support.google.com/admob/answer/3245073\u003e for details on how to configure the network settings. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `displayName` | `string` Optional. The display name of this ad unit mapping instance. |\n\nState\n-----\n\nStatus of the ad unit mapping. Newly created ad unit mapping is set to ENABLED.\n\nOutput only.\n\n| Enums ||\n|---------------------|--------------------------------------------------------------------------|\n| `STATE_UNSPECIFIED` | The default value. |\n| `ENABLED` | The ad unit mapping is active and used to serve ads or collecting stats. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|-------------------------------------------------------------------------|\n| ### [create](/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings/create) | Create an ad unit mapping under the specific AdMob account and ad unit. |\n| ### [list](/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings/list) | List ad unit mappings under the specified AdMob account and ad unit. |"]]