Giới thiệu về danh sách chờ

Những đối tác tham gia chương trình danh sách chờ phải hoàn tất tài khoản Thiết lập trước khi bắt đầu. Tuy nhiên, một số bước trong hướng dẫn chung là không cần thiết để sử dụng tính năng danh sách chờ. Hướng dẫn trên trang này giải thích những bước áp dụng cho những đối tác muốn sử dụng tính năng danh sách chờ trên tính năng Đặt chỗ bằng Google. Bạn nên đọc hết phần tổng quan này trước khi thực hiện các bước tích hợp.

Quy trình ra mắt

Hình 1 trình bày quy trình triển khai những người bán đã bật tính năng danh sách chờ trong tính năng Đặt chỗ bằng Google.

Hình 1: Các bước tích hợp cấp cao
Hình 1: Các bước tích hợp cấp cao

Nhìn chung, dữ liệu chính giữa bạn (Đối tác) và Google được thu thập trong Hình 2:

Hình 2: Sơ đồ luồng dữ liệu tích hợp
Hình 2: Sơ đồ luồng dữ liệu tích hợp

Nguyên tắc dành cho tất cả đối tác danh sách chờ

Hãy lưu ý những điều sau khi bạn triển khai tính năng danh sách chờ:

  • Dịch vụ cho mỗi người bán trong danh sách chờ phải được điền sẵn waitlist_rules.
    • Bạn phải sử dụng cùng một dịch vụ cho cả danh sách chờ và dịch vụ đặt trước. Nói cách khác, nếu nhà hàng của bạn cũng cho phép đặt chỗ, thì bạn chỉ cần thêm siêu dữ liệu liên quan đến danh sách chờ vào dịch vụ đặt chỗ.
  • Bạn cần gửi bản cập nhật qua SMS để triển khai danh sách chờ trong những trường hợp sau:
    • Để xác nhận người dùng đã tham gia danh sách chờ thành công.
    • Thông báo cho người dùng rằng bảng của họ đã sẵn sàng.
    • Thông báo cho người dùng rằng danh sách chờ của họ đã bị huỷ.
  • Tin nhắn SMS phải chứa đường liên kết đến trang mà người dùng có thể xem trạng thái danh sách chờ của họ.
  • Người bán chỉ có trong danh sách chờ không cần phải cung cấp nguồn cấp dữ liệu về tính năng Đặt chỗ bằng Google.
  • Máy chủ đặt trước của bạn phải triển khai tất cả các bước dành riêng cho danh sách chờ được liệt kê trong phần Triển khai máy chủ đặt trước. Những đối tác hỗ trợ cả yêu cầu đặt trước và danh sách chờ có thể thêm các phương thức mới vào máy chủ đặt phòng hiện có.
  • Tính năng Đặt chỗ bằng Google chạy một nhóm các trường hợp kiểm tra cho các phương thức danh sách chờ trong máy chủ đặt phòng.

Lưu đồ trạng thái

Biểu đồ này mô tả các trạng thái phải được báo cáo trong WaitlistEntry.waitlist_entry_state khi trả lời cuộc gọi GetWaitlistEntry. Biểu đồ này cũng cho biết thời điểm ghi lại và điền vào các trường WaitlistEntry.waitlist_entry_state_times.*_time_seconds và thời điểm gửi tin nhắn SMS cho người dùng để thông báo rằng họ đã chuyển sang trạng thái mới.

Hình 3: Lưu đồ trạng thái danh sách chờ
Hình: 3 Lưu đồ trạng thái danh sách chờ

Các trường hợp hiếm gặp

Sau đây là những trường hợp hiếm gặp trong việc tích hợp danh sách chờ và các giải pháp ưu tiên của họ.

  • Nếu một số (nhưng không phải tất cả) quy mô bữa tiệc không chấp nhận số lần thêm vào danh sách chờ mới vì không có thời gian chờ ở những quy mô nhóm này, thì việc trả về WaitEstimates cho tất cả quy mô bữa tiệc trong phản hồi BatchGetWaitEstimates sẽ cho phép người dùng tham gia danh sách chờ của những quy mô bữa tiệc không cần đợi. Trả về WaitLength có 0 parties_ahead_count và/hoặc với estimated_seat_time_range có 0 start_seconds và với 0 end_seconds cho party_size mà không cần chờ
  • Nếu một hoặc nhiều quy mô bữa tiệc không chấp nhận số lượt thêm vào danh sách chờ mới vì thời gian chờ quá lâu, thì bạn nên bỏ qua WaitEstimates cho các quy mô bữa tiệc trong phản hồi BatchGetWaitEstimates.

Các phương pháp này được ưu tiên vì chúng cung cấp cho người dùng các lựa chọn mặc dù danh sách chờ của người bán có thể chưa mở hoàn toàn.

Nguyên tắc dành cho đối tác chỉ có danh sách chờ

Lưu ý những điều sau nếu máy chủ đặt phòng chỉ dùng cho danh sách chờ:

  • Các đối tác chỉ có trong danh sách chờ không cung cấp nguồn cấp dữ liệu về tính năng Đặt chỗ bằng Google.
  • Đối tác chỉ có danh sách chờ không triển khai các phương thức đặt phòng trong máy chủ đặt phòng. Thay vào đó, bạn sẽ Triển khai máy chủ đặt phòng theo hướng dẫn để triển khai Danh sách chờ.
  • Các đối tác chỉ có trong danh sách chờ không thực hiện lệnh gọi API tới Google. Điều này có nghĩa là những đối tác chỉ có danh sách chờ không cần phải thiết lập dự án trên đám mây hoặc cung cấp địa chỉ email của nhà phát triển. Bạn không cần phải hoàn tất bản cập nhật API theo thời gian thực. Tuy nhiên, bạn vẫn cần cung cấp nguồn cấp dữ liệu về người bán và dịch vụ cho tính năng Đặt chỗ bằng Google.

Nguyên tắc dành cho đối tác có người bán phải chấp nhận/từ chối bổ sung danh sách chờ theo cách thủ công

Nếu người bán yêu cầu bạn phải chấp nhận hoặc từ chối bổ sung danh sách chờ mới từ Google theo cách thủ công, bạn cần thực hiện thêm một số bước sau:

  • Đặt waitlist_confirmation_mode thành WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS trong wait_estimate cho quy mô bữa tiệc yêu cầu xác nhận thủ công. Bạn phải đặt giá trị này trong BatchGetWaitEstimateResponse và GetWaitlistEntryResponse.
  • Các mục trong danh sách chờ đã được người dùng yêu cầu nhưng chưa được người bán chấp nhận phải ở trạng thái PENDING_MERCHANT_CONFIRMATION.

Các trường hợp kiểm thử trong danh sách chờ

Google kiểm tra những trường hợp sử dụng sau đây để đảm bảo chức năng của các phương thức danh sách chờ trong quá trình triển khai máy chủ đặt phòng. Google cũng kiểm tra và theo dõi độ trễ. Bạn phải vượt qua tất cả các thử nghiệm này trước khi phát hành.

Truy xuất Chờ ước tính

  • Thời gian chờ ước tính sẽ được trả về cho mỗi quy mô bữa tiệc mà bạn yêu cầu trong BatchGetWaitEstimatesRequest.
  • Đối với quy mô bữa tiệc mà người bán có thể chấp nhận hoặc từ chối, hãy đặt danh sách chờ mới trong chế độ WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS.

Tạo mục nhập danh sách chờ

  • Bạn có thể tạo mục nhập danh sách chờ từ yêu cầu CreateWaitlistEntry.
  • Nếu không tạo được mục nhập danh sách chờ, thì lỗi logic kinh doanh sẽ xuất hiện trong phản hồi.
  • Nếu CreateWaitlistEntry thử thành công, hệ thống sẽ trả về cùng một phản hồi khi tiếp nhận lại CreateWaitlistEntry.
  • Nếu CreateWaitlistEntry không thành công thì máy chủ sẽ thử lại khi nhận lại được CreateWaitlistEntry đó.
  • Các mục trong danh sách chờ sẽ xuất hiện trong giao diện của người bán.
  • Các lệnh gọi đến GetWaitlistEntry sẽ trả về thành công mục nhập danh sách chờ đã tạo.

Trạng thái và dấu thời gian của danh sách chờ

  • Xác minh rằng trạng thái của từng mục nhập danh sách chờ được trả về chính xác trong mục nhập danh sách chờ của GetWaitlistEntry phản hồi.
  • Xác minh rằng mỗi dấu thời gian của trạng thái được đặt trong trường dấu thời gian thích hợp của mục nhập danh sách chờ trong phản hồi GetWaitlistEntry.

Xoá mục trong danh sách chờ

  • Bạn có thể xoá những mục hiện có trong danh sách chờ. Phản hồi để xoá thành công phải là proto trống {}.

Chọn không tham gia

Nguồn cấp dữ liệu dịch vụ danh sách chờ mẫu (JSON)

Nguồn cấp dữ liệu dịch vụ danh sách chờ

Người bán chọn không tham gia

Google dự kiến sẽ có một số ý kiến phản hồi nhất định cho những người bán từng bật tính năng danh sách chờ nhưng đã quyết định chọn không tham gia.

Chọn không sử dụng ngay

Chọn không sử dụng mở rộng

  • Xoá waitlist_rules khỏi nguồn cấp dữ liệu dịch vụ cho người bán nếu người bán không từ chối đặt trước.
  • Xoá người bán khỏi nguồn cấp dữ liệu nếu người đó chọn không tham gia tất cả hoạt động tích hợp của Google.