Reserves an existing line.
- Returns the updated line if successful.
- Returns error code
NOT_FOUND
if the line does not exist. - Returns error code
INVALID_ARGUMENT
if lineTerms is not set. - Returns error code
FAILED_PRECONDITION
if lineState is notLINE_STATE_PENDING_RESERVATION
.
HTTP request
POST https://dv360outofhomeseller.googleapis.com/v1beta1/{name=orders/*/lines/*}:reserve
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
name |
The field will contain name of the line to be reserved, for example: "orders/123/lines/321" |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"lineTerms": {
object ( |
Fields | |
---|---|
lineTerms |
Required. The seller guaranteed terms for this line. |
reservationExpirationTime |
Required. Expiration timestamp for the reservation. The buyer needs to book before a reservation expires. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
Response body
If successful, the response body contains an instance of Line
.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/doubleclickbidmanager
For more information, see the OAuth 2.0 Overview.