- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Lista os grupos de anúncios.
Solicitação HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
advertiserId |
Obrigatório. O ID do anunciante ao qual os grupos de anúncios pertencem. |
Parâmetros de consulta
Parâmetros | |
---|---|
pageSize |
Opcional. Tamanho da página solicitada. O valor precisa estar entre |
pageToken |
Opcional. Um token que identifica a página de resultados que o servidor retornará. Normalmente, esse é o valor de |
orderBy |
Opcional. Campo que classificará a lista. Os valores aceitáveis são:
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. Exemplo: |
filter |
Opcional. Permite filtrar por campos personalizados do grupo de anúncios. Sintaxe compatível:
Propriedades compatíveis:
Exemplos:
Esse campo não pode ter mais de 500 caracteres. Consulte nosso guia de solicitações de filtro de |
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 |
---|
{
"adGroups": [
{
object ( |
Campos | |
---|---|
adGroups[] |
A lista de grupos de anúncios. Esta lista estará ausente se estiver vazia. |
nextPageToken |
Um token para recuperar a próxima página de resultados. Transmita esse valor no campo |
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.