Method: orders.lines.reserve

Reserva una línea existente.

  • Muestra la línea actualizada si se ejecuta correctamente.
  • Muestra el código de error NOT_FOUND si la línea no existe.
  • Muestra el código de error INVALID_ARGUMENT si no se estableció lineTerms.
  • Muestra el código de error FAILED_PRECONDITION si lineState no es LINE_STATE_PENDING_RESERVATION.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

El campo contendrá el nombre de la línea que se reservará, por ejemplo: "orders/123/lines/321".

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Campos
lineTerms

object (LineTerms)

Obligatorio. Son los términos garantizados por el vendedor para esta línea.
reservationExpirationTime

string (Timestamp format)

Obligatorio. Marca de tiempo de vencimiento de la reserva. El comprador debe hacer la reserva antes de que venza.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Line.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Para obtener más información, consulta la descripción general de OAuth 2.0.