Cada novo item de linha precisa declarar se vai 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 descontinuações para mais detalhes.
A ordem é definida pelo parâmetro orderBy. Se uma filter por entityStatus não for especificada, os criativos com ENTITY_STATUS_ARCHIVED não serão incluídos nos resultados.
Solicitação HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/creatives
Obrigatório. O ID do anunciante para listar os criativos.
Parâmetros de consulta
Parâmetros
pageSize
integer
Tamanho da página solicitada. Precisa estar entre 1 e 200. 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 ao método creatives.list. Se não for especificado, a primeira página de resultados será retornada.
orderBy
string
Campo que classifica a lista. Os valores aceitáveis são:
creativeId (padrão)
createTime
mediaDuration
dimensions (classifica primeiro por largura e depois por altura)
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: createTime desc.
filter
string
Permite filtrar por campos do criativo.
Sintaxe aceita:
As expressões de filtro são compostas por uma ou mais restrições.
As restrições podem ser combinadas pelos 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 campo lineItemIds precisa usar o operador HAS (:).
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 (=).
Para os campos entityStatus, minDuration, maxDuration, updateTime e dynamic, pode haver no máximo uma restrição.
Campos compatíveis:
approvalStatus
creativeId
creativeType
dimensions (entrada na forma de {width}x{height})
dynamic
entityStatus
exchangeReviewStatus (entrada na forma de {exchange}-{reviewStatus})
lineItemIds
maxDuration (entrada na forma de {duration}s. Apenas segundos são aceitos)
minDuration (entrada na forma de {duration}s. Apenas segundos são aceitos)
updateTime (entrada no formato ISO 8601 ou YYYY-MM-DDTHH:MM:SSZ)
Observações:
Para updateTime, o valor do campo de um recurso de criativo reflete a última vez que um criativo foi atualizado, incluindo atualizações feitas pelo sistema (por exemplo, atualizações de revisão de criativo).
Exemplos:
Todos os criativos nativos: creativeType="CREATIVE_TYPE_NATIVE"
Todos os criativos ativos com dimensões 300 x 400 ou 50 x 100: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400"
OR dimensions="50x100")
Todos os criativos dinâmicos aprovados pelo AdX ou pela AppNexus, com duração mínima de 5 segundos e 200 ms: dynamic="true" AND minDuration="5.2s" AND
(exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED"
OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
Todos os criativos de vídeo associados ao ID do item de linha 1 ou 2: creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)
Encontrar criativos por vários IDs: creativeId=1 OR creativeId=2
Todos os criativos 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"
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 ListCreativesRequest para recuperar a próxima página de resultados. Se esse campo for nulo, significa que esta é a última página.
[[["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-09-09 UTC."],[[["\u003cp\u003eLists creatives, ordered by \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003emediaDuration\u003c/code\u003e, or \u003ccode\u003edimensions\u003c/code\u003e, for a given advertiser.\u003c/p\u003e\n"],["\u003cp\u003eFilter creatives by \u003ccode\u003eapprovalStatus\u003c/code\u003e, \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreativeType\u003c/code\u003e, \u003ccode\u003edimensions\u003c/code\u003e, \u003ccode\u003edynamic\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003eexchangeReviewStatus\u003c/code\u003e, \u003ccode\u003elineItemIds\u003c/code\u003e, \u003ccode\u003emaxDuration\u003c/code\u003e, \u003ccode\u003eminDuration\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eArchived creatives are excluded unless explicitly filtered for.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated, with control over page size and retrieval of subsequent pages using tokens.\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"]]],[],null,[]]
