Method: sellers.orders.lines.reserve

Резервирует существующую линию.

  • Возвращает обновленную строку в случае успеха.
  • Возвращает код ошибки NOT_FOUND , если строка не существует.
  • Возвращает код ошибки INVALID_ARGUMENT если lineTerms не установлен.
  • Возвращает код ошибки FAILED_PRECONDITION , если состояние отличается от STATE_PENDING_RESERVATION .

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Необходимый. Поле будет содержать название резервируемой строки, например: «sellers/789/orders/123/lines/321».

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Поля
lineTerms

object ( LineTerms )

Необходимый. Продавец гарантировал сроки по этой линии.

reservationExpirationTime

string ( Timestamp format)

Необходимый. Временная метка истечения срока действия резервирования. Покупателю необходимо забронировать до истечения срока действия бронирования.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Тело ответа

В случае успеха тело ответа содержит экземпляр Line .

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .