Method: advertisers.lineItems.bulkUpdate

Memperbarui beberapa item baris.

Permintaan ke endpoint ini tidak dapat dilakukan secara serentak dengan permintaan berikut yang memperbarui item baris yang sama:

Item baris YouTube & Partner tidak dapat dibuat atau diperbarui menggunakan API.

Permintaan HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan yang memiliki item baris ini.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Kolom
lineItemIds[]

string (int64 format)

Wajib. ID item baris yang akan diperbarui.
targetLineItem

object (LineItem)

Wajib. Objek item baris yang berisi kolom yang akan diperbarui dan nilai baru yang akan ditetapkan ke semua item baris yang ditentukan dalam lineItemIds."
updateMask

string (FieldMask format)

Wajib. Mask kolom yang mengidentifikasi kolom mana yang akan diperbarui.

Saat ini hanya kolom berikut yang didukung:

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Isi respons

Pesan respons untuk LineItemService.BulkUpdateLineItems.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Kolom
updatedLineItemIds[]

string (int64 format)

ID item baris yang berhasil diperbarui.
failedLineItemIds[]

string (int64 format)

ID item baris yang gagal diperbarui.
skippedLineItemIds[]

string (int64 format)

ID item baris yang dilewati untuk pembaruan. Misalnya, mutasi yang tidak perlu yang akan mengakibatkan tidak ada perubahan pada item baris secara efektif akan dilewati dan ID item baris yang sesuai dapat dilacak di sini.
errors[]

object (Status)

Error yang ditampilkan oleh item baris yang gagal diperbarui.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.