A API Display & Video 360 v1beta2 foi desativada. As solicitações para uma versão desativada podem retornar um erro.
É necessário usar a API Display & Video 360 v2. Consulte nosso guia de migração para ver as etapas de migração da v1 para a v2.
Method: advertisers.list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Lista os anunciantes acessíveis ao usuário atual.
A ordem é definida pelo parâmetro orderBy
.
É necessário usar um único partnerId
. A listagem entre parceiros não é compatível.
Solicitação HTTP
GET https://displayvideo.googleapis.com/v1beta2/advertisers
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
Parâmetros |
partnerId |
string (int64 format)
Obrigatório. O ID do parceiro a que os anunciantes buscados devem pertencer. O sistema só permite a listagem de anunciantes de um parceiro por vez.
|
pageSize |
integer
Tamanho da página solicitada. O valor precisa estar entre 1 e 100 . 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 pela 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 aceitos são:
displayName (padrão)
entityStatus
updateTime
A ordem de classificação padrão é crescente. Para especificar a ordem decrescente em um campo, adicione um sufixo "desc" ao nome dele. Por exemplo, displayName desc .
|
filter |
string
Permite filtrar por propriedades 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 sequência de restrições usa AND implicitamente.
- Uma restrição tem o formato
{field} {operator} {value} .
- O operador usado em
updateTime precisa ser GREATER THAN OR EQUAL TO (>=) ou LESS THAN OR EQUAL TO (<=) .
- O operador precisa ser
EQUALS (=) .
- Campos compatíveis:
advertiserId
displayName
entityStatus
updateTime (entrada no formato ISO 8601 ou AAAA-MM-DDTHH:MM:SSZ)
Exemplos:
- Todos os anunciantes ativos de um parceiro:
entityStatus="ENTITY_STATUS_ACTIVE"
- Todos os anunciantes com tempo de atualização menor ou igual a
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime<="2020-11-04T18:54:47Z"
- Todos os anunciantes com horário de atualização maior ou igual a
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime>="2020-11-04T18:54:47Z"
Esse campo não pode ter mais de 500 caracteres.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:
Representação JSON |
{
"advertisers": [
{
object (Advertiser )
}
],
"nextPageToken": string
} |
Campos |
advertisers[] |
object (Advertiser )
A lista de anunciantes. Esta lista estará ausente se estiver vazia.
|
nextPageToken |
string
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.
|
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/display-video
Para mais informações, consulte a Visão geral do OAuth 2.0.
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 2023-12-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Não contém as informações de que eu preciso"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Muito complicado / etapas demais"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Desatualizado"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema na tradução"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema com as amostras / o código"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Outro"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Fácil de entender"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Meu problema foi resolvido"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Outro"
}]