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 ao qual 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, o padrão será 100.
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 classificará 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"
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\u003eLists advertisers accessible to the current user, filtered by partner ID and sorted according to specified criteria.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large lists of advertisers, using page tokens for navigation.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by advertiser properties like ID, display name, entity status, and update time using specific syntax.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eDisplay & Video 360 API v1 has been sunset and this documentation refers to its functionality prior to sunsetting.\u003c/p\u003e\n"]]],["This document outlines how to list advertisers accessible to a user via the Display & Video 360 API. The core action is making a `GET` request to `https://displayvideo.googleapis.com/v1/advertisers`. A required `partnerId` query parameter specifies the partner for which to list advertisers. Optional parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` refine the results. The response includes a list of advertisers and a `nextPageToken` for pagination. An OAuth scope is also required.\n"],null,[]]
