Method: advertisers.lineItems.bulkEditAssignedTargetingOptions

• HTTP 要求
• 路徑參數
• 要求主體
  • JSON 表示法
• 回應主體
  • JSON 表示法
• 授權範圍
• 試試看！

在多個委刊項底下大量編輯指定目標選項。這項作業會刪除「BulkEditAssignedTargetingOptionsRequest.delete_requests」提供的指派的指定目標選項，然後在「BulkEditAssignedTargetingOptionsRequest.create_requests」中建立指派的指定目標選項。

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

• lineItems.bulkUpdate
• lineItems.patch
• assignedTargetingOptions.create
• assignedTargetingOptions.delete

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

HTTP 要求

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

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

路徑參數

參數
advertiserId	string (int64 format) 必要欄位。委刊項所屬的廣告主 ID。

要求主體

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

JSON 表示法
{ "lineItemIds": [ string ], "deleteRequests": [ { object (DeleteAssignedTargetingOptionsRequest) } ], "createRequests": [ { object (CreateAssignedTargetingOptionsRequest) } ] }

欄位
lineItemIds[]	string (int64 format) 必要欄位。正在更新指定目標的委刊項 ID。
deleteRequests[]	object (DeleteAssignedTargetingOptionsRequest) 要批次刪除的指派指定目標選項，以 DeleteAssignedTargetingOptionsRequest 清單的形式指定。 支援的指定類型包括： TARGETING_TYPE_AGE_RANGE TARGETING_TYPE_APP TARGETING_TYPE_APP_CATEGORY TARGETING_TYPE_AUDIENCE_GROUP TARGETING_TYPE_AUDIO_CONTENT_TYPE TARGETING_TYPE_AUTHORIZED_SELLER_STATUS TARGETING_TYPE_BROWSER TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_CARRIER_AND_ISP TARGETING_TYPE_CATEGORY TARGETING_TYPE_CHANNEL TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_INSTREAM_POSITION TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION TARGETING_TYPE_CONTENT_STREAM_TYPE TARGETING_TYPE_DAY_AND_TIME TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION TARGETING_TYPE_ENVIRONMENT TARGETING_TYPE_EXCHANGE TARGETING_TYPE_GENDER TARGETING_TYPE_GEO_REGION TARGETING_TYPE_HOUSEHOLD_INCOME TARGETING_TYPE_INVENTORY_SOURCE TARGETING_TYPE_INVENTORY_SOURCE_GROUP TARGETING_TYPE_KEYWORD TARGETING_TYPE_LANGUAGE TARGETING_TYPE_NATIVE_CONTENT_POSITION TARGETING_TYPE_NEGATIVE_KEYWORD_LIST TARGETING_TYPE_OMID TARGETING_TYPE_ON_SCREEN_POSITION TARGETING_TYPE_OPERATING_SYSTEM TARGETING_TYPE_PARENTAL_STATUS TARGETING_TYPE_POI TARGETING_TYPE_PROXIMITY_LOCATION_LIST TARGETING_TYPE_REGIONAL_LOCATION_LIST TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION TARGETING_TYPE_SUB_EXCHANGE TARGETING_TYPE_THIRD_PARTY_VERIFIER TARGETING_TYPE_URL TARGETING_TYPE_USER_REWARDED_CONTENT TARGETING_TYPE_VIDEO_PLAYER_SIZE TARGETING_TYPE_VIEWABILITY
createRequests[]	object (CreateAssignedTargetingOptionsRequest) 要批次建立的指派指定目標選項，以 CreateAssignedTargetingOptionsRequest 清單的形式指定。 支援的指定類型包括： TARGETING_TYPE_AGE_RANGE TARGETING_TYPE_APP TARGETING_TYPE_APP_CATEGORY TARGETING_TYPE_AUDIENCE_GROUP TARGETING_TYPE_AUDIO_CONTENT_TYPE TARGETING_TYPE_AUTHORIZED_SELLER_STATUS TARGETING_TYPE_BROWSER TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_CARRIER_AND_ISP TARGETING_TYPE_CATEGORY TARGETING_TYPE_CHANNEL TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_INSTREAM_POSITION TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION TARGETING_TYPE_CONTENT_STREAM_TYPE TARGETING_TYPE_DAY_AND_TIME TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION TARGETING_TYPE_ENVIRONMENT TARGETING_TYPE_EXCHANGE TARGETING_TYPE_GENDER TARGETING_TYPE_GEO_REGION TARGETING_TYPE_HOUSEHOLD_INCOME TARGETING_TYPE_INVENTORY_SOURCE TARGETING_TYPE_INVENTORY_SOURCE_GROUP TARGETING_TYPE_KEYWORD TARGETING_TYPE_LANGUAGE TARGETING_TYPE_NATIVE_CONTENT_POSITION TARGETING_TYPE_NEGATIVE_KEYWORD_LIST TARGETING_TYPE_OMID TARGETING_TYPE_ON_SCREEN_POSITION TARGETING_TYPE_OPERATING_SYSTEM TARGETING_TYPE_PARENTAL_STATUS TARGETING_TYPE_POI TARGETING_TYPE_PROXIMITY_LOCATION_LIST TARGETING_TYPE_REGIONAL_LOCATION_LIST TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION TARGETING_TYPE_SUB_EXCHANGE TARGETING_TYPE_THIRD_PARTY_VERIFIER TARGETING_TYPE_URL TARGETING_TYPE_USER_REWARDED_CONTENT TARGETING_TYPE_VIDEO_PLAYER_SIZE TARGETING_TYPE_VIEWABILITY

回應主體

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

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

欄位
updatedLineItemIds[]	string (int64 format) 僅供輸出。成功更新的委刊項 ID。
failedLineItemIds[]	string (int64 format) 僅供輸出。失敗的委刊項 ID。
errors[]	object (Status) 每個無法更新的委刊項錯誤資訊。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。