Method: mediaPlanners.list

Elenca tutti gli account di pianificazione media a cui il chiamante ha accesso.

Per i curatori, verranno restituiti tutti i pianificatori media che hanno accettato i termini del curatore.

Per gli altri account, il tentativo di elencare i pianificatori media restituirà un errore.

Richiesta HTTP

GET https://curationpartners.googleapis.com/v1/mediaPlanners

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
pageSize

integer

Il numero massimo di pianificatori media da restituire. Se non specificato, verranno restituiti al massimo 100 pianificatori media. Il valore massimo è 500; i valori superiori a 500 verranno forzati a 500.
pageToken

string

Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.Questo valore viene ricevuto da una chiamata mediaPlanners.list precedente in ListMediaPlannersResponse.nextPageToken.
filter

string

Stringa di query facoltativa che utilizza la sintassi di filtro dell'elenco delle API Cloud. Le colonne supportate per il filtro sono:

  • name
  • displayName
  • ancestorNames

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Una risposta contenente le informazioni dell'account di pianificazione media.

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

Rappresentazione JSON 
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
Campi
mediaPlanners[]

object (MediaPlanner)

Elenco dei pianificatori media.
nextPageToken

string

Un token che può essere passato a una chiamata successiva al metodo mediaPlanners.list per recuperare la pagina successiva dei risultati in ListMediaPlannersRequest.page_token.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/curation-partners

MediaPlanner

Rappresenta un account di pianificazione media.

Rappresentazione JSON 
{
  "accountId": string,
  "name": string,
  "displayName": string,
  "ancestorNames": [
    string
  ]
}
Campi
accountId
(deprecated)

string

Solo output. ID account del pianificatore media.
name

string

Identificatore. Il nome della risorsa univoca del pianificatore media. Formato: mediaPlanners/{mediaPlannerAccountId}. Può essere utilizzato per filtrare la risposta del metodo mediaPlanners.list.
displayName

string

Solo output. Il nome visualizzato del pianificatore media. Può essere utilizzato per filtrare la risposta del metodo [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners].
ancestorNames[]

string

Solo output. I nomi degli antenati del pianificatore media. Formato: mediaPlanners/{mediaPlannerAccountId}. Può essere utilizzato per filtrare la risposta del metodo mediaPlanners.list.