Method: mediaPlanners.list

Listet alle Media Planner-Konten auf, auf die der Aufrufer Zugriff hat.

Für Kuratoren werden alle Mediaplaner zurückgegeben, die die Kuratorbedingungen akzeptiert haben.

Bei anderen Konten wird ein Fehler zurückgegeben, wenn versucht wird, Mediaplaner aufzulisten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Die maximale Anzahl der zurückzugebenden Mediaplaner. Wenn nicht angegeben, werden maximal 100 Mediaplaner zurückgegeben. Der Höchstwert beträgt 500. Höhere Werte werden implizit auf 500 umgewandelt.

pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.Dieser Wert wird von einem vorherigen mediaPlanners.list-Aufruf in ListMediaPlannersResponse.nextPageToken empfangen.

filter

string

Optionaler Abfragestring mit der Syntax zum Filtern von Cloud API-Listen. Folgende Spalten können gefiltert werden:

  • name
  • displayName
  • ancestorNames

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Antwort, die Informationen zum Mediaplaner-Konto enthält.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
Felder
mediaPlanners[]

object (MediaPlanner)

Liste der Mediaplaner.

nextPageToken

string

Ein Token, das an einen nachfolgenden Aufruf der Methode „mediaPlanners.list“ übergeben werden kann, um die nächste Ergebnisseite in ListMediaPlannersRequest.page_token abzurufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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