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.
Lista as fontes de inventário acessíveis ao usuário atual.
A ordem é definida pelo parâmetro orderBy. Se um filter por entityStatus não for especificado, as origens de inventário com o status de entidade ENTITY_STATUS_ARCHIVED não serão incluídas nos resultados.
Solicitação HTTP
GET https://displayvideo.googleapis.com/v3/inventorySources
Tamanho da página solicitada. O valor precisa estar entre 1 e 200. Se não for especificado, 100 será usado como padrão.
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 inventorySources.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)
A ordem de classificação padrão é crescente. Para especificar a ordem decrescente de um campo, adicione o sufixo "desc" ao nome dele. Por exemplo, displayName desc.
filter
string
Permite filtrar por campos de origem de inventário.
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}.
Todos os campos precisam usar o operador EQUALS (=).
Campos compatíveis:
status.entityStatus
commitment
deliveryMethod
rateDetails.rateType
exchange
Exemplos:
Todas as origens de inventário ativas: status.entityStatus="ENTITY_STATUS_ACTIVE"
Origens de inventário pertencentes às trocas do Google Ad Manager ou da Rubicon: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"
O comprimento deste campo não pode exceder 500 caracteres.
Parâmetro de união accessor. Obrigatório. Identifica a entidade do DV360 em que a solicitação está sendo feita. A solicitação LIST só vai retornar entidades de origem de inventário que sejam acessíveis à entidade do DV360 identificada no accessor. accessor pode ser apenas de um dos tipos a seguir:
Um token para recuperar a próxima página de resultados. Transmita esse valor no campo pageToken na chamada subsequente para o método inventorySources.list para recuperar a próxima página de resultados.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eLists inventory sources accessible to the current user, ordered by \u003ccode\u003eorderBy\u003c/code\u003e parameter and excluding archived sources unless filtered.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving results in manageable chunks.\u003c/p\u003e\n"],["\u003cp\u003eOffers filtering options using the \u003ccode\u003efilter\u003c/code\u003e parameter for refining results based on entity status, commitment, delivery method, rate type, or exchange.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an \u003ccode\u003eaccessor\u003c/code\u003e (either \u003ccode\u003epartnerId\u003c/code\u003e or \u003ccode\u003eadvertiserId\u003c/code\u003e) to identify the DV360 entity for access control.\u003c/p\u003e\n"],["\u003cp\u003eUses \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/inventorySources\u003c/code\u003e and requires \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],["This API lists accessible inventory sources for a user via a `GET` request to `https://displayvideo.googleapis.com/v3/inventorySources`. Key parameters include `pageSize`, `pageToken`, `orderBy` for sorting, and `filter` for filtering by fields like `entityStatus`, `commitment`, or `exchange`. The request body must be empty. The response includes a list of inventory sources and a `nextPageToken` for pagination. The call requires authorization scope: `https://www.googleapis.com/auth/display-video`. A union parameter called `accessor` is required to identify the DV360 entity the request is being made from.\n"],null,[]]