Method: advertisers.lineItems.bulkEditAssignedTargetingOptions

AI-generated Key Takeaways

• This method allows for the bulk editing of targeting options across multiple line items by deleting and creating assigned targeting options.

• Concurrent requests updating the same line item using lineItems.bulkUpdate, lineItems.patch, assignedTargetingOptions.create, or assignedTargetingOptions.delete are not permitted with this endpoint.

• YouTube & Partners line items cannot be created or updated via the API using this method.

• The request body includes the IDs of the line items to be updated, a list of delete requests, and a list of create requests for assigned targeting options.

• The response body indicates which line items were successfully updated, which failed, and provides error information for the failed updates.

• HTTP request
• Path parameters
• Request body
  • JSON representation
• Response body
  • JSON representation
• Authorization scopes
• Try it!

Bulk edits targeting options under multiple line items. The operation will delete the assigned targeting options provided in BulkEditAssignedTargetingOptionsRequest.delete_requests and then create the assigned targeting options provided in BulkEditAssignedTargetingOptionsRequest.create_requests.

Requests to this endpoint cannot be made concurrently with the following requests updating the same line item:

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

YouTube & Partners line items cannot be created or updated using the API.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId	string (int64 format) Required. The ID of the advertiser the line items belong to.

Request body

The request body contains data with the following structure:

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

Fields
lineItemIds[]	string (int64 format) Required. The ID of the line items whose targeting is being updated.
deleteRequests[]	object (DeleteAssignedTargetingOptionsRequest) The assigned targeting options to delete in batch, specified as a list of DeleteAssignedTargetingOptionsRequest. Supported targeting types include: 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) The assigned targeting options to create in batch, specified as a list of CreateAssignedTargetingOptionsRequest. Supported targeting types include: 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

Response body

If successful, the response body contains data with the following structure:

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

Fields
updatedLineItemIds[]	string (int64 format) Output only. The IDs of the line items which successfully updated.
failedLineItemIds[]	string (int64 format) Output only. The IDs of the line items which failed.
errors[]	object (Status) The error information for each line item that failed to update.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.