Method: orders.lines.reserve

Reserviert eine vorhandene Linie.

  • Gibt bei Erfolg die aktualisierte Zeile zurück.
  • Gibt den Fehlercode NOT_FOUND zurück, wenn die Zeile nicht vorhanden ist.
  • Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn lineTerms nicht festgelegt ist.
  • Gibt den Fehlercode FAILED_PRECONDITION zurück, wenn lineState nicht LINE_STATE_PENDING_RESERVATION ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Das Feld enthält den Namen der zu reservierenden Zeile, z. B. „orders/123/lines/321“.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Felder
lineTerms

object (LineTerms)

Erforderlich. Die vom Verkäufer garantierten Bedingungen für diese Position.
reservationExpirationTime

string (Timestamp format)

Erforderlich. Ablaufzeitstempel für die Reservierung. Der Käufer muss buchen, bevor eine Reservierung abläuft.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Line.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.