Method: advertisers.lineItems.bulkUpdate

Memperbarui beberapa item baris.

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

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

Permintaan HTTP

POST https://displayvideo.googleapis.com/v2/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 di lineItemIds."
updateMask

string (FieldMask format)

Wajib. Mask kolom yang mengidentifikasi kolom yang akan diperbarui.

Hanya kolom berikut yang saat ini didukung:

Ini adalah daftar yang dipisahkan koma yang berisi 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 yang 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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.