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)

สถานะการชำระเงินล่วงหน้าของการจอง หากสถานะการชำระล่วงหน้าเป็น 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 ที่มีอยู่