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 İş ortağı 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 satır öğesi nesnesi."

updateMask

string (FieldMask format)

Zorunlu. Hangi alanların güncelleneceğini belirleyen 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üncellenmeyen satır öğelerinin kimlikleri.

skippedLineItemIds[]

string (int64 format)

Güncellemeler için atlanan satır öğelerinin kimlikleri. Örneğin, satır öğelerinde etkili bir şekilde hiçbir değişikliğe neden olmayacak gereksiz değişiklikler atlanır ve ilgili satır öğesi kimlikleri buradan izlenebilir.

errors[]

object (Status)

Güncellenmeyen 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.