การจองแบบพร้อมกันหมายถึงการจองที่ยืนยันแล้วหรือปฏิเสธ แบบเรียลไทม์
การจองแบบไม่พร้อมกันหมายถึงการจองที่ผู้ขายยืนยัน หรือ ถูกปฏิเสธในภายหลัง
การจองมีการระบุว่าเป็นแบบซิงโครนัสหรืออะซิงโครนัสที่ ระดับความพร้อมจำหน่ายสินค้า และยังหมายความว่าสำหรับผู้ขายและบริการแต่ละราย อาจมีสล็อตเวลาว่างทั้งแบบซิงโครนัสและอะซิงโครนัส
ระบุหมวดหมู่ก่อนจึงจะพิจารณาการนำไปใช้ที่เหมาะสมได้ พื้นที่โฆษณาของคุณจัดอยู่ในหมวดหมู่ใด
- การเปิดใช้การจองแบบพร้อมกันเท่านั้น ผู้ขายและบริการทั้งหมดจะได้รับการยืนยันในทันที
- การเปิดใช้การจองแบบไม่พร้อมกัน ผู้ขายและบริการบางส่วนหรือทั้งหมดต้องใช้คู่มือผู้ขาย ยืนยัน
เกณฑ์การจองแบบไม่พร้อมกัน
- การแก้ไขการจองแบบไม่พร้อมกันใน Actions Center ไม่ได้ ที่รองรับ
- ผู้ขายควรสามารถยอมรับหรือปฏิเสธการจองผ่าน ระบบออนไลน์ของพาร์ทเนอร์ (เช่น แผงโฮสต์สำหรับร้านอาหาร) การเรียกใช้ ในนามของผู้ใช้เพื่อพิจารณาว่าผู้ขายยอมรับ การปฏิเสธการจองนั้นไม่ได้รับอนุญาต
- ระบบไม่รองรับข้อเสนอเวลาการจองใหม่ของผู้ขาย คำขอจองต้องได้รับการยอมรับหรือปฏิเสธในสถานะเดิม
การเปิดใช้การจองแบบพร้อมกันเท่านั้น
การติดตั้งใช้งานมาตรฐานจะมีค่าเริ่มต้นเป็นการจองแบบพร้อมกัน โปรดปรึกษา โปรดดูข้อมูลเพิ่มเติมในเอกสารการผสานรวมจากต้นทางถึงปลายทางสำหรับการจอง
การเปิดใช้การจองแบบไม่พร้อมกัน
หากผู้ขายบางรายหรือทุกรายใช้ขั้นตอนการจองแบบไม่พร้อมกัน ต้องดำเนินการเปลี่ยนแปลงดังต่อไปนี้
-
โหมดการยืนยัน: แสดงสล็อตความพร้อมให้บริการทั้งหมดแล้ว มีช่อง
confirmation_mode
ที่อธิบายวิธีการจอง ของช่วงเวลาว่างได้รับการยืนยัน ระบุconfirmation_mode
ของช่วงเวลาว่างแต่ละช่องสําหรับ ดังต่อไปนี้:- ในฟีดความพร้อมจำหน่ายสินค้า มีการระบุ
confirmation_mode
ที่ ระดับความพร้อมจำหน่ายสินค้า - ในเมธอด Booking Server API มีการระบุ
confirmation_mode
ที่ ระดับช่องโฆษณา - ในเมธอด API การอัปเดตแบบเรียลไทม์ มีการระบุ
confirmation_mode
แล้ว ที่ระดับความพร้อมใช้งาน
- ในฟีดความพร้อมจำหน่ายสินค้า มีการระบุ
- สถานะการจอง: การนำเสนอการจองทั้งหมดประกอบด้วย
status
ที่แสดงสถานะการจอง 3 ครั้ง เปิดตัวค่าสถานะแบบอะซิงโครนัสใหม่:PENDING_CONFIRMATION
DECLINED_BY_MERCHANT
และFAILED
ใช้ค่าสถานะใหม่เหล่านี้เมื่อ การประมวลผลการสร้าง การปฏิเสธ และความล้มเหลวของการจองแบบไม่พร้อมกัน - การอัปเดตการจอง: การอัปเดตแบบไม่พร้อมกันทั้งหมดสถานะของ ควรรายงานการจองผ่าน Booking Notification API bookings.patch
แผนภาพด้านล่างแสดงวิธีใช้โหมดการยืนยันและสถานะการจอง ในการโต้ตอบการจองแบบไม่พร้อมกันตามปกติ
![รูปที่ 1: ขั้นตอนการจองแบบไม่พร้อมกัน](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/enabling_async_1.png?authuser=5&hl=th)
- อัปเดตฟีดความพร้อมจำหน่ายสินค้าแล้วเพื่อให้ช่องความพร้อมจำหน่ายสินค้าแต่ละช่อง ระบุโหมดยืนยัน สิ่งสำคัญก็คือคุณจะต้องมีข้อมูลนี้ ฟีดเพื่อให้เราสามารถอธิบายลักษณะ แบบไม่พร้อมกันของการจองเพื่อ ผู้ใช้ตั้งแต่ช่วงต้นของขั้นตอน
- วันและเวลา
BatchAvailabilityLookup
หรือCheckAvailability
ที่เรียกว่า เราจะส่งต่อโหมดการยืนยัน ซึ่งจะเป็นโหมดการยืนยันเดียวกัน ส่งคืนแล้ว วิธีนี้ช่วยให้มั่นใจว่าผู้ใช้จะเห็นข้อความที่เหมาะสม - วันและเวลา
CreateBooking
เรียกว่า เราจะส่งโหมดการยืนยันไปให้ ระบุโหมดการยืนยันที่คาดไว้ เมื่อการจองแบบไม่พร้อมกัน ส่งคำขอแล้ว ระบบส่งคืนการจองพร้อมสถานะPENDING_MERCHANT_CONFIRMATION
- เมื่อผู้ขายยอมรับหรือปฏิเสธคำขอจอง การจอง อัปเดตสถานะได้ผ่านการอัปเดต Booking Notification API แบบเรียลไทม์ bookings.patch หากต้องการปฏิเสธการจองที่ไม่ได้ ตอบกลับอย่างทันท่วงที โดยใช้การอัปเดตแบบเรียลไทม์แบบเดียวกัน
ฟีดความพร้อมใช้งาน
ในฟีดความพร้อมจำหน่ายสินค้า ให้ระบุว่าจะให้แต่ละช่องแบบพร้อมกันหรือ
ไม่พร้อมกัน โดยตั้งค่า confirmation_mode
ใหม่
ด้วย
// Mode by which bookings for an availability slot are confirmed. enum ConfirmationMode { // The confirmation mode was not specified. // Synchronous confirmation will be assumed. CONFIRMATION_MODE_UNSPECIFIED = 0; // Bookings for this availability will be confirmed synchronously. CONFIRMATION_MODE_SYNCHRONOUS = 1; // Bookings for this availability will be confirmed asynchronously. CONFIRMATION_MODE_ASYNCHRONOUS = 2; }
แม้ว่าโหมดการยืนยันจะถือว่าเป็นแบบซิงโครนัสหากไม่มีโหมด ขอแนะนำให้ระบุโหมดอย่างชัดเจนตั้งแต่ ซึ่งช่วยขจัดความสับสนเกี่ยวกับการละเว้นโดยไม่ตั้งใจได้
Async
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
ซิงค์
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] }
ไม่พร้อมกันและการซิงค์
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, { "merchant_id": "10002", "service_id": "1000", "spots_open": 4, "spots_total": 4, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 2 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
เซิร์ฟเวอร์การจอง
BatchAvailabilityLookup หรือ CheckAvailability
ใน
BatchAvailabilityLookupResponse
(BAL)
หรือ
CheckAvailabilityResponse
(CA) แสดงผล confirmation_mode
เดียวกันกับที่ระบุไว้ใน
ความพร้อมจำหน่ายสินค้าและส่งผ่าน
BatchAvailabilityLookupRequest
หรือ
CheckAvailabilityRequest
BAL-Async
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "available": true } ] }
ซิงค์ BAL
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "available": true } ] }
CA-Async
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
การซิงค์ CA
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CreateBooking
ตรวจสอบว่าได้ส่งคืนสถานะที่ถูกต้องสำหรับการจองโดยใช้ ตัวเลือกด้านล่างนี้
// Status of a booking. // // Updating booking status does not change the status of the associated payment. // Prepayment status updates should be done using the PrepaymentStatus enum. enum BookingStatus { // Not specified. BOOKING_STATUS_UNSPECIFIED = 0; // Booking has been confirmed CONFIRMED = 1; // Booking is awaiting confirmation by the merchant before it can transition // into CONFIRMED status. Only applicable to non-payments Dining or // Beauty verticals. PENDING_MERCHANT_CONFIRMATION = 2; // Booking has been canceled on behalf of the user. // The merchant can still trigger a manual refund. CANCELED = 3; // User did not show for the appointment NO_SHOW = 4; // User did not show for the appointment in violation of the cancellation // policy. NO_SHOW_PENALIZED = 5; // Booking could not be completed by the async backend due to a failure. FAILED = 6; // Booking was asynchronously declined by the merchant. Only applicable to // non-payments Dining or Beauty verticals. DECLINED_BY_MERCHANT = 7; }
ใน CreateBookingResponse
แสดงผล confirmation_mode
ปัจจุบันสำหรับช่องแบบรวมของการจองที่ระบุ
ใน CreateBookingRequest นอกจากนี้ เมื่อการจองเป็น
แบบไม่พร้อมกัน
ตั้งค่า status
เป็น PENDING_MERCHANT_CONFIRMATION
โปรดตรวจดู
confirmation_mode
คือสิ่งที่ผู้ใช้และการจองด้วย
Google คาดว่าจะหลีกเลี่ยงไม่ให้ผู้ใช้สับสน
Async
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "PENDING_MERCHANT_CONFIRMATION" } }
ซิงค์
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "CONFIRMED" } }
UpdateBooking
ในการแก้ไขแบบไม่ซิงค์ครั้งแรก ผู้ใช้แก้ไขการจองที่มีอยู่ ไม่ได้รับการสนับสนุน ผู้ใช้ควรยกเลิกการจองและสร้าง การจองใหม่
การอัปเดตแบบเรียลไทม์
สำหรับการอัปเดตความพร้อมแบบเรียลไทม์ confirmation_mode
ควรระบุ โดยจะมีผลกับวิธีการต่อไปนี้
พื้นที่โฆษณา RTU (ReplaceServiceAvailability หรือ BatchReplaceServiceAvailability)
การใช้
availability.replace
(แบบกลุ่ม)
หรือ
services.availability.replace
วิธี
ตั้งค่า confirmation_mode
เป็น CONFIRMATION_MODE_ASYNCHRONOUS
ใน Availability
Async
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] } ] }
ซิงค์
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
ไม่พร้อมกันและการซิงค์
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, { "startTime": "2014-10-03T11:00:00.00Z", "duration": "5400s", "spotsOpen": "1", "spotsTotal": "1", "availabilityTag": "1000002", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
API การแจ้งเตือนการจอง
การอัปเดตสถานะการจองแบบไม่พร้อมกันควรทำผ่านการจอง เมธอด bookings.patch ของ API การแจ้งเตือน
เมื่ออัปเดตสถานะ โปรดระบุชื่อช่อง status
ใน
updateMask
สถานะ | คำอธิบาย |
---|---|
ยืนยันแล้ว | ผู้ขายยืนยันการจองแล้ว |
ล้มเหลว | พาร์ทเนอร์ยืนยันหรือปฏิเสธการจองกับผู้ขายไม่ได้ |
DECLINED_BY_MERCHANT | ผู้ขายปฏิเสธการจอง |
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"DECLINED_BY_MERCHANT"}
ในกรณีที่จองไม่สำเร็จ ให้ตั้งสถานะการจองเป็น FAILED
และ
ระบุ billing_failure ถ้าตั้งค่าสถานะเป็น "อื่นๆ"
ละเว้น booking_failure
แล้ว
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status&booking_failure.cause="SLOT_UNAVAILABLE" Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"FAILED"}
การแจ้งเตือนทางอีเมล
สำหรับการจองแบบไม่พร้อมกัน มีอีเมล 5 ฉบับที่อาจเกี่ยวข้องกับ สถานะของการจองที่ส่งให้ผู้ใช้
PENDING_MERCHANT_CONFIRMATION
CONFIRMED
DECLINED_BY_MERCHANT
FAILED
CANCELED