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.locationLists.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan daftar lokasi berdasarkan ID pengiklan tertentu.
Permintaan HTTP
GET https://displayvideo.googleapis.com/v1beta2/advertisers/{advertiserId}/locationLists
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
advertiserId |
string (int64 format)
Wajib. ID pengiklan DV360 yang memiliki daftar lokasi yang diambil.
|
Parameter kueri
Parameter |
pageSize |
integer
Ukuran halaman yang diminta. Harus antara 1 dan 100 . Jika tidak disetel, 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, ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode locationLists.list . Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.
|
orderBy |
string
Kolom yang digunakan untuk mengurutkan daftar. Nilai yang dapat diterima:
locationListId (default)
displayName
Urutan penyortiran {i>default<i} adalah menaik. Guna menentukan urutan menurun untuk suatu kolom, akhiran "desc" harus ditambahkan ke nama kolom. Contoh: displayName desc .
|
filter |
string
Memungkinkan pemfilteran berdasarkan kolom daftar lokasi. 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 harus
EQUALS (=) .
- Kolom yang didukung:
Contoh:
- Semua daftar lokasi regional:
locationType="TARGETING_LOCATION_TYPE_REGIONAL"
- Semua daftar lokasi kedekatan:
locationType="TARGETING_LOCATION_TYPE_PROXIMITY"
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
{
"locationLists": [
{
object (LocationList )
}
],
"nextPageToken": string
} |
Kolom |
locationLists[] |
object (LocationList )
Daftar daftar lokasi. 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 locationLists.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-01 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"
}]