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.
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.}
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:
[null,null,["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v2 is sunset.\u003c/p\u003e\n"],["\u003cp\u003eChannels are custom groups of related websites and apps that can be targeted by line items.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage channels by creating, retrieving, listing, and updating them using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eA channel can be owned by either a partner or an advertiser, identified by their respective IDs.\u003c/p\u003e\n"],["\u003cp\u003eChannels contain key properties including a name, ID, display name, and counts of positively and negatively targeted line items.\u003c/p\u003e\n"]]],["The document outlines the structure and actions for managing channels within the Display & Video 360 API. A channel represents a custom group of websites/apps. Key data includes the channel's ID, display name, and the number of positively/negatively targeted line items. Ownership is linked to either a partner or advertiser ID. The available actions are to create, retrieve, list, and update channels, using their associated methods. The schema is detailed, defining fields like channelId and displayName.\n"],null,["# REST Resource: partners.channels\n\n| Display \\& Video 360 API v2 has sunset.\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/v2/partners.channels/create) | Creates a new channel. |\n| ### [get](/display-video/api/reference/rest/v2/partners.channels/get) | Gets a channel for a partner or advertiser. |\n| ### [list](/display-video/api/reference/rest/v2/partners.channels/list) | Lists channels for a partner or advertiser. |\n| ### [patch](/display-video/api/reference/rest/v2/partners.channels/patch) | Updates a channel. |"]]
