Tổng quan

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

Quy trình khởi chạy

Hình 1 trình bày quy trình ra mắt những người bán đã bật danh sách chờ trên Trung tâm hành động.

Nhìn chung, các luồng dữ liệu chính giữa bạn (Đối tác) và Google được mô tả trong Hình 2:

Nguyên tắc dành cho tất cả đối tác sử dụng tính năng Danh sách chờ đặt chỗ

Hãy lưu ý những điều sau khi triển khai tính năng Danh sách chờ đặt trước:

• Dịch vụ của mọi người bán có Danh sách chờ đặt trước phải có waitlist_rules được điền sẵn.
  • Bạn phải sử dụng cùng một dịch vụ cho cả danh sách chờ và đặt chỗ. Nói cách khác, nếu nhà hàng của bạn cũng cho phép đặt chỗ, 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 phải gửi thông tin cập nhật qua SMS để triển khai danh sách chờ trong các 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àn của họ đã sẵn sàng.
  • Để thông báo cho người dùng rằng mục thông tin của họ trong danh sách chờ đã bị huỷ.
• Thông báo qua SMS phải chứa đường liên kết đến một trang mà người dùng có thể xem trạng thái của họ trong danh sách chờ.
• Những người bán chỉ có danh sách chờ không cần cung cấp nguồn cấp dữ liệu về tình trạng còn hàng cho Trung tâm hành động.
• Máy chủ đặt phòng 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 phòng. Những đối tác hỗ trợ cả tính năng đặ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ó.
• Trung tâm hành động chạy một tập hợp trường hợp kiểm thử cho các phương thức danh sách chờ trong máy chủ đặt phòng.

Sơ đồ quy trình 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 phản hồi lệnh 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 cũng như 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.

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

Sau đây là các trường hợp hiếm gặp thường gặp trong quá trình tích hợp Danh sách chờ đặt trước và các giải pháp ưu tiên cho các trường hợp này.

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

Bạn nên sử dụng các phương pháp này vì chúng cung cấp cho người dùng các lựa chọn ngay cả khi danh sách chờ của người bán có thể chưa hoàn toàn mở.

Nguyên tắc dành cho những đối tác chỉ sử dụng tính năng Danh sách chờ đặt chỗ

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

• Những đối tác chỉ cung cấp danh sách chờ đặt chỗ không cung cấp nguồn cấp dữ liệu về tình trạng còn phòng cho tính năng Đặt chỗ bằng Google.
• Đối tác chỉ sử dụng tính năng Danh sách chờ đặt phòng 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 bằng hướng dẫn triển khai Danh sách chờ.
• Đối tác chỉ sử dụng tính năng Danh sách chờ đặt phòng không thực hiện lệnh gọi API đến Google. Điều này có nghĩa là đối tác chỉ có danh sách chờ đặt trước không cần 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 hoàn tất phầ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 người bán và dịch vụ cho Trung tâm hành động.

Nguyên tắc dành cho những đối tác mà người bán phải chấp nhận/từ chối việc thêm vào danh sách chờ theo cách thủ công

Nếu người bán của bạn yêu cầu có thể chấp nhận hoặc từ chối việc thêm người dùng mới vào danh sách chờ từ Google theo cách thủ công, thì bạn cần thực hiện thêm các bước sau:

• Đặt waitlist_confirmation_mode thành WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS trong wait_estimate cho các quy mô bữa tiệc cần 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ờ mà người dùng đã yêu cầu nhưng người bán chưa chấp nhận sẽ ở trạng thái PENDING_MERCHANT_CONFIRMATION.

Các trường hợp kiểm thử Danh sách chờ đặt chỗ

Google kiểm thử các 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à giám sát độ trễ. Tất cả các bài kiểm thử này đều phải đạt trước khi phát hành.

Truy xuất WaitEstimate

• Hệ thống sẽ trả về thời gian chờ ước tính cho mỗi số lượng người tham gia được yêu cầu trong BatchGetWaitEstimatesRequest.
• Đối với số lượng người tham dự mà người bán có thể chấp nhận hoặc từ chối việc thêm người tham dự mới vào danh sách chờ, hãy đặt waitlist_confirmation_mode thành WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS.

Tạo mục thông tin trong danh sách chờ

• Bạn có thể tạo một mục trong danh sách chờ từ yêu cầu CreateWaitlistEntry.
• Nếu không tạo được mục trong danh sách chờ, lỗi logic nghiệp vụ sẽ xuất hiện trong phản hồi.
• Nếu một lần thử CreateWaitlistEntry thành công, thì hệ thống sẽ trả về cùng một phản hồi khi nhận lại cùng một CreateWaitlistEntry.
• Nếu một lần thử CreateWaitlistEntry không thành công, máy chủ sẽ thử lại khi nhận lại cùng một 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 trả về thành công mục danh sách chờ đã tạo.

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

• Xác minh rằng mỗi trạng thái mục trong danh sách chờ được trả về đúng cách trong mục trong danh sách chờ của phản hồi GetWaitlistEntry.
• Xác minh rằng mỗi dấu thời gian 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 thông tin trong danh sách chờ

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

Chọn không tham gia

• Xác minh rằng những người bán chọn không tham gia được xử lý như mô tả trong phần Chọn không tham gia của người bán.

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 mong đợi một số phản hồi nhất định đối với những người bán trước đây đã bật danh sách chờ nhưng đã quyết định chọn không sử dụng.

Chọn không sử dụng ngay lập tức

• Trả về CLOSED_OTHER cho các yêu cầu BatchGetWaitEstimates.
• Trả về WAITLIST_CLOSED cho các yêu cầu CreateWaitlistEntry.
• Trả về yêu cầu GetWaitlistEntry đúng cách cho những người dùng đã có tên trong danh sách chờ.

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ụ của người bán nếu người bán không chọn không sử dụng tính năng đặt trước.
• Xoá người bán khỏi nguồn cấp dữ liệu người bán nếu họ chọn không sử dụng tất cả các công cụ tích hợp của Google.