A API Display & Video 360 vai lançar o suporte a recursos de Geração de demanda para todos os parceiros a partir de 10 de junho de 2026. Confira nossa postagem do blog (em inglês) para saber como se preparar.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Obrigatório. O ID do anunciante a que os grupos de anúncios pertencem.
Parâmetros de consulta
Parâmetros
pageSize
integer
Opcional. Tamanho da página solicitada. Precisa estar entre 1 e 100. Se não for especificado, o padrão será 100. Retorna o código de erro INVALID_ARGUMENT se um valor inválido for especificado.
pageToken
string
Opcional. Um token que identifica a página de resultados que o servidor retornará. Normalmente, esse é o valor de nextPageToken retornado da chamada anterior ao método adGroupAds.list. Se não for especificado, a primeira página de resultados será retornada.
orderBy
string
Opcional. Campo que classifica a lista. Os valores aceitáveis são:
displayName (padrão)
entityStatus
A ordem de classificação padrão é crescente. Para especificar a ordem decrescente em um campo, um sufixo "desc" precisa ser adicionado ao nome dele. Exemplo: displayName desc.
filter
string
Opcional. Permite filtrar por campos personalizados de anúncios do grupo de anúncios.
Sintaxe aceita:
As expressões de filtro são compostas por uma ou mais restrições.
As restrições podem ser combinadas por AND e OR. Uma sequência de restrições usa AND implicitamente.
Uma restrição tem o formato {field} {operator} {value}.
Todos os campos precisam usar o operador EQUALS (=).
Campos compatíveis:
adGroupId
displayName
entityStatus
adGroupAdId
Exemplos:
Todos os anúncios do grupo de anúncios em um grupo: adGroupId="1234"
Todos os anúncios de um grupo de anúncios com um entityStatus de ENTITY_STATUS_ACTIVE ou ENTITY_STATUS_PAUSED: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
adGroupId="12345"
O comprimento deste 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 subsequente ao método adGroupAds.list para recuperar a próxima página de resultados.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-10-08 UTC."],[],["This document outlines the process of listing ad group ads via the `adGroupAds.list` method. It requires a `GET` request to a specific URL, using the advertiser's ID as a path parameter. Optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` enable pagination, sorting, and filtering. The request body must be empty. The response body will include a list of ad group ads and a `nextPageToken` for pagination. The process requires OAuth authorization with the `https://www.googleapis.com/auth/display-video` scope.\n"]]
