A partir de 8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão 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 suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
A ordem é definida pelo parâmetro orderBy. Se um filter por entityStatus não for especificado, os itens de linha com ENTITY_STATUS_ARCHIVED não serão incluídos nos resultados.
Solicitação HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems
Obrigatório. O ID do anunciante para quem os itens de linha serão listados.
Parâmetros de consulta
Parâmetros
pageSize
integer
Tamanho da página solicitada. O valor precisa estar entre 1 e 200. Se não for especificado, 100 será usado como padrão. 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 lineItems.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:
displayName (padrão)
entityStatus
updateTime
A ordem de classificação padrão é crescente. Para especificar a ordem decrescente de um campo, adicione o sufixo "desc" ao nome dele. Exemplo: displayName desc.
filter
string
Permite filtrar por campos de itens de linha.
Sintaxe aceita:
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 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 (=).
Campos compatíveis:
campaignId
displayName
entityStatus
insertionOrderId
lineItemId
lineItemType
updateTime (entrada no formato ISO 8601 ou YYYY-MM-DDTHH:MM:SSZ)
Exemplos:
Todos os itens de linha em um pedido de inserção: insertionOrderId="1234"
Todos os itens de linha ENTITY_STATUS_ACTIVE ou ENTITY_STATUS_PAUSED e LINE_ITEM_TYPE_DISPLAY_DEFAULT de um anunciante: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
Todos os itens de linha com um horário de atualização menor ou igual a 2020-11-04T18:54:47Z (formato ISO 8601): updateTime<="2020-11-04T18:54:47Z"
Todos os itens de linha 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 para o método lineItems.list para recuperar a próxima página de resultados.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eLists line items within a specified advertiser, ordered by \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by line item fields such as \u003ccode\u003ecampaignId\u003c/code\u003e, \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003einsertionOrderId\u003c/code\u003e, etc.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving large result sets.\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"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the endpoint \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
