Updates multiple line items.
Requests to this endpoint cannot be made concurrently with the following requests updating the same line item:
lineItems.bulkEditAssignedTargetingOptions
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/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
advertiserId |
Required. The ID of the advertiser this line item belongs to. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
Fields | |
---|---|
lineItemIds[] |
Required. IDs of line items to update. |
targetLineItem |
Required. A line item object containing the fields to be updated and the new values to assign to all line items specified in |
updateMask |
Required. A field mask identifying which fields to update. Only the following fields are currently supported: This is a comma-separated list of fully qualified names of fields. Example: |
Response body
Response message for LineItemService.BulkUpdateLineItems.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
Fields | |
---|---|
updatedLineItemIds[] |
The IDs of successfully updated line items. |
failedLineItemIds[] |
The IDs of line items that failed to update. |
skippedLineItemIds[] |
The IDs of line items that are skipped for updates. For example, unnecessary mutates that will result in effectively no changes to line items will be skipped and corresponding line item IDs can be tracked here. |
errors[] |
Errors returned by line items 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.