Method: advertisers.lineItems.duplicate

  • This method duplicates a line item and returns the ID of the newly created one.

  • This method has high latency, so increasing your default timeout is recommended to prevent errors.

  • YouTube & Partners line items cannot be duplicated using the API.

  • The request requires the advertiserId and lineItemId as path parameters.

  • The response body will contain the duplicateLineItemId field which holds the ID of the duplicated 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/v4/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.