Method: advertisers.channels.sites.list

Mencantumkan situs di saluran.

Permintaan HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
channelId

string (int64 format)

Wajib. ID saluran induk tempat situs yang diminta berada.

Parameter union owner. Wajib. Mengidentifikasi entity DV360 yang memiliki channel induk. Partner atau pengiklan dapat bergabung. owner hanya dapat berupa salah satu dari berikut:
advertiserId

string (int64 format)

ID pengiklan yang memiliki channel induk.

Parameter kueri

Parameter
pageSize

integer

Ukuran halaman yang diminta. Harus antara 1 dan 10000. Jika tidak ditentukan, setelan defaultnya adalah 100. Menampilkan kode error INVALID_ARGUMENT jika nilai yang ditentukan tidak valid.

pageToken

string

Token yang mengidentifikasi halaman hasil yang harus ditampilkan server.

Biasanya, nilai ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode sites.list. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.

orderBy

string

Kolom yang akan digunakan untuk mengurutkan daftar. Nilai yang dapat diterima:

  • urlOrAppId (default)

Tata urutan default adalah menaik. Guna menentukan urutan menurun untuk kolom, akhiran "desc" harus ditambahkan ke nama kolom. Contoh: urlOrAppId desc.

filter

string

Memungkinkan pemfilteran menurut kolom situs.

Sintaksis yang didukung:

  • Ekspresi filter untuk pengambilan situs hanya dapat berisi maksimal satu batasan.
  • Batasan memiliki bentuk {field} {operator} {value}.
  • Semua kolom harus menggunakan operator HAS (:).

Kolom yang didukung:

  • urlOrAppId

Contoh:

  • Semua situs yang URL atau ID aplikasinya berisi "google": urlOrAppId : "google"

Panjang kolom ini tidak boleh lebih dari 500 karakter.

Lihat panduan memfilter permintaan LIST untuk mengetahui informasi selengkapnya.

Parameter union owner. Wajib. Mengidentifikasi entity DV360 yang memiliki channel induk. Pengiklan dapat berupa partner atau pengiklan. owner hanya dapat berupa salah satu dari berikut:
partnerId

string (int64 format)

ID partner yang memiliki channel induk.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat instance ListSitesResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/display-video

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.