Method: inventory.partners.feeds.record.batchDelete

Xoá các bản ghi thuộc loại nguồn cấp dữ liệu đã chỉ định. Chỉ thực hiện xác thực cơ bản (chẳng hạn như yêu cầu không đúng định dạng), sau đó trả về ngay phản hồi thích hợp cho đối tác. Google thực hiện quy trình xác thực logic nghiệp vụ đối với 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:batchDelete

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Tên tài nguyên có định dạng là 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 với cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "records": [
    {
      object (GenericDeleteRecord)
    }
  ]
}
Trường
records[]

object (GenericDeleteRecord)

Bản ghi cần xoá. Bạn có thể có tối đa 1.000 bản ghi trong một lệnh gọi API.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ là một đối tượng JSON trống.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking

GenericDeleteRecord

Bản ghi cần xoá 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
{
  "deleteTime": 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.
}
Trường
deleteTime

string (Timestamp format)

Bắt buộc. Dấu thời gian này được dùng để xác định thứ tự xoá sẽ được áp dụng cho khoảng không quảng cáo.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

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 giao thức, v.v.) Đối tác có thể cung cấp một bản ghi đầy đủ tương tự như cách cung cấp bản ghi trong nguồn cấp dữ liệu hoặc BatchPush API. Các đối tác cũng có thể chỉ thêm những trường cần thiết của một bản ghi để xác định duy nhất bản ghi đó. record_type chỉ có thể là một trong những trạng thái sau:
dataRecord

string (bytes format)

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

Một chuỗi được mã hoá base64.

protoRecord

object

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

Một đối tượng chứa các trường thuộc một loại tuỳ ý. Một trường bổ sung "@type" chứa một URI xác định loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.