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 pedidos garantidos que são acessíveis ao usuário atual.
A ordem é definida pelo parâmetro orderBy. Se um filter de 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/v1/guaranteedOrders
Tamanho da página solicitada. O valor precisa estar entre 1 e 200. Se não for especificado, o padrão será 100.
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 classificará 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, use o sufixo "desc" deve ser adicionado ao nome do campo. Por exemplo, displayName desc.
filter
string
Permite filtrar por campos de pedido garantido.
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 em qual entidade do DV360 a solicitação está sendo feita. A solicitação LIST vai retornar somente entidades de pedido garantido que podem ser acessadas pela 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 seguinte para o método guaranteedOrders.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."],[[["\u003cp\u003eDisplay & Video 360 API v1 is sunset and this document outlines the \u003ccode\u003eguaranteedOrders.list\u003c/code\u003e method within it.\u003c/p\u003e\n"],["\u003cp\u003eThis method allows users to retrieve a list of guaranteed orders accessible to them, applying optional filtering and sorting.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made via a GET request to a specific endpoint with parameters controlling page size, order, and filtering criteria.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated, providing a token for retrieving subsequent pages, and include an array of \u003ccode\u003eGuaranteedOrder\u003c/code\u003e objects.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope for OAuth 2.0.\u003c/p\u003e\n"]]],[],null,[]]