Method: advertisers.lineItems.bulkUpdate

Birden fazla satır öğesini günceller.

Bu uç noktaya yapılan istekler, aynı satır öğesini güncelleyen aşağıdaki isteklerle eşzamanlı olarak yapılamaz:

YouTube ve iş ortakları satır öğeleri API kullanılarak oluşturulamaz veya güncellenemez.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
advertiserId

string (int64 format)

Zorunlu. Bu satır öğesinin ait olduğu reklamverenin kimliği.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Alanlar
lineItemIds[]

string (int64 format)

Zorunlu. Güncellenecek satır öğelerinin kimlikleri.
targetLineItem

object (LineItem)

Zorunlu. Güncellenecek alanları ve lineItemIds içinde belirtilen tüm satır öğelerine atanacak yeni değerleri içeren bir satır öğesi nesnesi."
updateMask

string (FieldMask format)

Zorunlu. Hangi alanların güncelleneceğini tanımlayan bir alan maskesi.

Şu anda yalnızca aşağıdaki alanlar desteklenmektedir:

Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

Yanıt gövdesi

LineItemService.BulkUpdateLineItems için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Alanlar
updatedLineItemIds[]

string (int64 format)

Başarıyla güncellenen satır öğelerinin kimlikleri.
failedLineItemIds[]

string (int64 format)

Güncellenememiş satır öğelerinin kimlikleri.
skippedLineItemIds[]

string (int64 format)

Güncellemeler için atlanan satır öğelerinin kimlikleri. Örneğin, satır öğelerinde hiçbir değişiklikle sonuçlanmayacak gereksiz mutasyonlar atlanır ve ilgili satır öğesi kimlikleri buradan izlenebilir.
errors[]

object (Status)

Güncelleme başarısız olan satır öğeleri tarafından döndürülen hatalar.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.