Every new line item needs to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details.

Method: advertisers.lineItems.create

AI-generated Key Takeaways

Creates a new Display & Video 360 line item with the provided details.
YouTube & Partners line items are not supported through this API.
Requires authorization with the https://www.googleapis.com/auth/display-video scope.
Sends a POST request to the specified endpoint with the line item data in the request body.
Returns the newly created line item object in the response if successful.

HTTP request
Path parameters
Request body
Response body
Authorization scopes
Try it!

Creates a new line item. Returns the newly created line item if successful.

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

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`lineItem.advertiserId`	`string (int64 format)` Output only. The unique ID of the advertiser the line item belongs to.

lineItem.advertiserId

string (int64 format)

Output only. The unique ID of the advertiser the line item belongs to.

Request body

The request body contains an instance of LineItem.

Response body

If successful, the response body contains a newly created instance of LineItem.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.