ภาพรวม

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

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

รูปที่ 1 แสดงขั้นตอนในการเปิดตัวผู้ขายที่เปิดใช้การรอรับสินค้าในศูนย์การดําเนินการ

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

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

รูปที่ 2: แผนภาพการไหลของข้อมูลการผสานรวม
รูปที่ 2: แผนภาพการไหลของข้อมูลการผสานรวม

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

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

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

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

แผนภูมินี้อธิบายสถานะที่ต้องรายงานใน 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สำหรับกลุ่มที่มีสมาชิกตั้งแต่ 1 คนขึ้นไปในการตอบกลับBatchGetWaitEstimates

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

หลักเกณฑ์สำหรับพาร์ทเนอร์ที่มีเฉพาะคิวรอสำหรับการจอง

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

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

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

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

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

กรอบการทดสอบคิวรอสำหรับการจอง

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

รอการเรียกข้อมูลค่าประมาณ

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

การสร้างรายการในคิวรอ

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

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

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

การลบรายการในคิวรอ

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

เลือกไม่ใช้

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

ฟีดบริการสำหรับคิวรอ

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

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

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

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

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