Method: advertisers.lineItems.duplicate

  • This method duplicates a line item in Display & Video 360 API v3 and returns the ID of the new line item.

  • You cannot use this method to duplicate YouTube & Partners line items.

  • Due to high latency, it is recommended to increase your default timeout when using this method.

  • The request requires advertiserId and lineItemId path parameters.

  • The request body can include targetDisplayName and containsEuPoliticalAds fields for the new line item.

Duplicates a line item. Returns the ID of the created line item if successful.

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

This method regularly experiences high latency. We recommend increasing your default timeout to avoid errors.

HTTP request

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems/{lineItemId}:duplicate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

Required. The ID of the advertiser this line item belongs to.
lineItemId

string (int64 format)

Required. The ID of the line item to duplicate.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "targetDisplayName": string,
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Fields
targetDisplayName

string

The display name of the new line item.

Must be UTF-8 encoded with a maximum size of 240 bytes.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Whether this line item will serve European Union political ads.

If containsEuPoliticalAds has been set to DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING in the parent advertiser, then this field will be assigned DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING if not otherwise specified. This field can then be updated using the UI, API, or Structured Data Files.

This field must be assigned when creating a new line item. Otherwise, the advertisers.lineItems.create request will fail.

Response body

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

JSON representation 
{
  "duplicateLineItemId": string
}
Fields
duplicateLineItemId

string (int64 format)

The ID of the created line item.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.