Display & Video 360 API v1beta2 telah dihentikan. Permintaan ke versi yang dihentikan dapat menampilkan error.
Anda harus menggunakan Display & Video 360 API v2. Lihat panduan migrasi kami untuk mengetahui langkah-langkah bermigrasi dari v1 ke v2.
Method: advertisers.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan pengiklan yang dapat diakses oleh pengguna saat ini.
Urutan ditentukan oleh parameter orderBy
.
Satu partnerId
wajib diisi. Listingan lintas partner tidak didukung.
Permintaan HTTP
GET https://displayvideo.googleapis.com/v1beta2/advertisers
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter |
partnerId |
string (int64 format)
Wajib. ID partner yang seharusnya mencakup semua pengiklan yang diambil. Sistem hanya mendukung pengiklan listingan untuk satu partner dalam satu waktu.
|
pageSize |
integer
Ukuran halaman yang diminta. Harus antara 1 dan 100 . Jika tidak ditentukan akan ditetapkan secara default ke 100 .
|
pageToken |
string
Token yang mengidentifikasi halaman hasil yang harus ditampilkan server. Biasanya, ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode advertisers.list . Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.
|
orderBy |
string
Kolom yang digunakan untuk mengurutkan daftar. Nilai yang dapat diterima:
displayName (default)
entityStatus
updateTime
Urutan penyortiran {i>default<i} adalah menaik. Guna menentukan urutan menurun untuk suatu kolom, akhiran "desc" harus ditambahkan ke nama kolom. Misalnya, displayName desc .
|
filter |
string
Mengizinkan pemfilteran menurut properti pengiklan. Sintaksis yang didukung:
- Ekspresi filter terdiri dari satu atau beberapa batasan.
- Pembatasan dapat digabungkan dengan operator logika
AND atau OR . Urutan pembatasan secara implisit menggunakan AND .
- Batasan memiliki bentuk
{field} {operator} {value} .
- Operator yang digunakan di
updateTime harus GREATER THAN OR EQUAL TO (>=) atau LESS THAN OR EQUAL TO (<=) .
- Operator harus
EQUALS (=) .
- Kolom yang didukung:
advertiserId
displayName
entityStatus
updateTime (input dalam format ISO 8601, atau YYYY-MM-DDTHH:MM:SSZ)
Contoh:
- Semua pengiklan aktif di bawah partner:
entityStatus="ENTITY_STATUS_ACTIVE"
- Semua pengiklan dengan waktu pembaruan kurang dari atau sama dengan
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime<="2020-11-04T18:54:47Z"
- Semua pengiklan dengan waktu pembaruan lebih dari atau sama dengan
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime>="2020-11-04T18:54:47Z"
Panjang kolom ini tidak boleh lebih dari 500 karakter.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
{
"advertisers": [
{
object (Advertiser )
}
],
"nextPageToken": string
} |
Kolom |
advertisers[] |
object (Advertiser )
Daftar pengiklan. Daftar ini tidak akan ada jika kosong.
|
nextPageToken |
string
Token untuk mengambil halaman hasil berikutnya. Teruskan nilai ini di kolom pageToken dalam panggilan berikutnya ke metode advertisers.list untuk mengambil halaman hasil berikutnya.
|
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/display-video
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2023-12-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Informasi yang saya butuhkan tidak ada"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Terlalu rumit/langkahnya terlalu banyak"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Sudah usang"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Masalah terjemahan"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Masalah kode / contoh"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Lainnya"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Mudah dipahami"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Memecahkan masalah saya"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Lainnya"
}]