Method: advertisers.lineItems.bulkUpdate

  • The bulkUpdate endpoint allows for updating multiple line items within Display & Video 360, modifying fields like entity status.

  • Certain concurrent requests related to line item and targeting options are restricted when using this endpoint.

  • YouTube & Partners line items are excluded from creation or updates via this API.

  • Successful responses will provide IDs of updated, failed, and skipped line items, along with any associated errors.

  • Authorization requires the https://www.googleapis.com/auth/display-video scope.

Updates multiple line items.

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

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

HTTP request

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkUpdate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

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 (LineItem)
  },
  "updateMask": string
}
Fields
lineItemIds[]

string (int64 format)

Required. IDs of line items to update.
targetLineItem

object (LineItem)

Required. A line item object containing the fields to be updated and the new values to assign to all line items specified in lineItemIds."
updateMask

string (FieldMask format)

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: "user.displayName,photo".

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 (Status)
    }
  ]
}
Fields
updatedLineItemIds[]

string (int64 format)

The IDs of successfully updated line items.
failedLineItemIds[]

string (int64 format)

The IDs of line items that failed to update.
skippedLineItemIds[]

string (int64 format)

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[]

object (Status)

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.