Method: sellers.orders.lines.reserve

  • The sellers.orders.lines.reserve method is used to reserve an existing line.

  • A successful request returns the updated line.

  • The request requires the name of the line in the path and a request body containing lineTerms and reservationExpirationTime.

  • Specific error codes are returned for different failure scenarios, such as NOT_FOUND or INVALID_ARGUMENT.

  • This method requires the https://www.googleapis.com/auth/doubleclickbidmanager authorization scope.

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 state is not STATE_PENDING_RESERVATION.

HTTP request

POST https://dv360outofhomeseller.googleapis.com/v1/{name=sellers/*/orders/*/lines/*}:reserve

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The field will contain name of the line to be reserved, for example: "sellers/789/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.