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.
Obrigatório. O ID do parceiro a que os anunciantes buscados devem pertencer. O sistema só permite listar os anunciantes de um parceiro por vez.
pageSize
integer
Tamanho da página solicitada. O valor precisa estar entre 1 e 200. Se não for especificado, 100 será usado como padrão.
pageToken
string
Um token que identifica a página de resultados que o servidor retornará. Normalmente, esse é o valor de nextPageToken retornado da chamada anterior para o método advertisers.list. Se não for especificado, a primeira página de resultados será retornada.
orderBy
string
Campo que classifica a lista. Os valores aceitáveis são:
displayName (padrão)
entityStatus
updateTime
A ordem de classificação padrão é crescente. Para especificar a ordem decrescente de um campo, use o sufixo "desc" deve ser adicionado ao nome do campo. Por exemplo, displayName desc.
filter
string
Permite filtrar por campos do anunciante.
Sintaxe compatível:
As expressões de filtro são compostas por uma ou mais restrições.
As restrições podem ser combinadas por operadores lógicos AND ou OR.
Uma restrição tem o formato {field} {operator} {value}.
O campo updateTime precisa usar os operadores GREATER THAN OR EQUAL TO (>=) ou LESS THAN OR EQUAL TO (<=).
Todos os outros campos precisam usar o operador EQUALS (=).
Campos compatíveis:
advertiserId
displayName
entityStatus
updateTime (entrada no formato ISO 8601 ou YYYY-MM-DDTHH:MM:SSZ)
Exemplos:
Todos os anunciantes ativos de um parceiro: entityStatus="ENTITY_STATUS_ACTIVE"
Todos os anunciantes com um horário de atualização menor ou igual a 2020-11-04T18:54:47Z (formato ISO 8601): updateTime<="2020-11-04T18:54:47Z"
Todos os anunciantes com um horário de atualização maior ou igual a 2020-11-04T18:54:47Z (formato ISO 8601): updateTime>="2020-11-04T18:54:47Z"
O comprimento desse campo não pode exceder 500 caracteres.
Um token para recuperar a próxima página de resultados. Transmita esse valor no campo pageToken na chamada seguinte para o método advertisers.list para recuperar a próxima página de resultados.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThis page documents the \u003ccode\u003eadvertisers.list\u003c/code\u003e method, which retrieves a list of advertisers accessible to the current user within Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers are filtered by a required \u003ccode\u003epartnerId\u003c/code\u003e, allowing retrieval of advertisers belonging to a specific partner.\u003c/p\u003e\n"],["\u003cp\u003eResults can be sorted and paginated using query parameters such as \u003ccode\u003eorderBy\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003eAdvertiser\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for accessing subsequent result pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to list advertisers accessible to a user via the Display & Video 360 API. The core action is sending a `GET` request to `https://displayvideo.googleapis.com/v2/advertisers`. A required `partnerId` parameter specifies the relevant partner. Optional parameters include `pageSize`, `pageToken`, `orderBy` (for sorting), and `filter` for filtering results. The response returns a list of advertisers and a `nextPageToken` for pagination. The request body must be empty, and OAuth 2.0 is used for authorization.\n"],null,[]]
