Method: advertisers.inventorySources.list

Elenca i deal dell'origine dell'inventario.

Richiesta HTTP

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/inventorySources

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
Obbligatorio. Identifica l'entità DV360 all'interno della quale viene effettuata la richiesta. La richiesta LIST restituirà solo le entità dell'origine dell'inventario accessibili all'entità DV360 identificata all'interno di accessor. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
advertiserId

string (int64 format)

L'ID dell'inserzionista DV360.
Fine dei campi che si escludono a vicenda.

Parametri di query

Parametri
pageSize

integer

Facoltativo. Dimensioni della pagina richiesta. Il valore deve essere compreso tra 1 e 200. Se non specificato, il valore predefinito è 100.
pageToken

string

Facoltativo. 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 ListInventorySources. Se non specificato, verrà restituita la prima pagina dei risultati.
orderBy

string

Facoltativo. Campo in base al quale ordinare l'elenco. I valori accettabili sono:

  • displayName (valore predefinito)

L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente per un campo, è necessario aggiungere il suffisso "desc" al nome del campo. Ad esempio, displayName desc.
filter

string

Facoltativo. Consente di filtrare in base ai campi dell'origine dell'inventario.

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 il formato {field} {operator} {value}.
  • Tutti i campi devono utilizzare l'operatore EQUALS (=).

Campi supportati:

  • status.entityStatus
  • commitment
  • deliveryMethod
  • rateDetails.rateType
  • exchange

Esempi:

  • Tutte le origini dell'inventario attive: status.entityStatus="ENTITY_STATUS_ACTIVE"
  • Origini dell'inventario 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.

Per saperne di più, consulta la nostra guida su come filtrare le richieste LIST.
Obbligatorio. Identifica l'entità DV360 all'interno della quale viene effettuata la richiesta. La richiesta LIST restituirà solo le entità dell'origine dell'inventario accessibili all'entità DV360 identificata all'interno di accessor. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
partnerId

string (int64 format)

L'ID del partner DV360.
Fine dei campi che si escludono a vicenda.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di ListInventorySourceDealsResponse.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/display-video

Per saperne di più, consulta la OAuth 2.0 Overview.