更新多個委刊項。
針對此端點發出的要求,不能與更新同一委刊項下列要求同時提出:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
您無法使用 API 建立或更新 YouTube 與合作夥伴委刊項。
HTTP 要求
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
advertiserId |
必要欄位。這個委刊項所屬的廣告主 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
欄位 | |
---|---|
lineItemIds[] |
必要欄位。要更新的委刊項 ID。 |
targetLineItem |
必要欄位。這是委刊項物件,包含要更新的欄位和要指派給「 |
updateMask |
必要欄位。欄位遮罩,用於識別要更新的欄位。 系統目前僅支援以下欄位: 此為以半形逗號分隔的完整欄位名稱清單。範例: |
回應主體
LineItemService.BulkUpdateLineItems 的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
欄位 | |
---|---|
updatedLineItemIds[] |
成功更新的委刊項 ID。 |
failedLineItemIds[] |
無法更新的委刊項 ID。 |
skippedLineItemIds[] |
略過更新的委刊項 ID。舉例來說,如果執行非必要的變動作業,系統就不會略過任何對委刊項所做的變更,您可以直接在這裡追蹤對應的委刊項 ID。 |
errors[] |
無法更新的委刊項傳回的錯誤。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 總覽。