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 v1 is no longer supported.\u003c/p\u003e\n"],["\u003cp\u003eChannels are custom groupings of related websites and apps, allowing for targeted advertising.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage channels by creating, retrieving, listing, and updating them through dedicated API methods.\u003c/p\u003e\n"],["\u003cp\u003eA channel's ownership can be attributed to either a partner or an advertiser, indicated by respective IDs.\u003c/p\u003e\n"],["\u003cp\u003eEssential channel data like name, ID, display name, and targeted line item counts are accessible.\u003c/p\u003e\n"]]],["Channels, custom groups of related websites and apps, are defined by a `name`, `channelId`, and `displayName`. Channels also track `positivelyTargetedLineItemCount` and `negativelyTargetedLineItemCount`. Each channel is owned by either a `partnerId` or an `advertiserId`. Actions include creating a channel, retrieving a specific channel, listing channels associated with an entity and updating an existing channel. The Display & Video 360 API v1 is no longer active.\n"],null,["# REST Resource: advertisers.channels\n\n| Display \\& Video 360 API v1 has been 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/v1/advertisers.channels/create) | Creates a new channel. |\n| ### [get](/display-video/api/reference/rest/v1/advertisers.channels/get) | Gets a channel for a partner or advertiser. |\n| ### [list](/display-video/api/reference/rest/v1/advertisers.channels/list) | Lists channels for a partner or advertiser. |\n| ### [patch](/display-video/api/reference/rest/v1/advertisers.channels/patch) | Updates a channel. |"]]
