Method: advertisers.lineItems.bulkUpdate

Memperbarui beberapa item baris.

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

YouTube & Item baris Partners 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 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 mana yang akan diperbarui.

Saat ini hanya kolom berikut yang 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 dan pada dasarnya tidak akan 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:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.