Method: mediaPlanners.list

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

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

Bei anderen Konten wird beim Versuch, Media Planner aufzulisten, ein Fehler zurückgegeben.

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 Media Planner. Wenn nicht angegeben, werden maximal 100 Media Planner zurückgegeben. Der Maximalwert ist 500. Werte über 500 werden auf 500 festgelegt.
pageToken

string

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

string

Optionaler Suchstring mit der Syntax für die Listenfilterung der Cloud API. Folgende Spalten können gefiltert werden:

  • name
  • displayName
  • ancestorNames

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Antwort mit Informationen zum Media Planner-Konto.

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

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

object (MediaPlanner)

Liste der Media Planner.
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

MediaPlanner

Stellt ein Media Planner-Konto dar.

JSON-Darstellung 
{
  "accountId": string,
  "name": string,
  "displayName": string,
  "ancestorNames": [
    string
  ]
}
Felder
accountId
(deprecated)

string

Nur Ausgabe. Konto-ID des Media Planner.
name

string

ID. Der eindeutige Ressourcenname des Media Planner. Format: mediaPlanners/{mediaPlannerAccountId}. Kann verwendet werden, um die Antwort der Methode mediaPlanners.list zu filtern.
displayName

string

Nur Ausgabe. Der Anzeigename des Media Planner. Kann verwendet werden, um die Antwort der Methode [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners] zu filtern.
ancestorNames[]

string

Nur Ausgabe. Die Namen der Vorgänger des Media Planner. Format: mediaPlanners/{mediaPlannerAccountId}. Kann verwendet werden, um die Antwort der Methode mediaPlanners.list zu filtern.