Method: mediaPlanners.list

Mencantumkan semua akun perencana media yang dapat diakses pemanggil.

Untuk kurator, tindakan ini akan menampilkan semua perencana media yang telah menyetujui persyaratan kurator.

Untuk akun lain, upaya mencantumkan perencana media akan menampilkan error.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
pageSize

integer

Jumlah maksimum perencana media yang akan ditampilkan. Jika tidak ditentukan, paling banyak 100 perencana media akan ditampilkan. Nilai maksimumnya adalah 500; nilai di atas 500 akan dipaksa menjadi 500.
pageToken

string

Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan server.Nilai ini diterima dari panggilan mediaPlanners.list sebelumnya di ListMediaPlannersResponse.nextPageToken.
filter

string

String kueri opsional menggunakan sintaksis pemfilteran daftar Cloud API. Kolom yang didukung untuk pemfilteran adalah:

  • name
  • displayName
  • ancestorNames

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons yang berisi informasi akun perencana media.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
Kolom
mediaPlanners[]

object (MediaPlanner)

Daftar perencana media.
nextPageToken

string

Token yang dapat diteruskan ke panggilan berikutnya ke metode mediaPlanners.list untuk mengambil halaman hasil berikutnya di ListMediaPlannersRequest.page_token.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

MediaPlanner

Mewakili akun perencana media.

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

string

Hanya output. ID Akun perencana media.
name

string

Pengenal. Nama resource unik perencana media. Format: mediaPlanners/{mediaPlannerAccountId}. Dapat digunakan untuk memfilter respons metode mediaPlanners.list.
displayName

string

Hanya output. Nama tampilan perencana media. Dapat digunakan untuk memfilter respons metode [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners].
ancestorNames[]

string

Hanya output. Nama ancestor perencana media. Format: mediaPlanners/{mediaPlannerAccountId}. Dapat digunakan untuk memfilter respons metode mediaPlanners.list.