Method: mediaPlanners.list

Wyświetla listę wszystkich kont Planera mediów, do których dzwoniący ma dostęp.

W przypadku kuratorów spowoduje to zwrócenie wszystkich planistów mediów, którzy zaakceptowali warunki kuratora.

W przypadku innych kont próba wyświetlenia listy media plannerów spowoduje błąd.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba planerów mediów do zwrócenia. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 100 planerów mediów. 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 powinien zwrócić.Ta wartość jest otrzymywana z poprzedniego wywołania mediaPlanners.list w ListMediaPlannersResponse.nextPageToken.

filter

string

Opcjonalny ciąg zapytania korzystający ze składni filtrowania listy interfejsu Cloud API. Kolumny obsługiwane na potrzeby filtrowania:

  • name
  • displayName
  • ancestorNames

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca informacje o koncie media planner(ki).

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

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

object (MediaPlanner)

Lista media plannerów.

nextPageToken

string

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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