Ogni nuovo elemento pubblicitario deve 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. Per ulteriori dettagli, consulta la nostra pagina relativa ai ritiri.
Elenca gli ordini di inserzione di un inserzionista.
L'ordine è definito dal parametro orderBy. Se non viene specificato un filter entro il entityStatus, gli ordini di inserzione con ENTITY_STATUS_ARCHIVED non verranno inclusi nei risultati.
Richiesta HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders
Obbligatorio. L'ID dell'inserzionista per cui elencare gli ordini di inserzione.
Parametri di query
Parametri
pageSize
integer
Dimensioni della pagina richiesta. Il valore deve essere compreso tra 1 e 100. Se non specificato, il valore predefinito è 100. Restituisce il codice di errore INVALID_ARGUMENT se viene specificato un valore non valido.
pageToken
string
Un token che identifica una pagina di risultati che il server deve restituire. In genere, questo è il valore di nextPageToken restituito dalla chiamata precedente al metodo insertionOrders.list. Se non specificato, verrà restituita la prima pagina dei risultati.
orderBy
string
Campo in base al quale ordinare l'elenco. I valori accettabili sono:
"displayName" (predefinito)
"entityStatus"
"updateTime"
L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente per un campo, al nome del campo deve essere aggiunto il suffisso "desc". Esempio: displayName desc.
filter
string
Consente il filtraggio in base ai campi dell'ordine di inserzione.
Sintassi supportata:
Le espressioni di filtro sono costituite da una o più limitazioni.
Le limitazioni possono essere combinate con gli operatori logici AND o OR. Una sequenza di limitazioni utilizza implicitamente AND.
Una limitazione ha la forma di {field} {operator} {value}.
Il campo updateTime deve utilizzare gli operatori GREATER THAN OR EQUAL TO (>=) o LESS THAN OR EQUAL TO (<=).
Tutti gli altri campi devono utilizzare l'operatore EQUALS (=).
Campi supportati:
campaignId
displayName
entityStatus
updateTime (input in formato ISO 8601 o YYYY-MM-DDTHH:MM:SSZ)
Esempi:
Tutti gli ordini di inserzione di una campagna: campaignId="1234"
Tutti gli ordini di inserzione ENTITY_STATUS_ACTIVE o ENTITY_STATUS_PAUSED di un inserzionista: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED")
Tutti gli ordini di inserimento con un orario di aggiornamento inferiore o uguale a 2020-11-04T18:54:47Z (formato ISO 8601): updateTime<="2020-11-04T18:54:47Z"
Tutti gli ordini di inserimento con un orario di aggiornamento maggiore o uguale a 2020-11-04T18:54:47Z (formato ISO 8601): updateTime>="2020-11-04T18:54:47Z"
La lunghezza di questo campo non deve superare i 500 caratteri.
Un token per recuperare la pagina successiva dei risultati. Passa questo valore nel campo pageToken nella chiamata successiva al metodo insertionOrders.list per recuperare la pagina successiva dei risultati.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-10 UTC."],[[["\u003cp\u003eLists insertion orders, filterable by campaign ID, display name, entity status, and update time, within a specified advertiser.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large result sets via \u003ccode\u003epageToken\u003c/code\u003e and \u003ccode\u003epageSize\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eAllows sorting results by display name, entity status, or update time, with optional descending order.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a list of insertion orders and a token for fetching the next page if available.\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"]]],["This API endpoint lists insertion orders for a specified advertiser using a GET request. You must provide the `advertiserId` as a path parameter. You can filter the results using the `filter` query parameter, sort them using `orderBy`, and control pagination with `pageSize` and `pageToken`. The response includes a list of `insertionOrders` and a `nextPageToken` for pagination. Filtering allows for logical operators and various fields, including `entityStatus` and `updateTime`. The request body must be empty.\n"],null,[]]
