Method: sellers.adUnits.list

Mencantumkan unit iklan.

  • Misalnya, GET /v1/sellers/seller111/adUnits
  • Menampilkan daftar unit iklan dan token untuk mengambil halaman berikutnya jika berhasil.
  • Menampilkan kode error PERMISSION_DENIED jika pengguna tidak memiliki akses ke penjual atau ID penjual tidak ada.
  • Menampilkan kode error INVALID_ARGUMENT jika penjual memberikan token halaman atau ukuran halaman yang tidak valid.

Permintaan HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib diisi. Penjual, yang memiliki kumpulan unit iklan ini. Format: penjual/{seller}

Parameter kueri

Parameter
pageSize

integer

Jumlah maksimum item untuk ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jumlah maksimum unit iklan yang diizinkan adalah 1.000; nilai di atas 1.000 akan diubah menjadi 1.000. Jika tidak ditentukan, maksimal 1.000 unit iklan akan ditampilkan.
pageToken

string

Nilai nextPageToken yang ditampilkan dari permintaan Daftar sebelumnya, jika ada.
filter

string

Filter daftar. Saat ini mendukung pemfilteran status dan ID eksternal, dengan sintaksis: "externalId = [EXTERNAL_ID]" dan "state = [NEGARA]". Operator logika AND dan OR dapat digunakan untuk merangkai filter. AD_UNIT_CHANGE_DELETED tidak dapat digunakan untuk menampilkan unit iklan yang dihapus. Sebagai gantinya, gunakan showDeleted.
orderBy

string

Urutan berdasarkan {i>string<i} yang digunakan untuk menentukan tata urutan hasil. Saat ini mendukung pengurutan berdasarkan updateTime, berikan "updateTime" untuk mendapatkan hasil yang diurutkan berdasarkan updateTime dalam urutan menaik, atau "updateTime desc" untuk urutan menurun.
showDeleted

boolean

Apakah akan menampilkan unit iklan yang dihapus untuk sementara.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk InventoryService.ListAdUnits.

Representasi JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Kolom
adUnits[]

object (AdUnit)

Daftar unit iklan.
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya. Teruskan nilai ini di kolom pageToken dalam panggilan berikutnya ke metode adUnits.list untuk mengambil halaman hasil berikutnya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.