REST Resource: notification.partners.bookings

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

Lịch đặt trước cho một khung giờ 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ã 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 lịch hẹn

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. 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, có tối đa 9 chữ số thập phân, 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 lượt đặt phòng
paymentInformation

object (PaymentInformation)

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

string (int64 format)

Số người tham gia bữa tiệc của lượt đặt trước

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 ứng dụng khách
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 phòng
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 đến cuộc hẹn, 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 yêu cầu đặt phòng một cách không đồng bộ.

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 prepaymentStatus 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 lượt đặt phòng. Để trống nếu không áp dụng.

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 Bạn đã thanh toán trước phí đặt phòng.
PREPAYMENT_NOT_PROVIDED Bạn chưa trả trước phí đặt phòng.
PREPAYMENT_REFUNDED Trước đây, khoản phí nà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ó.