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 os pedidos garantidos acessíveis ao usuário atual.
A ordem é definida pelo parâmetro orderBy. Se um filter por entityStatus não for especificado, os pedidos garantidos com status de entidade ENTITY_STATUS_ARCHIVED não serão incluídos nos resultados.
Solicitação HTTP
GET https://displayvideo.googleapis.com/v3/guaranteedOrders
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 guaranteedOrders.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 pedidos garantidos.
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 (=).
Identifica a entidade do DV360 em que a solicitação está sendo feita. A solicitação LIST só vai retornar entidades de pedidos garantidos que são 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 guaranteedOrders.list para recuperar a próxima página de resultados.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eLists guaranteed orders accessible to the current user, filterable by order ID, exchange, display name, and entity status.\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 \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of guaranteed orders and a token for retrieving the next page of results, if available.\u003c/p\u003e\n"],["\u003cp\u003eAccessible via a \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/guaranteedOrders\u003c/code\u003e.\u003c/p\u003e\n"]]],["This document outlines how to retrieve a list of guaranteed orders via an HTTP GET request to `https://displayvideo.googleapis.com/v3/guaranteedOrders`. Key actions include setting optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` to customize the results. `partnerId` or `advertiserId` are required parameters. The response includes a list of `guaranteedOrders` and a `nextPageToken` for pagination. Filtering by fields like `entityStatus` is possible, and specific authorization scopes are needed. The request body should be empty.\n"],null,[]]
