ข้อมูลเบื้องต้นเกี่ยวกับคิวรอ

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

ขั้นตอนการเปิดใช้งาน

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

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

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

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

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

ข้อควรทราบเมื่อคุณใช้ฟีเจอร์คิวรอ

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

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

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

รูปที่ 3: โฟลว์ชาร์ตคิวรอ
รูป: 3 โฟลว์ชาร์ตคิวรอ

ตัวพิมพ์ล้ําสมัย

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

  • หากขนาดของปาร์ตี้ (แต่ไม่ใช่ทั้งหมด) ไม่ยอมรับคิวรอใหม่เนื่องจากไม่มีคิวรอสําหรับงานปาร์ตี้ขนาดนี้ ระบบก็จะแสดง WaitEstimates สําหรับปาร์ตี้ทุกขนาดในการตอบสนองของ BatchGetWaitEstimates และอนุญาตให้ผู้ใช้เข้าร่วมคิวรอของปาร์ตี้เหล่านี้โดยไม่ต้องรอ แสดง WaitLength ที่มี 0 parties_ahead_count และ/หรือ estimated_seat_time_range ด้วย 0 start_seconds และ 0 end_seconds สําหรับ party_size โดยไม่ต้องรอ
  • หากขนาดปาร์ตี้อย่างน้อย 1 ตัวไม่ยอมรับการเพิ่มคิวรอใหม่ เนื่องจากต้องรอนานเกินไป จึงไม่ใส่ WaitEstimates สําหรับขนาดกลุ่มเหล่านั้นในการตอบสนองของ BatchGetWaitEstimates

แนะนําให้ใช้แนวทางเหล่านี้เนื่องจากมีตัวเลือกผู้ใช้ แม้ว่าคิวรอของผู้ขายอาจเปิดไม่สมบูรณ์

หลักเกณฑ์สําหรับพาร์ทเนอร์ที่รอคิวเท่านั้น

โปรดคํานึงถึงสิ่งต่อไปนี้หากใช้เซิร์ฟเวอร์การจองสําหรับคิวรอเท่านั้น

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

หลักเกณฑ์สําหรับพาร์ทเนอร์ที่ผู้ขายต้องยอมรับ/ปฏิเสธการเพิ่มคิวรอด้วยตนเอง

หากผู้ขายต้องการให้ยอมรับหรือปฏิเสธการเพิ่มคิวรอใหม่จาก Google ด้วยตนเอง คุณจะต้องดําเนินการเพิ่มเติมดังนี้

  • ตั้งค่า waitlist_confirmation_mode เป็น WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS ใน wait_estimate สําหรับปาร์ตี้ที่ต้องการการยืนยันด้วยตนเอง ซึ่งต้องตั้งค่าใน BatchGetWaitEstimateResponse และ GetWaitlistEntryResponse
  • คิวรอที่ผู้ใช้ขอแล้วแต่ยังไม่ได้ยอมรับผู้ขายควรอยู่ในสถานะPENDING_MERCHANT_CONFIRMATION

กรอบการทดสอบคิวรอ

Google ทดสอบกรณีการใช้งานต่อไปนี้เพื่อให้แน่ใจว่ามีฟังก์ชันการทํางานของเมธอดคิวรอในการใช้งานเซิร์ฟเวอร์การจอง นอกจากนี้ Google ยังทดสอบและตรวจสอบเวลาในการตอบสนองด้วย การทดสอบเหล่านี้ทั้งหมดต้องผ่านก่อนการเปิดตัว

การเรียกข้อมูลโดยประมาณ

  • ระบบจะส่งคืนค่าประมาณการรอคิวของแต่ละขนาดที่ขอใน BatchGetWaitEstimatesRequest
  • สําหรับขนาดปาร์ตี้ที่ผู้ขายมีตัวเลือกในการยอมรับหรือปฏิเสธการเพิ่มคิวรอใหม่ ให้ตั้งค่า setlist_dialog_mode เป็น WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS

การสร้างคิวรอ

  • คุณสร้างคิวรอได้จากคําขอ CreateWaitlistEntry
  • หากการสร้างคิวรอไม่สําเร็จ ข้อผิดพลาดด้านตรรกะทางธุรกิจจะแสดงขึ้นในการตอบสนอง
  • หากพยายามใช้ CreateWaitlistEntry สําเร็จ ระบบจะแสดงผลการตอบกลับเดียวกันเมื่อได้รับ CreateWaitlistEntry เดียวกันอีกครั้ง
  • หากพยายามป้อน CreateWaitlistEntry ไม่สําเร็จ เซิร์ฟเวอร์จะลองใหม่เมื่อได้รับ CreateWaitlistEntry เดียวกันอีกครั้ง
  • คิวรอจะแสดงในอินเทอร์เฟซของผู้ขาย
  • การโทรหา GetWaitlistEntry ส่งคิวรอที่สร้างขึ้นเรียบร้อยแล้ว

สถานะคิวรอและการประทับเวลาของคิวรอ

  • ยืนยันว่ามีรายการคิวรอแต่ละสถานะอย่างถูกต้องในคิวรอของการตอบกลับ GetWaitlistEntry
  • ยืนยันว่าการประทับเวลาแต่ละรายการสถานะกําหนดไว้ในช่องการประทับเวลาที่เหมาะสมของรายการคิวในคําตอบ GetWaitlistEntry รายการ

การลบคิวรอ

  • ลบคิวรอที่มีอยู่ได้ การตอบสนองต่อการลบที่ประสบความสําเร็จต้องเป็นโปรโตคอลว่างเปล่า {}

เลือกไม่ใช้

ตัวอย่างฟีดบริการคิวรอ (JSON)

ฟีดบริการคิวรอ

ผู้ขายเลือกไม่ใช้

Google ต้องการให้ผู้ขายบางรายเปิดใช้คิวรอก่อนหน้านี้ แต่ตัดสินใจเลือกไม่ใช้

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

เลือกไม่ใช้เพิ่มเติม

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