自
2025 年 9 月 8 日起,每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 Display & Video 360 API 和 SDF 上傳的檔案未提供聲明,系統就會失敗。如要進一步瞭解如何更新整合服務以進行這項聲明,請參閱
淘汰項目頁面。
REST Resource: partners.channels
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:管道
單一管道。「頻道」是指自訂的相關網站和應用程式群組。
JSON 表示法 |
{
"name": string,
"channelId": string,
"displayName": string,
"positivelyTargetedLineItemCount": string,
"negativelyTargetedLineItemCount": string,
// Union field owner can be only one of the following:
"partnerId": string,
"advertiserId": string
// End of list of possible types for union field owner .
} |
欄位 |
name |
string
僅供輸出。頻道的資源名稱。
|
channelId |
string (int64 format)
僅供輸出。頻道的專屬 ID。由系統指派。
|
displayName |
string
必要欄位。頻道的顯示名稱。必須採用 UTF-8 編碼,長度上限為 240 位元組。
|
positivelyTargetedLineItemCount |
string (int64 format)
僅供輸出。直接指定這個頻道為正向目標的委刊項數量。
|
negativelyTargetedLineItemCount |
string (int64 format)
僅供輸出。直接指定這個管道為負向目標的委刊項數量。
|
聯集欄位 owner 。識別擁有頻道的 DV360 實體。可能是合作夥伴或廣告主。owner 只能是下列其中一項: |
partnerId |
string (int64 format)
擁有頻道的合作夥伴 ID。
|
advertiserId |
string (int64 format)
擁有頻道的廣告主 ID。
|
方法 |
|
建立新管道。 |
|
取得合作夥伴或廣告主的頻道。 |
|
列出夥伴或廣告主的頻道。 |
|
更新管道。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],["The Display & Video 360 API v4, in beta, features a \"Channel\" resource representing custom groups of websites and apps. Channels have a unique `channelId`, a `displayName`, and counts of positively/negatively targeted line items. Ownership is defined by either a `partnerId` or `advertiserId`. The API supports creating, retrieving, listing, and updating channels, enabling management of these custom groupings. Key actions are create, get, list, patch.\n"],null,["# REST Resource: partners.channels\n\n- [Resource: Channel](#Channel)\n - [JSON representation](#Channel.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Channel\n-----------------\n\nA single channel. Channels are custom groups of related websites and apps.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"channelId\": string, \"displayName\": string, \"positivelyTargetedLineItemCount\": string, \"negativelyTargetedLineItemCount\": string, // Union field `owner` can be only one of the following: \"partnerId\": string, \"advertiserId\": string // End of list of possible types for union field `owner`. } ``` |\n\n| Fields ||\n|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the channel. |\n| `channelId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the channel. Assigned by the system. |\n| `displayName` | `string` Required. The display name of the channel. Must be UTF-8 encoded with a maximum length of 240 bytes. |\n| `positivelyTargetedLineItemCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. Number of line items that are directly targeting this channel positively. |\n| `negativelyTargetedLineItemCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. Number of line items that are directly targeting this channel negatively. |\n| Union field `owner`. Identifies the DV360 entity that owns the channel. It can be either a partner or an advertiser. `owner` can be only one of the following: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the channel. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the channel. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------|---------------------------------------------|\n| ### [create](/display-video/api/reference/rest/v4/partners.channels/create) | Creates a new channel. |\n| ### [get](/display-video/api/reference/rest/v4/partners.channels/get) | Gets a channel for a partner or advertiser. |\n| ### [list](/display-video/api/reference/rest/v4/partners.channels/list) | Lists channels for a partner or advertiser. |\n| ### [patch](/display-video/api/reference/rest/v4/partners.channels/patch) | Updates a channel. |"]]