Method: mediaPlanners.list

Wyświetla listę wszystkich kont Media Planner, do których ma dostęp wywołujący.

W przypadku kuratorów ta metoda zwróci wszystkie konta Media Planner, które zaakceptowały warunki kuratora.

W przypadku innych kont próba wyświetlenia listy kont Media Planner spowoduje zwrócenie błędu.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba kont Media Planner do zwrócenia. Jeśli nie zostanie określona, zostanie zwróconych co najwyżej 100 kont Media Planner. Maksymalna wartość to 500. Wartości powyżej 500 zostaną zmienione na 500.
pageToken

string

Opcjonalnie. Token identyfikujący stronę wyników, którą serwer ma zwrócić.Ta wartość jest otrzymywana z poprzedniego wywołania mediaPlanners.list w ListMediaPlannersResponse.nextPageToken.
filter

string

Opcjonalny ciąg zapytania używający składni filtrowania listy Cloud API. Obsługiwane kolumny do filtrowania:

  • name
  • displayName
  • ancestorNames

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca informacje o koncie Media Planner.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
Pola
mediaPlanners[]

object (MediaPlanner)

Lista kont Media Planner.
nextPageToken

string

Token, który można przekazać do kolejnego wywołania metody mediaPlanners.list, aby pobrać następną stronę wyników w ListMediaPlannersRequest.page_token.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

MediaPlanner

Reprezentuje konto Media Planner.

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

string

Tylko dane wyjściowe. Identyfikator konta Media Planner.
name

string

Identyfikator. Unikalna nazwa zasobu Media Planner. Format: mediaPlanners/{mediaPlannerAccountId}. Może służyć do filtrowania odpowiedzi metody mediaPlanners.list.
displayName

string

Tylko dane wyjściowe. Nazwa wyświetlana konta Media Planner. Może służyć do filtrowania odpowiedzi metody [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners].
ancestorNames[]

string

Tylko dane wyjściowe. Nazwy przodków konta Media Planner. Format: mediaPlanners/{mediaPlannerAccountId}. Może służyć do filtrowania odpowiedzi metody mediaPlanners.list.