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.lineItems.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan item baris di pengiklan.
Urutan ditentukan oleh parameter orderBy
. Jika filter
dari entityStatus
tidak ditentukan, item baris dengan ENTITY_STATUS_ARCHIVED
tidak akan disertakan dalam hasil.
Permintaan HTTP
GET https://displayvideo.googleapis.com/v1beta2/advertisers/{advertiserId}/lineItems
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
advertiserId |
string (int64 format)
Wajib. ID pengiklan yang akan mencantumkan item baris.
|
Parameter kueri
Parameter |
pageSize |
integer
Ukuran halaman yang diminta. Harus antara 1 dan 100 . Jika tidak ditentukan akan ditetapkan secara default ke 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 lineItems.list . Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.
|
orderBy |
string
Kolom yang digunakan untuk mengurutkan daftar. Nilai yang dapat diterima:
displayName (default)
entityStatus
flight.dateRange.endDate
updateTime
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
Mengizinkan pemfilteran berdasarkan properti item baris. 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
flight.dateRange.endDate harus KURANG DARI (<).
- Operator yang digunakan di
updateTime harus GREATER THAN OR EQUAL TO (>=) atau LESS THAN OR EQUAL TO (<=) .
- Operator yang digunakan di
warningMessages harus HAS (:) .
- Operator yang digunakan di semua kolom lain harus berupa
EQUALS (=) .
- Properti yang didukung:
campaignId
displayName
insertionOrderId
entityStatus
lineItemId
lineItemType
flight.dateRange.endDate (input diformat sebagai YYYY-MM-DD)
warningMessages
flight.triggerId
updateTime (input dalam format ISO 8601, atau YYYY-MM-DDTHH:MM:SSZ)
targetedChannelId
targetedNegativeKeywordListId
Contoh:
- Semua item baris pada perjanjian pemasangan iklan:
insertionOrderId="1234"
- Semua item baris
ENTITY_STATUS_ACTIVE atau ENTITY_STATUS_PAUSED dan LINE_ITEM_TYPE_DISPLAY_DEFAULT di bagian pengiklan: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
- Semua item baris yang tanggal penayangannya berakhir sebelum 28 Maret 2019:
flight.dateRange.endDate<"2019-03-28"
- Semua item baris yang memiliki
NO_VALID_CREATIVE di warningMessages : warningMessages:"NO_VALID_CREATIVE"
- Semua item baris dengan waktu pembaruan kurang dari atau sama dengan
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime<="2020-11-04T18:54:47Z"
- Semua item baris dengan waktu pembaruan lebih dari atau sama dengan
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime>="2020-11-04T18:54:47Z"
- Semua item baris yang menggunakan saluran dan daftar kata kunci negatif tertentu dalam penargetannya:
targetedNegativeKeywordListId=789 AND targetedChannelId=12345
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 |
{
"lineItems": [
{
object (LineItem )
}
],
"nextPageToken": string
} |
Kolom |
lineItems[] |
object (LineItem )
Daftar item baris. 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 lineItems.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"
}]