Method: sellers.adUnits.list

Elenca le unità pubblicitarie.

  • Ad esempio GET /v1/sellers/seller111/adUnits
  • Restituisce un elenco di unità pubblicitarie e un token per recuperare la pagina successiva in caso di esito positivo.
  • Restituisce il codice di errore PERMISSION_DENIED se l'utente non ha accesso all'ID venditore o venditore non esistente.
  • Restituisce il codice di errore INVALID_ARGUMENT se i venditori forniscono una dimensione di pagina o un token di pagina non validi.

Richiesta HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il venditore proprietario di questa raccolta di unità pubblicitarie. Formato: sellers/{seller}

Parametri di query

Parametri
pageSize

integer

Il numero massimo di articoli da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Il numero massimo consentito di unità pubblicitarie è 1000. valori superiori a 1000 verranno modificati in 1000. Se questo valore non è specificato, verranno restituite al massimo 1000 unità pubblicitarie.
pageToken

string

Il valore nextPageToken restituito da una precedente richiesta List, se presente.
filter

string

Il filtro elenco. Attualmente supporta i filtri degli ID e dello stato esterni, con la sintassi: "externalId = [EXTERNAL_ID]" e "state = [STATE]". Per concatenare i filtri si possono utilizzare gli operatori logici AND e OR. AD_UNIT_STATE_DELETED non può essere utilizzato per mostrare le unità pubblicitarie eliminate. Usa il comando showeliminato.
orderBy

string

L'ordine per stringa utilizzata per specificare l'ordinamento dei risultati. Attualmente è supportato l'ordinamento per updateTime; fornisci "updateTime" per ottenere i risultati ordinati per updateTime in ordine crescente o "updateTime desc" per l'ordine decrescente.
showDeleted

boolean

Indica se restituire unità pubblicitarie eliminate temporaneamente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per InventoryService.ListAdUnits.

Rappresentazione JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Campi
adUnits[]

object (AdUnit)

L'elenco delle unità pubblicitarie.
nextPageToken

string

Un token per recuperare la pagina successiva di risultati. Passa questo valore nel campo pageToken nella chiamata successiva al metodo adUnits.list per recuperare la pagina dei risultati successiva.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.