Bạn cần có một Máy chủ đặt phòng để cho phép Trung tâm hành động thực hiện các lệnh gọi lại nhằm tạo và cập nhật thông tin đặt phòng thay mặt bạn. Điều này cho phép Actions Center tạo cuộc hẹn, lượt đặt chỗ và lượt đặt trước với bạn thay mặt cho người dùng.
Để tìm hiểu cách định cấu hình kết nối với Máy chủ đặt phòng trong Hộp cát và Máy chủ đặt phòng thực tế, hãy xem bài viết Định cấu hình thông tin đăng nhập của máy chủ đặt phòng.
Hoàn thành các việc cần làm sau đây để chuẩn bị cho Máy chủ đặt phòng trước khi chuyển sang phần Cập nhật theo thời gian thực:
- Trạng thái sẵn sàng tải trang BatchAvailabilityLookup
- BatchAvailabilityLookup slot click Ready
- CreateBooking Ready
- UpdateBooking Ready
- Bật trình kiểm tra tình trạng còn hàng trong phần Tính năng tài khoản của Cấu hình Actions Center
Mỗi nhiệm vụ sẽ được đánh dấu là đã hoàn thành và chuyển sang màu xanh lục khi bạn gửi thông tin chi tiết chính xác về kho hàng theo thời gian thực đến các yêu cầu của Máy chủ đặt phòng thông qua quy trình đặt phòng trong Hộp cát. Các cột mốc của Máy chủ đặt phòng được phân tích trong khoảng thời gian 14 ngày.
Triển khai giao diện API REST
Triển khai một giao diện API dựa trên REST. Điều này cho phép Google gửi các yêu cầu đến Máy chủ đặt phòng qua HTTPS.
Để triển khai một giao diện API, hãy thiết lập một Máy chủ đặt phòng phát triển hoặc hộp cát kết nối với môi trường hộp cát của Trung tâm hành động. Chỉ chuyển sang môi trường Sản xuất sau khi bạn kiểm thử đầy đủ máy chủ Hộp cát.
Tất cả các yêu cầu của Máy chủ đặt vé của Google đều liên quan đến URL Máy chủ đặt vé được đặt trên trang Máy chủ đặt vé. Ví dụ: nếu bạn đặt URL thành api.example.com/google, thì tất cả các yêu cầu HealthCheck sẽ được gửi đến api.example.com/google/v3/HealthCheck.
Đảm bảo rằng bạn đã định cấu hình đúng điểm cuối của Máy chủ đặt phòng cho cả môi trường Hộp cát và Môi trường sản xuất bằng bộ chuyển đổi môi trường.
Bảo mật và xác thực
Mọi hoạt động giao tiếp với Máy chủ đặt phòng đều diễn ra qua HTTPS bằng phương thức xác thực cơ bản. Để thiết lập máy chủ, bạn nên sử dụng một công cụ xác minh SSL hoặc TLS có sẵn công khai, chẳng hạn như thử nghiệm máy chủ SSL của Qualys.
Tất cả các yêu cầu mà Google gửi đến Máy chủ đặt phòng của bạn đều được xác thực bằng phương thức xác thực cơ bản HTTPS. Bạn có thể nhập thông tin xác thực cơ bản, mật khẩu và tên người dùng của Máy chủ đặt phòng trên trang cấu hình Máy chủ đặt phòng của Actions Center. Bạn phải thay đổi thông tin đăng nhập sau mỗi 6 tháng.
Tạo máy chủ đặt phòng
Máy chủ đặt phòng xác định cách tích hợp giao tiếp với hệ thống của bạn, đồng thời tạo hoặc cập nhật thông tin đặt phòng. Để định cấu hình kết nối với Máy chủ đặt phòng trong môi trường thử nghiệm và Máy chủ đặt phòng thực tế, hãy xem phần Định cấu hình thông tin đăng nhập máy chủ đặt phòng.
Mọi phản hồi mà Máy chủ đặt phòng của bạn đưa ra cho yêu cầu từ Đặt chỗ qua Google đều phải chứa thông tin chính xác về kho hàng theo thời gian thực. Bảng sau đây cho biết các phương thức cho từng cách triển khai và bao gồm các đường liên kết đến định dạng giao thức dịch vụ:
| Phương thức | Định nghĩa | Phản hồi | Yêu cầu HTTP |
|---|---|---|---|
Tải trang BatchAvailabilityLookup |
Khi người dùng nhấp vào Đặt bàn cho người bán của bạn, yêu cầu Tải trọng chứa nhiều khung giờ dựa trên nội dung bạn tải lên Nguồn cấp dữ liệu gần đây nhất mà tính năng Đặt chỗ bằng Google cho là có sẵn. |
Phản hồi phải bao gồm mọi yêu cầu về vị trí và tình trạng còn trống hiện tại của vị trí đó. Việc này giúp ngăn mọi khung giờ không còn trống xuất hiện. | POST /v3/BatchAvailabilityLookup/ |
BatchAvailabilityLookup lượt nhấp vào khe |
Khi người dùng thấy các khung giờ có thể đặt và nhấp vào một khung giờ, yêu cầu BatchAvailabilityLookup sẽ được gọi cho lượt nhấp vào khung giờ. |
Phản hồi phải thể hiện tình trạng còn trống thực tế hiện tại của khung giờ. Nếu đã được đặt trước khi nhấp vào vùng, hãy trả về phản hồi cho biết vùng đó không có sẵn. | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
Khi người dùng xác nhận rằng họ muốn đặt một khung giờ đã chọn trong phương thức đặt phòng, yêu cầu CreateBooking sẽ được gửi. |
Phản hồi phải cho biết trạng thái thành công hay không thành công của yêu cầu đặt phòng. Nếu không đặt được vé, bạn cần trả về lý do cụ thể dẫn đến việc không đặt được vé. Ví dụ: khoảng thời gian đã được đặt trước khi phản hồi Nếu bạn tạo thành công một lượt đặt phòng, thì phản hồi sẽ bao gồm một |
POST /v3/CreateBooking/ |
UpdateBooking |
Sau khi đặt chỗ qua tính năng Đặt chỗ với Google, người dùng có thể chọn sửa đổi lượt đặt chỗ của mình. Khi người dùng cập nhật hoặc huỷ đặt phòng, yêu cầu UpdateBooking sẽ được gửi. |
Giống như phản hồi CreateBooking, phản hồi của bạn đối với UpdateBooking phải thể hiện trạng thái thành công của việc đặt phòng hoặc trả về lý do cụ thể cho trạng thái không thành công. |
POST /v3/UpdateBooking/ |
HealthCheck |
Trung tâm hành động thường xuyên gọi đến Máy chủ đặt phòng của bạn để xác nhận rằng cơ sở hạ tầng của bạn đang hoạt động. | Sử dụng mã trạng thái HTTP để cho biết trạng thái phân phát của máy chủ. Trả về mã trạng thái HTTP 200 nếu máy chủ đang hoạt động và chạy thành công. Để cho biết lỗi hoặc tạm thời ngừng hoạt động tích hợp, hãy trả về mã trạng thái HTTP không phải 2xx thích hợp. |
GET /v3/HealthCheck/ |
Quy trình đặt phòng trong môi trường hộp cát
Để xem quy trình đặt phòng trong Sandbox, hãy chuyển đến chế độ xem Kho hàng của Actions Center. Cột RwG – E2E trong chế độ xem Kho hàng sẽ hiển thị đường liên kết Trực tiếp (trong Hộp cát) đến quy trình đặt phòng trong Hộp cát cho những người bán trong Hộp cát được so khớp và có tình trạng còn phòng trong tương lai.
Sau đây là các thao tác trong quy trình đặt phòng:
- Khi bạn nhấp vào đường liên kết RwG – E2E, đường liên kết này sẽ kích hoạt một yêu cầu
BatchAvailabilityLookupkhi tải trang và cho biết tình trạng còn hàng đã biết của người bán. - Khi bạn nhấp vào một thời gian đặt phòng, yêu cầu nhấp vào vị trí
BatchAvailabilityLookupsẽ được kích hoạt và phương thức đặt phòng sẽ xuất hiện. - Hoàn tất việc đặt lịch hẹn bằng phương thức đặt lịch hẹn để gửi yêu cầu
CreateBooking. - Sau khi bạn hoàn tất một lượt đặt phòng trong môi trường Sandbox, tài khoản dùng để tạo lượt đặt phòng sẽ nhận được email xác nhận kèm theo thông tin chi tiết về lượt đặt phòng.
- Để kích hoạt phương thức
UpdateBooking, hãy thay đổi hoặc huỷ yêu cầu đặt phòng trong email.
HealthCheck
Đảm bảo bạn triển khai phương thức HealthCheck trong Hộp cát và Kênh phát hành công khai. Phương thức này trả về trạng thái hoạt động của Máy chủ đặt phòng. Công cụ này cho phép Google liên tục giám sát trạng thái phân phát của Máy chủ đặt phòng.
Yêu cầu: Không
Giá trị trả về: Không có
Sử dụng mã trạng thái HTTP để cho biết trạng thái phân phát của máy chủ.
Nếu máy chủ đang hoạt động và chạy thành công, hãy trả về mã trạng thái HTTP 200 hoặc để cho biết lỗi, hãy trả về một trong các mã trạng thái HTTP.