Phần này cung cấp thêm thông tin chi tiết về 3 phần chính của quá trình tích hợp với Trung tâm hành động. Bạn sẽ sử dụng từng bước trong số này theo các bước được nêu trong Hướng dẫn toàn diện.
Nguồn cấp dữ liệu
Nguồn cấp dữ liệu là các tệp ở định dạng JSON hoặc pb3 dùng để truyền dữ liệu kho hàng của bạn đến Trung tâm hành động. Điều này cho phép bạn gửi tất cả dữ liệu cùng một lúc để cập nhật người bán, dịch vụ và khung giờ trống bằng cách tải lên qua SFTP.
API Đặt chỗ trên Maps
Maps Booking API cho phép bạn cập nhật các đối tượng trong hệ thống Trung tâm hành động giữa các lần gửi nguồn cấp dữ liệu để luôn cập nhật thông tin. API này cũng cho phép bạn huỷ các lượt đặt trước được thực hiện thông qua tính năng tích hợp toàn diện của tính năng Đặt chỗ với Google.
Tính năng Cập nhật theo thời gian thực được triển khai bằng cách sử dụng lệnh gọi REST.
Máy chủ đặt phòng
Để Trung tâm hành động tích hợp toàn diện thay mặt bạn tạo lượt đặt phòng, bạn phải thiết lập máy chủ Đặt phòng.
API REST
Phiên bản v3 là phiên bản mới nhất của API và hỗ trợ giao diện dựa trên REST. Tất cả các công cụ tích hợp mới phải sử dụng API phiên bản 3.
Phần này chỉ định các tệp nguồn cấp dữ liệu dùng để truyền dữ liệu kho hàng đến Trung tâm hành động. Nội dung của nguồn cấp dữ liệu xác định những dịch vụ mà bạn đang cung cấp, những dịch vụ có sẵn và thời điểm cung cấp các dịch vụ đó.
Hãy xem phần Tài liệu tham khảo và mẫu để tìm hiểu cách chia sẻ những nguồn cấp dữ liệu này với chúng tôi.
Cấu trúc của nguồn cấp dữ liệu kho hàng được xác định bởi API Đặt phòng trên Google Maps.
Bạn bắt buộc phải sử dụng nguồn cấp dữ liệu sau đây trong mọi hoạt động tích hợp:
- Nguồn cấp dữ liệu người bán: Chứa dữ liệu mô tả người bán.
Ngoài ra, bạn bắt buộc phải có 2 nguồn cấp dữ liệu sau để tích hợp toàn diện.
- Nguồn cấp dữ liệu dịch vụ: Mô tả các dịch vụ do người bán cung cấp.
- Nguồn cấp dữ liệu về tình trạng còn chỗ: Liệt kê các khung giờ còn chỗ của dịch vụ do người bán cung cấp.
Một số trường trong các nguồn cấp dữ liệu này là bắt buộc và một số trường là không bắt buộc. Bạn có thể bỏ qua bất kỳ trường nào được đánh dấu là không bắt buộc khi trường đó trống.
Định dạng nguồn cấp dữ liệu được mô tả bằng cú pháp vùng đệm giao thức 3. Bạn có thể tải tệp nguồn cấp dữ liệu lên dưới dạng một quá trình chuyển đổi tuần tự nhị phân của dữ liệu vùng đệm giao thức ở định dạng pb3 hoặc ở định dạng JSON phái sinh. Bạn nên tải nguồn cấp dữ liệu lên ở định dạng JSON.
Bạn nên sử dụng gzip để nén nguồn cấp dữ liệu trước khi tải lên.
Hướng dẫn này dành riêng cho vùng đệm giao thức Trung tâm hành động. Để biết thông tin chung về cách sử dụng vùng đệm giao thức để tạo tệp pb3, dưới đây là ví dụ trong Java.