Method: orders.lines.reserve

Prenota una linea esistente.

  • Restituisce la riga aggiornata in caso di esito positivo.
  • Restituisce il codice di errore NOT_FOUND se la riga non esiste.
  • Restituisce il codice di errore INVALID_ARGUMENT se lineTerms non è impostato.
  • Restituisce il codice di errore FAILED_PRECONDITION se lineState non è LINE_STATE_PENDING_RESERVATION.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Il campo conterrà il nome della riga da prenotare, ad esempio: "orders/123/lines/321"

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Campi
lineTerms

object (LineTerms)

Obbligatorio. I termini garantiti dal venditore per questa riga.
reservationExpirationTime

string (Timestamp format)

Obbligatorio. Timestamp della scadenza della prenotazione. L'acquirente deve effettuare una prenotazione prima della scadenza di una prenotazione.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Line.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.