A partir de
8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa
página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
REST Resource: partners.channels
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: canal
Um único canal. Os canais são grupos personalizados de sites e apps relacionados.
| Representação 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.
} |
| Campos |
name |
string
Apenas saída. O nome do recurso do canal.
|
channelId |
string (int64 format)
Apenas saída. O ID exclusivo do canal. Atribuído pelo sistema.
|
displayName |
string
Obrigatório. O nome de exibição do canal. Precisa ser codificado em UTF-8 com um comprimento máximo de 240 bytes.
|
positivelyTargetedLineItemCount |
string (int64 format)
Apenas saída. Número de itens de linha que segmentam diretamente este canal de forma positiva.
|
negativelyTargetedLineItemCount |
string (int64 format)
Apenas saída. Número de itens de linha que segmentam diretamente este canal de forma negativa.
|
Campo de união owner. Identifica a entidade do DV360 que é proprietária do canal. Pode ser um parceiro ou um anunciante. owner pode ser apenas de um dos tipos a seguir: |
partnerId |
string (int64 format)
O ID do parceiro proprietário do canal.
|
advertiserId |
string (int64 format)
O ID do anunciante proprietário do canal.
|
Métodos |
|
|
Cria um novo canal. |
|
|
Recebe um canal para um parceiro ou anunciante. |
|
|
Lista os canais de um parceiro ou anunciante. |
|
|
Atualiza um canal. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 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. |"]]
