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 phương pháp này trong các bướ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 được dùng để truyền dữ liệu kho hàng đến Trung tâm hành động. Nhờ đó, bạn có thể
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à
vị trí còn hàng bằng cách tải lên qua SFTP.
API Đặt phòng trên Maps
API đặt chỗ của Maps 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ỷ những lượt đặt trước được thực hiện thông qua tính năng Đặt chỗ bằng Google tích hợp hai đầu.
Cập nhật theo thời gian thực được triển khai bằng lệnh gọi REST.
Máy chủ đặt phòng
Để tích hợp toàn diện với Trung tâm hành động, bạn phải thiết lập một máy chủ đặt trước thay mặt bạn.
API REST
Phiên bản 3 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ả chế độ tích hợp mới đều phải sử dụng API v3.
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 của bạn đế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 danh sách xếp Trang tham khảo và mẫu để tìm hiểu cách chia sẻ các 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 do API đặt phòng của Google Maps xác định.
Bạn phải cung cấp 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 của bạn.
Ngoài ra, bạn phải có 2 nguồn cấp dữ liệu sau để tích hợp từ đầu đến cuối.
- Nguồn cấp dữ liệu dịch vụ: Mô tả các dịch vụ mà người bán của bạn cung cấp.
- Nguồn cấp dữ liệu tình trạng còn hàng: Liệt kê các vị trí còn hàng của dịch vụ mà người bán của bạn cung cấp.
Một số trường trong những nguồn cấp dữ liệu này là bắt buộc, còn một số khác là không bắt buộc. Bạn có thể bỏ bất kỳ trường nào được đánh dấu là không bắt buộc khỏi nguồn cấp dữ liệu khi 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ể chọn tải tệp nguồn cấp dữ liệu lên dưới dạng chuỗ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át 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 của Actions Center. Để biết thông tin chung về cách sử dụng vùng đệm giao thức để tạo tệp pb3, đây là một ví dụ trong Java.