Method: advertisers.lineItems.patch

更新現有委刊項。如果成功,則傳回更新後的委刊項。

對這個端點發出要求時,不得同時發出下列要求來更新同一個委刊項:

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

這個方法經常出現高延遲。建議增加預設逾時時間,以免發生錯誤。

HTTP 要求

PATCH https://displayvideo.googleapis.com/v5/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}

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

路徑參數

參數
lineItem.advertiserId

string (int64 format)

僅供輸出。委刊項所屬廣告主的專屬 ID。

lineItem.lineItemId

string (int64 format)

僅供輸出。委刊項的專屬 ID。由系統指派。

查詢參數

參數
updateMask

string (FieldMask format)

必填。用於控制要更新哪些欄位的遮罩。

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

要求主體

要求主體包含 LineItem 的例項。

回應主體

如果成功,回應主體會包含 LineItem 的執行個體。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱OAuth 2.0 Overview。