Send feedback
Method: advertisers.lineItems.bulkEditAssignedTargetingOptions
Stay organized with collections
Save and categorize content based on your preferences.
outlined_flag
Display & Video 360 API v3 has sunset, and users should transition to v4.
This API endpoint allows for the bulk editing of targeting options across multiple line items by deleting existing options and creating new ones.
Concurrent requests to this endpoint with other specific line item update requests are not allowed.
YouTube & Partners line items cannot be created or updated using this API.
Display & Video 360 API v3 has sunset. Use v4 instead.
HTTP request
POST https://displayvideo.googleapis.com/v3/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:
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_RANGETARGETING_TYPE_APPTARGETING_TYPE_APP_CATEGORYTARGETING_TYPE_AUDIENCE_GROUPTARGETING_TYPE_AUDIO_CONTENT_TYPETARGETING_TYPE_AUTHORIZED_SELLER_STATUSTARGETING_TYPE_BROWSERTARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_CARRIER_AND_ISPTARGETING_TYPE_CATEGORYTARGETING_TYPE_CHANNELTARGETING_TYPE_CONTENT_DURATIONTARGETING_TYPE_CONTENT_GENRETARGETING_TYPE_CONTENT_INSTREAM_POSITIONTARGETING_TYPE_CONTENT_OUTSTREAM_POSITIONTARGETING_TYPE_CONTENT_STREAM_TYPETARGETING_TYPE_DAY_AND_TIMETARGETING_TYPE_DEVICE_MAKE_MODELTARGETING_TYPE_DEVICE_TYPETARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSIONTARGETING_TYPE_ENVIRONMENTTARGETING_TYPE_EXCHANGETARGETING_TYPE_GENDERTARGETING_TYPE_GEO_REGIONTARGETING_TYPE_HOUSEHOLD_INCOMETARGETING_TYPE_INVENTORY_SOURCETARGETING_TYPE_INVENTORY_SOURCE_GROUPTARGETING_TYPE_KEYWORDTARGETING_TYPE_LANGUAGETARGETING_TYPE_NATIVE_CONTENT_POSITIONTARGETING_TYPE_NEGATIVE_KEYWORD_LISTTARGETING_TYPE_OMIDTARGETING_TYPE_ON_SCREEN_POSITIONTARGETING_TYPE_OPERATING_SYSTEMTARGETING_TYPE_PARENTAL_STATUSTARGETING_TYPE_POITARGETING_TYPE_PROXIMITY_LOCATION_LISTTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSIONTARGETING_TYPE_SUB_EXCHANGETARGETING_TYPE_THIRD_PARTY_VERIFIERTARGETING_TYPE_URLTARGETING_TYPE_USER_REWARDED_CONTENTTARGETING_TYPE_VIDEO_PLAYER_SIZETARGETING_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_RANGETARGETING_TYPE_APPTARGETING_TYPE_APP_CATEGORYTARGETING_TYPE_AUDIENCE_GROUPTARGETING_TYPE_AUDIO_CONTENT_TYPETARGETING_TYPE_AUTHORIZED_SELLER_STATUSTARGETING_TYPE_BROWSERTARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_CARRIER_AND_ISPTARGETING_TYPE_CATEGORYTARGETING_TYPE_CHANNELTARGETING_TYPE_CONTENT_DURATIONTARGETING_TYPE_CONTENT_GENRETARGETING_TYPE_CONTENT_INSTREAM_POSITIONTARGETING_TYPE_CONTENT_OUTSTREAM_POSITIONTARGETING_TYPE_CONTENT_STREAM_TYPETARGETING_TYPE_DAY_AND_TIMETARGETING_TYPE_DEVICE_MAKE_MODELTARGETING_TYPE_DEVICE_TYPETARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSIONTARGETING_TYPE_ENVIRONMENTTARGETING_TYPE_EXCHANGETARGETING_TYPE_GENDERTARGETING_TYPE_GEO_REGIONTARGETING_TYPE_HOUSEHOLD_INCOMETARGETING_TYPE_INVENTORY_SOURCETARGETING_TYPE_INVENTORY_SOURCE_GROUPTARGETING_TYPE_KEYWORDTARGETING_TYPE_LANGUAGETARGETING_TYPE_NATIVE_CONTENT_POSITIONTARGETING_TYPE_NEGATIVE_KEYWORD_LISTTARGETING_TYPE_OMIDTARGETING_TYPE_ON_SCREEN_POSITIONTARGETING_TYPE_OPERATING_SYSTEMTARGETING_TYPE_PARENTAL_STATUSTARGETING_TYPE_POITARGETING_TYPE_PROXIMITY_LOCATION_LISTTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSIONTARGETING_TYPE_SUB_EXCHANGETARGETING_TYPE_THIRD_PARTY_VERIFIERTARGETING_TYPE_URLTARGETING_TYPE_USER_REWARDED_CONTENTTARGETING_TYPE_VIDEO_PLAYER_SIZETARGETING_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 .
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-08 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-10-08 UTC."],[],["This operation performs bulk edits to targeting options for multiple line items. It deletes assigned targeting options specified in `deleteRequests` and creates new ones from `createRequests`. The request includes `lineItemIds` to identify which items to edit. The request is a POST request to a URL with a specific path parameter: `advertiserId`. Concurrent requests to update the same line item are restricted. Successful edits are returned in `updatedLineItemIds`, failures in `failedLineItemIds`, and errors in `errors`.\n"]]
