Chèn và/hoặc cập nhật các bản ghi thuộc loại nguồn cấp dữ liệu đã chỉ định. Chỉ thực hiện quy trình xác thực cơ bản (như yêu cầu không đúng định dạng), sau đó hệ thống sẽ trả về phản hồi thích hợp cho đối tác ngay lập tức. Google thực hiện xác thực logic nghiệp vụ cho yêu cầu một cách không đồng bộ. Lệnh gọi hàng loạt này không đảm bảo tính nguyên tử.
Yêu cầu HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Tên tài nguyên, có định dạng là – |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"records": [
{
object ( |
Trường | |
---|---|
records[] |
Các bản ghi cần chèn và/hoặc cập nhật. Mỗi lệnh gọi API được phép có tối đa 1.000 bản ghi. |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ trống.
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/mapsbooking
GenericRecord
Bản ghi của loại nguồn cấp dữ liệu được đề cập trong yêu cầu URL.
Biểu diễn dưới dạng JSON |
---|
{ "generationTimestamp": string, // Union field |
Trường | |
---|---|
generationTimestamp |
Bắt buộc. Dấu thời gian này được dùng để đảm bảo thứ tự chính xác của các thông tin cập nhật kho hàng. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
Trường kết hợp record_type . Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) record_type chỉ có thể là một trong những trạng thái sau đây: |
|
dataRecord |
Đối với nguồn cấp dữ liệu không dựa trên proto. Chuỗi được mã hoá base64. |
protoRecord |
Đối với nguồn cấp dữ liệu dựa trên proto. Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung |