Method: inventory.partners.feeds.record.batchPush

Chèn và/hoặc cập nhật bản ghi của loại nguồn cấp dữ liệu được chỉ định. Chỉ thực hiện xác thực cơ bản (như yêu cầu có định dạng không đúng), sau đó phản hồi phù hợp sẽ được trả về đối tác ngay lập tức. Google thực hiện xác thực logic kinh doanh theo yêu cầu một cách không đồng bộ. Lệnh gọi lô này không đảm bảo tính nguyên thức.

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

Các tham số
parent

string

Tên tài nguyên có định dạng – partners/{partner_id}/feeds/{feed_name}.

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 (GenericRecord)
    }
  ]
}
Các trường
records[]

object (GenericRecord)

Bản ghi sẽ được 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 uỷ quyền

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 record_type can be only one of the following:
  "dataRecord": string,
  "protoRecord": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field record_type.
}
Các trường
generationTimestamp

string (Timestamp format)

Bắt buộc. Dấu thời gian này dùng để đảm bảo thứ tự cập nhật kho hàng chính xác.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
Trường nhóm 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

string (bytes format)

Đối với nguồn cấp dữ liệu không dựa trên proto.

Chuỗi được mã hoá base64.
protoRecord

object

Đối với nguồn cấp dữ liệu dựa trên proto.

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.