Method: orders.lines.reserve

Réserve une ligne existante.

  • Si l'opération réussit, renvoie la ligne mise à jour.
  • Renvoie le code d'erreur NOT_FOUND si la ligne n'existe pas.
  • Renvoie le code d'erreur INVALID_ARGUMENT si lineTerms n'est pas défini.
  • Renvoie le code d'erreur FAILED_PRECONDITION si lineState n'est pas LINE_STATE_PENDING_RESERVATION.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Le champ contiendra le nom de la ligne à réserver, par exemple : "orders/123/lines/321"

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Champs
lineTerms

object (LineTerms)

Obligatoire. Conditions de la garantie du vendeur pour cette ligne.
reservationExpirationTime

string (Timestamp format)

Obligatoire. Code temporel d'expiration de la réservation. L'acheteur doit effectuer une réservation avant qu'elle n'expire.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Line.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.