REST Resource: notification.partners.bookings

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

Lượt đặt trước cho vùng 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
}
Các trường
name

string

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

merchantId

string

Mã của người bán cho vùng quảng cáo

serviceId

string

Mã dịch vụ của 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 ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""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ố 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 lượt đặt vé.

partySize

string (int64 format)

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

ClientInformation

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

Biểu diễn dưới dạng JSON
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
Các 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 một lượt đặt phòng

Enum
BOOKING_STATUS_UNSPECIFIED Chưa xác định.
CONFIRMED Đã xác nhận đặt phòng
PENDING_MERCHANT_CONFIRMATION Yêu cầu đặt vé đang chờ người bán xác nhận trước khi 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 Yêu cầu đặt phòng đang chờ khách hàng xác nhận trước khi 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 Yêu cầu đặt vé của bạn đã bị hủy thay mặt cho người dùng.
NO_SHOW Khách hàng không có mặt trong cuộc hẹn
NO_SHOW_PENALIZED Khách hàng không đến cuộc hẹn này do vi phạm chính sách huỷ lịch hẹn.
FAILED Không thể hoàn tất yêu cầu đặt vé do lỗi xử lý.
DECLINED_BY_MERCHANT Người bán đã từ chối lượt đặt trước một cách không đồng bộ.

PaymentInformation

Thông tin thanh toán liên quan đến lượt đặt trước

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

enum (PrepaymentStatus)

Trạng thái thanh toán trước của lượt đặt trước. Nếu paymentStatus 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 liên quan đến lượt đặ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 trước.

Enum
PREPAYMENT_STATUS_UNSPECIFIED Chưa được chỉ định, mặc định là PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED Phí đặt vé đã được thanh toán trước.
PREPAYMENT_NOT_PROVIDED Phí đặt vé chưa được thanh toán trước.
PREPAYMENT_REFUNDED 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 một Booking hiện có.