พาร์ทเนอร์ที่เข้าร่วมโปรแกรมคิวรอสำหรับการจองต้องทำการตั้งค่าบัญชีให้เสร็จสมบูรณ์ก่อนจะเริ่มต้น อย่างไรก็ตาม บางขั้นตอนในคู่มือทั่วไปไม่จำเป็นต่อการใช้ฟีเจอร์คิวรอ หลักเกณฑ์ในหน้านี้จะอธิบายว่าขั้นตอนใดมีผลกับพาร์ทเนอร์ที่สนใจใช้ฟีเจอร์คิวรอใน "จองกับ Google" เราขอแนะนำให้คุณอ่านภาพรวมนี้ก่อนที่จะทำตามขั้นตอนการผสานรวม
กระบวนการเปิดตัว
รูปที่ 1 ระบุกระบวนการเปิดตัวผู้ขายที่เปิดใช้คิวรอใน Actions Center
![รูปที่ 1: ขั้นตอนการผสานรวมระดับสูง](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/reserve_with_google_waitlist_integration.png?authuser=0000&hl=th)
โดยรวมแล้ว การรับส่งข้อมูลสําคัญระหว่างคุณ (พาร์ทเนอร์) และ Google จะได้รับการบันทึกไว้ในรูปที่ 2
![รูปที่ 2: แผนภาพโฟลว์ข้อมูลการผสานรวม](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/waitlist_integration_data_flow_diagram.png?authuser=0000&hl=th)
หลักเกณฑ์สำหรับพาร์ทเนอร์คิวรอการจองทั้งหมด
โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อใช้ฟีเจอร์คิวรอการจอง
- บริการสำหรับผู้ขายในคิวรอการจองทุกรายต้องป้อนข้อมูล
waitlist_rules
แล้ว- คุณต้องใช้บริการเดียวกันทั้งในคิวรอและการจอง กล่าวคือ หากร้านอาหารอนุญาตให้จองด้วย ก็เพียงเพิ่มข้อมูลเมตาที่เกี่ยวข้องกับคิวรอลงในบริการสำหรับการจอง
- จําเป็นต้องส่งการอัปเดต SMS เพื่อใช้คิวรอในกรณีต่อไปนี้
- ยืนยันว่าผู้ใช้ได้เข้าร่วมคิวรอเรียบร้อยแล้ว
- เพื่อแจ้งให้ผู้ใช้ทราบว่าตารางพร้อมแล้ว
- เพื่อแจ้งให้ผู้ใช้ทราบว่าระบบยกเลิกคิวรอเรียกแล้ว
- ข้อความ SMS ต้องมีลิงก์ไปยังหน้าที่ผู้ใช้ดูสถานะคิวรอได้
- ผู้ขายที่มีรายชื่อในคิวรอเท่านั้นไม่จำเป็นต้องส่งฟีดความพร้อมจำหน่ายสินค้าไปยัง Actions Center
- เซิร์ฟเวอร์การจองต้องใช้ขั้นตอนเฉพาะสำหรับคิวรอทั้งหมดที่ระบุไว้ในใช้งานเซิร์ฟเวอร์การจอง พาร์ทเนอร์ที่รองรับทั้งการจองและคิวรอสามารถเพิ่มวิธีใหม่ในเซิร์ฟเวอร์การจองที่มีอยู่ได้
- Actions Center จะเรียกใช้ชุดกรอบการทดสอบสำหรับวิธีการเข้าคิวรอในเซิร์ฟเวอร์การจอง
โฟลว์ชาร์ตสถานะ
แผนภูมินี้อธิบายสถานะที่ต้องรายงานใน
WaitlistEntry.waitlist_entry_state
เมื่อตอบกลับการเรียก
GetWaitlistEntry
นอกจากนี้ แผนภูมิยังระบุเวลาที่จะบันทึกและป้อนข้อมูลในช่อง
WaitlistEntry.waitlist_entry_state_times.*_time_seconds
และเวลาที่ต้องการส่ง SMS ถึงผู้ใช้เพื่อแจ้งว่าได้เข้าสู่สถานะใหม่
![รูปที่ 3: โฟลว์ชาร์ตสถานะคิวรอ](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/waitlist_status_flowchart.png?authuser=0000&hl=th)
กรณีสุดโต่งที่พบบ่อย
กรณีต่อไปนี้มักพบได้บ่อยในการผสานรวมคิวรอการจองและโซลูชันที่แนะนำให้ใช้
-
หากขนาดกลุ่มบางขนาด (แต่ไม่ใช่ทั้งหมด) ไม่ยอมรับคิวรอเพิ่มคิวใหม่ เนื่องจากไม่ต้องรอขนาดกลุ่มเหล่านี้ จากนั้นจะแสดงผล
WaitEstimates
สำหรับขนาดกลุ่มทุกขนาดในการตอบกลับBatchGetWaitEstimates
และอนุญาตให้ผู้ใช้เข้าร่วมคิวรอสำหรับขนาดกลุ่มเหล่านี้โดยไม่ต้องรอ คืนเงินWaitLength
ที่มีparties_ahead_count
เป็น 0 และ/หรือที่มีestimated_seat_time_range
ที่มี 0start_seconds
และ 0end_seconds
สำหรับparty_size
โดยไม่ต้องรอ -
หากจำนวนแขกอย่างน้อย 1 จำนวนไม่ยอมรับการเพิ่มคิวรอใหม่ เนื่องจากใช้เวลารอนานเกินไป เราขอแนะนำให้ละเว้น
WaitEstimates
สำหรับขนาดกลุ่มดังกล่าวในการตอบกลับBatchGetWaitEstimates
เราขอแนะนำให้ใช้วิธีการเหล่านี้เนื่องจากให้ตัวเลือกแก่ผู้ใช้ แม้ว่าคิวรอของผู้ขายอาจยังไม่เปิดอย่างเต็มรูปแบบ
หลักเกณฑ์สำหรับพาร์ทเนอร์คิวรอสำหรับการจองเท่านั้น
โปรดทราบว่าหากคุณใช้เซิร์ฟเวอร์การจองสำหรับคิวรอเท่านั้น
- พาร์ทเนอร์สำหรับคิวรอสำหรับการจองเท่านั้นจะไม่แสดงฟีดเวลาว่างสำหรับ "จองกับ Google"
- พาร์ทเนอร์การจองคิวเท่านั้นจะไม่ใช้วิธีการจองในเซิร์ฟเวอร์การจอง แต่ให้ใช้งานเซิร์ฟเวอร์การจองกับวิธีการนำคิวรอไปใช้งานแทน
- พาร์ทเนอร์ที่มีคิวรอแบบจองเท่านั้นจะไม่เรียก API ไปยัง Google ซึ่งหมายความว่าพาร์ทเนอร์ที่เป็นคิวรอการจองเท่านั้นไม่จำเป็นต้องสร้างโปรเจ็กต์ระบบคลาวด์หรือระบุอีเมลของนักพัฒนาแอป คุณไม่จำเป็นต้องอัปเดต Real-time API ให้เสร็จสมบูรณ์ อย่างไรก็ตาม ยังจำเป็นต้องระบุฟีดผู้ขายและบริการไปยัง Actions Center
หลักเกณฑ์สำหรับพาร์ทเนอร์ที่มีผู้ขายต้อง ยอมรับ/ปฏิเสธการเพิ่มคิวรอด้วยตนเอง
หากผู้ขายต้องการที่จะยอมรับหรือปฏิเสธการเพิ่มคิวรอใหม่จาก Google ได้ด้วยตนเอง คุณจะต้องดำเนินการเพิ่มเติมดังนี้
- ตั้งค่า
waitlist_confirmation_mode
เป็นWAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS
ในwait_estimate
สำหรับขนาดกลุ่มซึ่งต้องมีการยืนยันด้วยตนเอง ต้องตั้งค่าดังกล่าวในBatchGetWaitEstimateResponse
และGetWaitlistEntryResponse
- รายการคิวรอที่ผู้ใช้ขอแต่ยังไม่ได้ยอมรับโดยผู้ขายควรอยู่ในสถานะ
PENDING_MERCHANT_CONFIRMATION
กรณีการทดสอบคิวรอการจอง
Google จะทดสอบ Use Case ต่อไปนี้เพื่อให้แน่ใจว่าฟังก์ชันการทำงานของเมธอดคิวรอในการใช้งานเซิร์ฟเวอร์การจองของคุณ นอกจากนี้ Google ยังทดสอบและตรวจสอบเวลาในการตอบสนองด้วย การทดสอบทั้งหมดนี้ต้องผ่านก่อนการเปิดตัว
การดึงข้อมูล Waitestimated
- ระบบจะแสดงค่าประมาณการรอสำหรับจำนวนแขกแต่ละขนาดที่ขอใน
BatchGetWaitEstimatesRequest
- สำหรับขนาดกลุ่มซึ่งผู้ขายมีตัวเลือกในการยอมรับหรือปฏิเสธการเพิ่มคิวรอใหม่ ให้ตั้งค่าWaitlist_confirmation_mode เป็น
WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS
การสร้างคิวรอเรียก
- คุณสร้างคิวรอได้จากคำขอ
CreateWaitlistEntry
- หากสร้างคิวรอไม่สำเร็จ ข้อผิดพลาดด้านตรรกะทางธุรกิจจะปรากฏในการตอบกลับ
- หากการลอง
CreateWaitlistEntry
สำเร็จ ระบบจะแสดงผลการตอบสนองเดียวกันนี้เมื่อได้รับCreateWaitlistEntry
เดิมอีกครั้ง - หากดำเนินการ
CreateWaitlistEntry
ไม่สำเร็จ เซิร์ฟเวอร์จะลองใหม่เมื่อได้รับCreateWaitlistEntry
เดิมอีกครั้ง - คิวรอเรียกจะปรากฏในอินเทอร์เฟซของผู้ขาย
- การโทรไปยัง
GetWaitlistEntry
จะส่งกลับคิวรอที่สร้างขึ้นเรียบร้อยแล้ว
สถานะและการประทับเวลาของคิวรอเรียก
- ตรวจสอบว่าได้แสดงผลสถานะของคิวรอแต่ละรายการอย่างถูกต้องในคิวรอของการตอบกลับ
GetWaitlistEntry
- ตรวจสอบว่าได้ตั้งค่าการประทับเวลาสถานะแต่ละรายการในช่องการประทับเวลาที่เหมาะสมของรายการรอเรียกในการตอบกลับ
GetWaitlistEntry
การลบคิวรอ
- คุณลบคิวรอที่มีอยู่ได้ การตอบกลับการลบที่สำเร็จต้องเป็น Proto
{}
ที่ว่างเปล่า
เลือกไม่ใช้
- ตรวจสอบว่าระบบได้ดำเนินการกับผู้ขายที่เลือกไม่รับตามที่อธิบายไว้ในการเลือกไม่ใช้ของผู้ขาย
ตัวอย่างฟีดบริการคิวรอ (JSON)
ฟีดบริการคิวรอผู้ขายเลือกไม่ใช้
Google คาดหวังการตอบกลับบางอย่างสำหรับผู้ขายที่เปิดใช้คิวรอไว้ก่อนหน้านี้ แต่ได้ตัดสินใจเลือกไม่ใช้
เลือกไม่ใช้ทันที
- แสดงผล
CLOSED_OTHER
สำหรับคำขอBatchGetWaitEstimates
- แสดงผล
WAITLIST_CLOSED
สำหรับคำขอCreateWaitlistEntry
- แสดงผลคำขอ
GetWaitlistEntry
อย่างถูกต้องสำหรับผู้ใช้ที่อยู่ในคิวรออยู่แล้ว
การเลือกไม่ใช้แบบขยาย
- นำ
waitlist_rules
ออกจากฟีดบริการสำหรับผู้ขายหากผู้ขายไม่ได้เลือกไม่รับการจอง - นำผู้ขายออกจากฟีดผู้ขายหากผู้ขายเลือกไม่ใช้การผสานรวมทั้งหมดของ Google