Starting
September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our
deprecations page for more details on how to update your integration to make this declaration.
REST Resource: partners.channels
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Channel
A single channel. Channels are custom groups of related websites and apps.
| JSON representation |
{
"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.
} |
| Fields |
name |
string
Output only. The resource name of the channel.
|
channelId |
string (int64 format)
Output only. The unique ID of the channel. Assigned by the system.
|
displayName |
string
Required. The display name of the channel. Must be UTF-8 encoded with a maximum length of 240 bytes.
|
positivelyTargetedLineItemCount |
string (int64 format)
Output only. Number of line items that are directly targeting this channel positively.
|
negativelyTargetedLineItemCount |
string (int64 format)
Output only. Number of line items that are directly targeting this channel negatively.
|
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: |
partnerId |
string (int64 format)
The ID of the partner that owns the channel.
|
advertiserId |
string (int64 format)
The ID of the advertiser that owns the channel.
|
Methods |
|
|
Creates a new channel. |
|
|
Gets a channel for a partner or advertiser. |
|
|
Lists channels for a partner or advertiser. |
|
|
Updates a channel. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-27 UTC.
[null,null,["Last updated 2025-03-27 UTC."],[],["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. |"]]
