Method: orders.lines.reserve

Reserva uma linha existente.

  • Retorna a linha atualizada se for bem-sucedida.
  • Retorna o código de erro NOT_FOUND se a linha não existir.
  • Retorna o código de erro INVALID_ARGUMENT se lineTerms não está definido.
  • Retorna o código de erro FAILED_PRECONDITION se lineState não for LINE_STATE_PENDING_RESERVATION.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

O campo conterá o nome da linha a ser reservada, por exemplo: "orders/123/lines/321".

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Campos
lineTerms

object (LineTerms)

Obrigatório. Os termos garantidos do vendedor para esta linha.
reservationExpirationTime

string (Timestamp format)

Obrigatório. Carimbo de data/hora de expiração da reserva. O comprador precisa fazer a reserva antes que ela expire.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Line.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.