Method: orders.lines.reserve

Rezerwuje istniejącą linię.

  • Jeśli operacja się udała, zwraca zaktualizowany wiersz.
  • Jeśli wiersz nie istnieje, zwraca kod błędu NOT_FOUND.
  • Zwraca kod błędu INVALID_ARGUMENT, jeśli parametr lineTerms nie jest określony.
  • Zwraca kod błędu FAILED_PRECONDITION, jeśli parametr lineState nie ma wartości LINE_STATE_PENDING_RESERVATION.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Pole będzie zawierać nazwę wiersza do zarezerwowania, na przykład: „zamówienia/123/wiersze/321”.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Pola
lineTerms

object (LineTerms)

Wymagane. Warunki gwarancji sprzedawcy w przypadku tej linii.
reservationExpirationTime

string (Timestamp format)

Wymagane. Sygnatura czasowa wygaśnięcia rezerwacji. Kupujący musi dokonać rezerwacji przed wygaśnięciem rezerwacji.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Line.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.