A partire dall'8 settembre 2025, ogni nuovo elemento pubblicitario dovrà dichiarare se pubblicherà o meno annunci politici dell'Unione Europea (UE). I caricamenti di API Display & Video 360 e SDF che non forniscono dichiarazioni non andranno a buon fine. Consulta la nostra pagina dei ritiri per ulteriori dettagli su come aggiornare l'integrazione per effettuare questa dichiarazione.
Elenca gli ordini garantiti accessibili all'utente corrente.
L'ordine è definito dal parametro orderBy. Se non viene specificato un valore filter entro il giorno entityStatus, gli ordini garantiti con stato dell'entità ENTITY_STATUS_ARCHIVED non verranno inclusi nei risultati.
Richiesta HTTP
GET https://displayvideo.googleapis.com/v3/guaranteedOrders
Dimensioni della pagina richiesta. Il valore deve essere compreso tra 1 e 200. Se non specificato, il valore predefinito è 100.
pageToken
string
Un token che identifica una pagina di risultati che il server deve restituire. In genere, si tratta del valore di nextPageToken restituito dalla chiamata precedente al metodo guaranteedOrders.list. Se non specificato, verrà restituita la prima pagina di risultati.
orderBy
string
Campo in base al quale ordinare l'elenco. I valori accettabili sono:
displayName (valore predefinito)
L'ordinamento predefinito è crescente. Per specificare l'ordinamento decrescente per un campo, è necessario aggiungere un suffisso "desc" al nome del campo. Ad esempio, displayName desc.
filter
string
Consente di filtrare in base ai campi degli ordini garantiti.
Le espressioni di filtro sono composte da una o più limitazioni.
Le limitazioni possono essere combinate con gli operatori logici AND o OR. Una sequenza di restrizioni utilizza implicitamente AND.
Una restrizione ha la forma {field} {operator} {value}.
Tutti i campi devono utilizzare l'operatore EQUALS (=).
Tutti gli ordini garantiti attivi: status.entityStatus="ENTITY_STATUS_ACTIVE"
Ordini garantiti appartenenti alle piattaforme di scambio pubblicitario Google Ad Manager o Rubicon: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"
La lunghezza di questo campo non deve superare i 500 caratteri.
Identifica l'entità DV360 in cui viene effettuata la richiesta. La richiesta LIST restituirà solo le entità degli ordini garantiti accessibili all'entità DV360 identificata in accessor. accessor può essere solo uno dei seguenti:
Un token per recuperare la pagina di risultati successiva. Passa questo valore nel campo pageToken nella chiamata successiva al metodo guaranteedOrders.list per recuperare la pagina di risultati successiva.
[null,null,["Ultimo aggiornamento 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,[]]
