Method: orders.lines.reserve

Đặt trước một tuyến đường hiện có.

  • Trả về dòng được cập nhật nếu thành công.
  • Trả về mã lỗi NOT_FOUND nếu dòng này không tồn tại.
  • Trả về mã lỗi INVALID_ARGUMENT nếu chưa đặt lineTerms.
  • Trả về mã lỗi FAILED_PRECONDITION nếu lineState không phải là LINE_STATE_PENDING_RESERVATION.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Trường này sẽ chứa tên của dòng cần dành riêng, ví dụ: "orders/123/lines/321"

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
Trường
lineTerms

object (LineTerms)

Bắt buộc. Các điều khoản do người bán đảm bảo cho dòng này.
reservationExpirationTime

string (Timestamp format)

Bắt buộc. Dấu thời gian hết hạn của giao dịch đặt chỗ. Người mua cần phải đặt chỗ trước khi yêu cầu đặt trước hết hạn.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Line.

Phạm vi cấp phép

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.