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.
![Hình 1: Các bước tích hợp tổng thể](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/reserve_with_google_waitlist_integration.png?authuser=5&hl=vi)
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:
![Hình 2: Sơ đồ luồng dữ liệu tích hợp](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/waitlist_integration_data_flow_diagram.png?authuser=5&hl=vi)
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.
![Hình 3: Sơ đồ quy trình về trạng thái danh sách chờ](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/waitlist_status_flowchart.png?authuser=5&hl=vi)
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ồiBatchGetWaitEstimates
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ộtWaitLength
với 0parties_ahead_count
và/hoặc vớiestimated_seat_time_range
có 0start_seconds
và 0end_seconds
choparty_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ồiBatchGetWaitEstimates
.
Đâ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ànhWAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS
trongwait_estimate
cho quy mô nhóm cần xác nhận thủ công. Bạn phải đặt giá trị này trongBatchGetWaitEstimateResponse
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ạiCreateWaitlistEntry
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ạiCreateWaitlistEntry
đó. - 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ầuBatchGetWaitEstimates
. - Trả về
WAITLIST_CLOSED
cho các yêu cầuCreateWaitlistEntry
. - 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.