Method: advertisers.lineItems.bulkUpdate

更新多個委刊項。

針對此端點發出的要求，不能與更新同一委刊項下列要求同時提出：

您無法使用 API 建立或更新 YouTube 與合作夥伴委刊項。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
advertiserId

string (int64 format)

必要欄位。這個委刊項所屬的廣告主 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
欄位
lineItemIds[]

string (int64 format)

必要欄位。要更新的委刊項 ID。
targetLineItem

object (LineItem)

必要欄位。這是委刊項物件，包含要更新的欄位和要指派給「lineItemIds」中指定的所有委刊項的新值。
updateMask

string (FieldMask format)

必要欄位。欄位遮罩，用於識別要更新的欄位。

系統目前僅支援以下欄位：

此為以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。

回應主體

LineItemService.BulkUpdateLineItems 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
欄位
updatedLineItemIds[]

string (int64 format)

成功更新的委刊項 ID。
failedLineItemIds[]

string (int64 format)

無法更新的委刊項 ID。
skippedLineItemIds[]

string (int64 format)

略過更新的委刊項 ID。舉例來說，如果執行非必要的變動作業，系統就不會略過任何對委刊項所做的變更，您可以直接在這裡追蹤對應的委刊項 ID。
errors[]

object (Status)

無法更新的委刊項傳回的錯誤。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。