Method: inventory.partners.feeds.record.batchDelete

Xoá bản ghi của 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 việc xác thực logic nghiệp vụ trên 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 – 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 (GenericDeleteRecord)
    }
  ]
}
Trường
records[]

object (GenericDeleteRecord)

Bản ghi cần xoá. Mỗi lệnh gọi API chỉ đượ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 thì 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

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ự áp dụng lệnh xoá cho khoảng không quảng cáo.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
Trường hợp hợp nhất record_type. Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) Đối tác có thể cung cấp 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 API BatchPush. Đối tác cũng có thể chỉ cung cấp các trường thiết yếu của một bản ghi cần thiết để xác định chính xác bản ghi đó. 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.

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