REST Resource: notification.partners.bookings

Tài nguyên: Đặt trước

Lượt đặt trước cho một vị trí khoảng không quảng cáo

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
Trường
name

string

Tên tài nguyên của lượt đặt phòng: partners/{partner ID}/bookings/{booking ID}
merchantId

string

Mã nhận dạng của người bán cho khung giờ
serviceId

string

Mã nhận dạng của dịch vụ người bán
startTime

string (Timestamp format)

Thời gian bắt đầu của khung giờ nhận đặ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".
duration

string (Duration format)

Thời lượng của khung giờ nhận đặt hẹn

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".
clientInformation

object (ClientInformation)

Thông tin cá nhân của khách hàng đặt lịch hẹn
status

enum (BookingStatus)

Trạng thái của yêu cầu đặt phòng
paymentInformation

object (PaymentInformation)

Thông tin về các giao dịch thanh toán liên quan đến việc đặt phòng.
partySize

string (int64 format)

Quy mô bữa tiệc của yêu cầu đặt chỗ

ClientInformation

Thông tin cá nhân về người đặt phòng

Biểu diễn dưới dạng JSON 
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
Trường
givenName

string

Tên của khách hàng
familyName

string

Họ của khách hàng
address

object (PostalAddress)

Địa chỉ của khách hàng
telephone

string

Số điện thoại của khách hàng
email

string

Địa chỉ email của khách hàng

BookingStatus

Trạng thái của lượt đặt phòng

Enum
BOOKING_STATUS_UNSPECIFIED Chưa chỉ định.
CONFIRMED Đã xác nhận yêu cầu đặt vé
PENDING_MERCHANT_CONFIRMATION Lịch hẹn đang chờ người bán xác nhận thì mới có thể chuyển sang trạng thái XÁC NHẬN (trạng thái này hiện KHÔNG được hỗ trợ)
PENDING_CLIENT_CONFIRMATION Lịch hẹn đang chờ khách hàng xác nhận thì mới có thể chuyển sang trạng thái XÁC NHẬN (trạng thái này hiện KHÔNG được hỗ trợ)
CANCELED Đã huỷ lượt đặt phòng thay mặt cho người dùng.
NO_SHOW Khách hàng không đến cuộc hẹn
NO_SHOW_PENALIZED Khách hàng không xuất hiện trong cuộc hẹn do vi phạm chính sách huỷ.
FAILED Không thể hoàn tất việc đặt phòng do lỗi xử lý.
DECLINED_BY_MERCHANT Người bán đã từ chối không đồng bộ yêu cầu đặt vé.

PaymentInformation

Thông tin thanh toán liên quan đến một lượt đặt phòng

Biểu diễn dưới dạng JSON 
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
Trường
prepaymentStatus

enum (PrepaymentStatus)

Trạng thái thanh toán trước của lượt đặt phòng. Nếu paymentsStatus là PREPAYMENT_PROVIDED hoặc PREPAYMENT_REFUNDED, thì paymentTransactionId sẽ chứa mã giao dịch duy nhất được liên kết.
paymentTransactionId

string

Giá trị nhận dạng duy nhất của một giao dịch thanh toán được liên kết với yêu cầu đặt phòng. Để trống nếu không có.

PrepaymentStatus

Trạng thái thanh toán trước của một lượt đặt phòng.

Enum
PREPAYMENT_STATUS_UNSPECIFIED Chưa chỉ định, mặc định là PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED Phí đặt trước đã được thanh toán trước.
PREPAYMENT_NOT_PROVIDED Bạn chưa trả trước phí đặt phòng.
PREPAYMENT_REFUNDED Khoản phí trước đây là PREPAYMENT_PROVIDED nhưng hiện đã được hoàn lại.

Phương thức

patch

 Cập nhật Booking hiện có.