Tổng quan

Các đối tác tham gia chương trình Danh sách chờ đặt trước phải hoàn tất quá 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ờ. 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ờ trong nền tảng Đặt chỗ bằng Google. Bạn nên đọc kỹ nội dung 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 ra mắt 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 ghi lại trong Hình 2:

Nguyên tắc dành cho mọi đối tác là danh sách chờ Đặt chỗ

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

• Dịch vụ cho mọi người bán có danh sách chờ Đặt trước phải có waitlist_rules đ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à mục đặt chỗ. 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 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 rằng người dùng đã tham gia thành công vào danh sách chờ.
  • Để 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 nhập danh sách chờ của họ đã bị huỷ.
• Tin nhắn 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 trong danh sách chờ.
• Người bán chỉ có quyền trong 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 Actions Center.
• 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 nêu trong phần Triển khai máy chủ đặt trước. Những đối tác hỗ trợ cả hoạt độ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 tại của họ.
• Trung tâm hành động chạy một tập hợp các trường hợp kiểm thử cho các phương thức danh sách chờ trong máy chủ đặt chỗ.

Sơ đồ quy trình về 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 các lệnh gọi GetWaitlistEntry . Biểu đồ này cũng cho biết thời điểm cần 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 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

Sau đây là những 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 những trường hợp đó.

• Nếu một số (nhưng không phải tất cả) quy mô bên không chấp nhận thêm tên trong danh sách chờ vì không phải chờ đối với các quy mô bên này, thì hãy trả về WaitEstimates cho tất cả quy mô bên trong phản hồi BatchGetWaitEstimates và cho phép người dùng tham gia danh sách chờ cho các quy mô nhóm này mà không cần phải chờ. Trả về một WaitLength với 0 parties_ahead_count và/hoặc với estimated_seat_time_range có 0 start_seconds và 0 end_seconds cho party_size mà không cần chờ
• Nếu một hoặc nhiều quy mô bên không chấp nhận nội dung được 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 quy mô bên đó trong phản hồi BatchGetWaitEstimates.

Đây là những phương pháp đượ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 hoạt động hết.

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

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

• Đối tác chỉ hoạt động trong 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 hàng cho tính năng Đặt chỗ bằng Google.
• Đối tác chỉ dùng danh sách chờ Đặt chỗ không triển khai các phương thức đặt trước trong máy chủ đặt trước của họ. Thay vào đó, bạn Triển khai máy chủ đặt trước bằng hướng dẫn triển khai danh sách chờ.
• Các đối tác chỉ dùng danh sách chờ Đặt chỗ không thực hiện lệnh gọi API tới Google. Điều này có nghĩa là các đối tác chỉ dùng danh sách chờ Đặt trước 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 quy trình 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à nguồn cấp dữ liệu 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 danh sách chờ theo cách thủ công

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

• Đặt waitlist_confirmation_mode thành WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS trong wait_estimate cho quy mô nhóm 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 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ử cho Dành riêng cho Danh sách chờ

Google sẽ 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 thử và theo dõi độ trễ. Tất cả các kiểm thử này phải vượt qua trước khi khởi chạy.

Truy xuất WaitEstimate

• Thời gian chờ ước tính sẽ được trả về cho từng quy mô bên được 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 việc bổ sung danh sách chờ mới, hãy đặt Contextual_confirmation_mode thành 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 của CreateWaitlistEntry.
• Nếu không tạo được mục nhập danh sách chờ, thì lỗi logic nghiệp vụ sẽ xuất hiện trong phản hồi.
• Nếu lần thử CreateWaitlistEntry thành công, phản hồi tương tự sẽ được trả về khi nhận lại CreateWaitlistEntry tương tự.
• Nếu lần thử CreateWaitlistEntry không thành công, máy chủ sẽ thử lại khi nhận được lại 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 mục trong danh sách chờ

• Xác minh rằng từng trạng thái của mục nhập danh sách chờ được trả về đúng cách 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 đều đượ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 GetWaitlistEntry phản hồi.

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 cho việc xoá thành công phải là proto {} trống.

Chọn không tham gia

• Kiểm tra để đảm bảo 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ờ

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

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

Chọn không tham gia 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ề đúng cách yêu cầu GetWaitlistEntry cho những người dùng đã có trong danh sách chờ.

Chọn không tham gia mở rộng

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