REST Resource: notification.partners.bookings

แหล่งข้อมูล: การจอง

การจองสำหรับช่วงเวลาที่สะดวก

การแสดง JSON 
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
ช่อง
name

string

ชื่อทรัพยากรของการจอง: partners/{partner ID}/bookings/{booking ID}
merchantId

string

รหัสผู้ขายของช่อง
serviceId

string

รหัสบริการของผู้ขาย
startTime

string (Timestamp format)

เวลาเริ่มต้นของช่วงเวลาที่สะดวกสำหรับนัดหมาย

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
duration

string (Duration format)

ระยะเวลาของช่วงเวลาที่สะดวกสำหรับนัดหมาย

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย s เช่น "3.5s"
clientInformation

object (ClientInformation)

ข้อมูลส่วนบุคคลของลูกค้าที่ทำการนัดหมาย
status

enum (BookingStatus)

สถานะการจอง
paymentInformation

object (PaymentInformation)

ข้อมูลเกี่ยวกับธุรกรรมการชำระเงินที่เกี่ยวข้องกับการจอง
partySize

string (int64 format)

จํานวนผู้จอง

ClientInformation

ข้อมูลส่วนบุคคลเกี่ยวกับบุคคลที่ทำการจอง

การแสดง JSON 
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
ช่อง
givenName

string

ชื่อจริงของลูกค้า
familyName

string

นามสกุลของลูกค้า
address

object (PostalAddress)

ที่อยู่ของลูกค้า
telephone

string

หมายเลขโทรศัพท์ของลูกค้า
email

string

อีเมลของลูกค้า

BookingStatus

สถานะการจอง

Enum
BOOKING_STATUS_UNSPECIFIED ไม่ได้ระบุ
CONFIRMED การจองได้รับการยืนยันแล้ว
PENDING_MERCHANT_CONFIRMATION การจองกำลังรอการยืนยันจากผู้ขายก่อนที่จะเปลี่ยนเป็นสถานะ "ยืนยันแล้ว" ได้ (ขณะนี้ระบบยังไม่รองรับ)
PENDING_CLIENT_CONFIRMATION การจองกำลังรอการยืนยันจากลูกค้าก่อนที่จะเปลี่ยนเป็นสถานะ "ยืนยันแล้ว" (ขณะนี้ระบบยังไม่รองรับ)
CANCELED ยกเลิกการจองในนามของผู้ใช้แล้ว
NO_SHOW ลูกค้าไม่มาตามนัดหมาย
NO_SHOW_PENALIZED ลูกค้าไม่มาตามนัดหมายซึ่งละเมิดนโยบายการยกเลิก
FAILED ดำเนินการจองให้เสร็จสมบูรณ์ไม่ได้เนื่องจากประมวลผลไม่สำเร็จ
DECLINED_BY_MERCHANT ผู้ขายปฏิเสธการจองแบบไม่เป็นไปพร้อมกัน

PaymentInformation

รายละเอียดการชำระเงินที่เกี่ยวข้องกับการจอง

การแสดง JSON 
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
ช่อง
prepaymentStatus

enum (PrepaymentStatus)

สถานะการชําระเงินล่วงหน้าของการจอง หาก prepaymentStatus เป็น PREPAYMENT_PROVIDED หรือ PREPAYMENT_REFUNDED แสดงว่า paymentTransactionId มีรหัสธุรกรรมที่ไม่ซ้ำกันที่เกี่ยวข้อง
paymentTransactionId

string

ตัวระบุที่ไม่ซ้ำกันสำหรับธุรกรรมการชำระเงินที่เชื่อมโยงกับการจอง เว้นว่างไว้หากไม่เกี่ยวข้อง

PrepaymentStatus

สถานะการชําระเงินล่วงหน้าของการจอง

Enum
PREPAYMENT_STATUS_UNSPECIFIED หากไม่ได้ระบุ ระบบจะใช้ค่าเริ่มต้นเป็น PREPAYMENT_NOT_PROVIDED
PREPAYMENT_PROVIDED ชำระค่าธรรมเนียมสำหรับการจองล่วงหน้าแล้ว
PREPAYMENT_NOT_PROVIDED ยังไม่ได้ชำระค่าธรรมเนียมการจองล่วงหน้า
PREPAYMENT_REFUNDED ก่อนหน้านี้มีการเรียกเก็บค่าธรรมเนียม PREPAYMENT_PROVIDED แต่ตอนนี้มีการคืนเงินแล้ว

เมธอด

patch

 อัปเดต Booking ที่มีอยู่