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 ao qual os grupos de anúncios pertencem.
Parâmetros de consulta
Parâmetros
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. Retorna o código de erro INVALID_ARGUMENT se um valor inválido for especificado.
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 youtubeAdGroupAds.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
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: displayName desc.
filter
string
Permite filtrar por campos personalizados de anúncios do grupo de anúncios do YouTube.
Sintaxe compatível:
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 de um grupo de anúncios: 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"
Um token para recuperar a próxima página de resultados. Transmita esse valor no campo pageToken na chamada seguinte para o método youtubeAdGroupAds.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-07-25 UTC."],[],["This API lists YouTube ad group ads via a `GET` request to `https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroupAds`. The `advertiserId` path parameter is required. Optional query parameters include `pageSize`, `pageToken`, `orderBy` (e.g., by displayName or entityStatus), and `filter` to refine the list (e.g., by adGroupId). The empty request body returns a response with a list of ad group ads and a `nextPageToken` for pagination, authorized through OAuth scope `https://www.googleapis.com/auth/display-video`.\n"]]
