Method: orders.lines.reserve
Stay organized with collections
Save and categorize content based on your preferences.
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 not LINE_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 |
string
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 (LineTerms)
},
"reservationExpirationTime": string
} |
| Fields |
lineTerms |
object (LineTerms)
Required. The seller guaranteed terms for this line.
|
reservationExpirationTime |
string (Timestamp format)
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: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
|
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["Reserves an existing order line, updating it with the provided terms and reservation expiration time."],["Requires a `POST` request to the specified endpoint with necessary path and request body parameters."],["Returns the updated line if successful, along with potential error codes for invalid requests or line states."],["Utilizes gRPC Transcoding for URL syntax and requires `doubleclickbidmanager` OAuth scope for authorization."]]],["This describes the `reserve` action for a line, accessed via a `POST` request to a specific URL. The request requires the line's `name` as a path parameter. The request body must include `lineTerms` and `reservationExpirationTime`. Successful requests return the updated `Line`. Errors include `NOT_FOUND` for a missing line, `INVALID_ARGUMENT` for unset `lineTerms`, and `FAILED_PRECONDITION` for an incorrect `lineState`. Authorization requires the `doubleclickbidmanager` OAuth scope.\n"]]
