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 概览。