ภาพรวม

พาร์ทเนอร์ที่เข้าร่วมโปรแกรมคิวรอสำหรับการจองต้องทำการตั้งค่าบัญชีให้เสร็จสมบูรณ์ก่อนจะเริ่มต้น อย่างไรก็ตาม บางขั้นตอนในคู่มือทั่วไปไม่จำเป็นต่อการใช้ฟีเจอร์คิวรอ หลักเกณฑ์ในหน้านี้จะอธิบายว่าขั้นตอนใดมีผลกับพาร์ทเนอร์ที่สนใจใช้ฟีเจอร์คิวรอใน "จองกับ Google" เราขอแนะนำให้คุณอ่านภาพรวมนี้ก่อนที่จะทำตามขั้นตอนการผสานรวม

กระบวนการเปิดตัว

รูปที่ 1 ระบุกระบวนการเปิดตัวผู้ขายที่เปิดใช้คิวรอใน Actions Center

รูปที่ 1: ขั้นตอนการผสานรวมระดับสูง
ภาพที่ 1: ขั้นตอนการผสานรวมระดับสูง

โดยรวมแล้ว การรับส่งข้อมูลสําคัญระหว่างคุณ (พาร์ทเนอร์) และ Google จะได้รับการบันทึกไว้ในรูปที่ 2

รูปที่ 2: แผนภาพโฟลว์ข้อมูลการผสานรวม
ภาพที่ 2: แผนภาพโฟลว์ข้อมูลการผสานรวม

หลักเกณฑ์สำหรับพาร์ทเนอร์คิวรอการจองทั้งหมด

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อใช้ฟีเจอร์คิวรอการจอง

  • บริการสำหรับผู้ขายในคิวรอการจองทุกรายต้องป้อนข้อมูล waitlist_rules แล้ว
    • คุณต้องใช้บริการเดียวกันทั้งในคิวรอและการจอง กล่าวคือ หากร้านอาหารอนุญาตให้จองด้วย ก็เพียงเพิ่มข้อมูลเมตาที่เกี่ยวข้องกับคิวรอลงในบริการสำหรับการจอง
  • จําเป็นต้องส่งการอัปเดต SMS เพื่อใช้คิวรอในกรณีต่อไปนี้
    • ยืนยันว่าผู้ใช้ได้เข้าร่วมคิวรอเรียบร้อยแล้ว
    • เพื่อแจ้งให้ผู้ใช้ทราบว่าตารางพร้อมแล้ว
    • เพื่อแจ้งให้ผู้ใช้ทราบว่าระบบยกเลิกคิวรอเรียกแล้ว
  • ข้อความ SMS ต้องมีลิงก์ไปยังหน้าที่ผู้ใช้ดูสถานะคิวรอได้
  • ผู้ขายที่มีรายชื่อในคิวรอเท่านั้นไม่จำเป็นต้องส่งฟีดความพร้อมจำหน่ายสินค้าไปยัง Actions Center
  • เซิร์ฟเวอร์การจองต้องใช้ขั้นตอนเฉพาะสำหรับคิวรอทั้งหมดที่ระบุไว้ในใช้งานเซิร์ฟเวอร์การจอง พาร์ทเนอร์ที่รองรับทั้งการจองและคิวรอสามารถเพิ่มวิธีใหม่ในเซิร์ฟเวอร์การจองที่มีอยู่ได้
  • Actions Center จะเรียกใช้ชุดกรอบการทดสอบสำหรับวิธีการเข้าคิวรอในเซิร์ฟเวอร์การจอง

โฟลว์ชาร์ตสถานะ

แผนภูมินี้อธิบายสถานะที่ต้องรายงานใน WaitlistEntry.waitlist_entry_state เมื่อตอบกลับการเรียก GetWaitlistEntry นอกจากนี้ แผนภูมิยังระบุเวลาที่จะบันทึกและป้อนข้อมูลในช่อง WaitlistEntry.waitlist_entry_state_times.*_time_seconds และเวลาที่ต้องการส่ง SMS ถึงผู้ใช้เพื่อแจ้งว่าได้เข้าสู่สถานะใหม่

รูปที่ 3: โฟลว์ชาร์ตสถานะคิวรอ
ภาพ: 3 โฟลว์ชาร์ตสถานะคิวรอ

กรณีสุดโต่งที่พบบ่อย

กรณีต่อไปนี้มักพบได้บ่อยในการผสานรวมคิวรอการจองและโซลูชันที่แนะนำให้ใช้

  • หากขนาดกลุ่มบางขนาด (แต่ไม่ใช่ทั้งหมด) ไม่ยอมรับคิวรอเพิ่มคิวใหม่ เนื่องจากไม่ต้องรอขนาดกลุ่มเหล่านี้ จากนั้นจะแสดงผล WaitEstimates สำหรับขนาดกลุ่มทุกขนาดในการตอบกลับ BatchGetWaitEstimates และอนุญาตให้ผู้ใช้เข้าร่วมคิวรอสำหรับขนาดกลุ่มเหล่านี้โดยไม่ต้องรอ คืนเงิน WaitLength ที่มี parties_ahead_count เป็น 0 และ/หรือที่มี estimated_seat_time_range ที่มี 0 start_seconds และ 0 end_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 คาดหวังการตอบกลับบางอย่างสำหรับผู้ขายที่เปิดใช้คิวรอไว้ก่อนหน้านี้ แต่ได้ตัดสินใจเลือกไม่ใช้

เลือกไม่ใช้ทันที

การเลือกไม่ใช้แบบขยาย

  • นำ waitlist_rules ออกจากฟีดบริการสำหรับผู้ขายหากผู้ขายไม่ได้เลือกไม่รับการจอง
  • นำผู้ขายออกจากฟีดผู้ขายหากผู้ขายเลือกไม่ใช้การผสานรวมทั้งหมดของ Google
ถัดไป
ขั้นตอนที่ 1: ตั้งค่า