Kho hàng trong hệ thống của bạn thay đổi do các lượt đặt phòng mới, lượt huỷ và thay đổi về lịch biểu của người bán. Real-Time Update (RTU) API là một cơ chế để thông báo cho Google về những thay đổi này và những thay đổi đối với các lượt đặt phòng hiện có.
Bạn bắt buộc phải có RTU trong các trường hợp sau:
- Khi người dùng huỷ một lượt đặt chỗ trên hệ thống của bạn và khung giờ đó trở thành khung giờ trống.
- Khi người dùng đặt chỗ thông qua Actions Center và khung giờ đó không còn nữa.
- Khi một lượt đặt chỗ được thực hiện thông qua Actions Center bị huỷ ở phía bạn. Ví dụ về trường hợp người bán huỷ trực tiếp. Bạn cần cập nhật thông tin đặt phòng và tình trạng còn phòng vì giờ hẹn ban đầu hiện đã có thể đặt.
Hoàn tất nhiệm vụ quan trọng sau đây trong RTU trước khi chuyển sang quy trình xem xét trong Hộp cát:
Mỗi tác vụ được đánh dấu là đã hoàn tất và chuyển sang màu xanh lục khi 20 yêu cầu gần đây nhất không có lỗi trong khoảng thời gian 14 ngày. Tiếp tục gửi các yêu cầu thành công để đảm bảo rằng cột mốc vẫn có màu xanh lục.
API RTU và nguồn cấp dữ liệu
RTU API thông báo cho Google về những thay đổi gia tăng đối với tình trạng còn phòng và lượt đặt phòng theo thời gian thực. Ngoài RTU, hãy gửi Nguồn cấp dữ liệu về tình trạng còn phòng đầy đủ hằng ngày. Điều này giúp đảm bảo rằng Google có thông tin chính xác và mới nhất về tình trạng còn hàng như trong hệ thống của bạn. Nguồn cấp dữ liệu đầy đủ đóng vai trò là thông tin tổng quan nhanh về trạng thái mới nhất của tình trạng còn hàng trong hệ thống của bạn.
Để biết thêm thông tin, hãy xem các tài nguyên sau:
Truy cập vào API
Dự án Google Cloud là cách bạn truy cập vào Maps Booking API của Trung tâm hành động, đây là cách bạn gửi RTU. Bạn phải sử dụng Tài khoản Google trong Google Developers Console và cung cấp Số dự án trên đám mây trong cột mốc Thiết lập của kế hoạch tham gia. Để biết thêm thông tin về cách bật Cloud API, hãy xem phần Bật Cloud API.
Sử dụng các lệnh gọi RESTful hoặc tải thư viện ứng dụng xuống
Bạn nên thực hiện các lệnh gọi RESTful trực tiếp đến Maps Booking API bằng tải trọng JSON. Để biết thêm thông tin, hãy xem tài liệu về API REST.
Bạn cũng có thể dùng thư viện ứng dụng để kết nối với API.
.| Ngôn ngữ | Đường liên kết để tải xuống |
|---|---|
| Java | Thư viện ứng dụng Java. Để biết thêm thông tin, hãy xem Hướng dẫn về ứng dụng Java |
Bạn có thể tải thêm các thư viện hỗ trợ xử lý việc uỷ quyền và các khía cạnh khác của lệnh gọi đến API của Google. Để biết thêm thông tin, hãy xem Mã mẫu.
Tìm nạp tài liệu Khám phá
Đối với một số thư viện ứng dụng (chẳng hạn như Ruby), bạn cần tìm nạp tài liệu Discovery cho API mô tả các phương thức và tham số của API đó.
Để tìm nạp tài liệu Khám phá, hãy dùng lệnh sau:
curl -s -o mapsbooking_rest
https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha
Để biết thêm thông tin về cách truy cập vào API từ Ruby, hãy xem Ứng dụng API Ruby và Thư viện uỷ quyền Ruby.
Thực hiện các lệnh gọi được uỷ quyền đến API
Khi bạn thực hiện lệnh gọi đến API, hãy tham khảo bài viết Chuẩn bị thực hiện lệnh gọi API được uỷ quyền để uỷ quyền cho tài khoản dịch vụ bằng khoá riêng tư và phạm vi OAuth sau đây:
https://www.googleapis.com/auth/mapsbooking
Điểm cuối Hộp cát và Sản xuất
Bạn có thể gọi đến cả môi trường Hộp cát và môi trường Phát hành công khai thông qua API. Đảm bảo rằng bạn bật cả hai API trong dự án Google Cloud của mình. Cả hai API đều sử dụng cùng một phạm vi, nhưng chúng có các điểm cuối khác nhau.
Điểm cuối sản xuất: https://mapsbooking.googleapis.com/
Điểm cuối hộp cát: https://partnerdev-mapsbooking.googleapis.com/
Sau đây là ví dụ về cách chuyển đổi điểm cuối trong Java:
// This block of code is for OAuth and is the same for prod and sandbox.
GoogleCredential
.fromStream(new FileInputStream(...))
.createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))
// This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
new GoogleMapsBookingAPI.Builder(...)
.setApplicationName(...)
.setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
.build()