Method: spreadsheets.values.batchClearByDataFilter

Xóa một hoặc nhiều dải giá trị khỏi bảng tính. Phương thức gọi phải chỉ định mã nhận dạng bảng tính và một hoặc nhiều DataFilters. Dải ô khớp với bất kỳ bộ lọc dữ liệu được chỉ định nào sẽ bị xóa. Chỉ giá trị bị xóa -- tất cả các thuộc tính khác của ô (chẳng hạn như định dạng, xác thực dữ liệu, v.v.) đều được giữ lại.

Yêu cầu HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter

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

Tham số đường dẫn

Các tham số
spreadsheetId

string

Mã của bảng tính cần cập nhật.

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 như sau:

Biểu diễn dưới dạng JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Các trường
dataFilters[]

object (DataFilter)

DataFilters dùng để xác định dải ô cần xoá.

Nội dung phản hồi

Phản hồi khi xoá một dải giá trị đã chọn bằng DataFilters trong một bảng tính.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Các trường
spreadsheetId

string

Bảng tính đã áp dụng bản cập nhật.
clearedRanges[]

string

Dải ô đã bị xóa, trong Ký hiệu A1. Nếu các yêu cầu dành cho một dải ô không có giới hạn hoặc một dải ô lớn hơn giới hạn của trang tính, thì đây là các dải ô thực tế đã bị xoá, bị giới hạn đến giới hạn của trang tính.

Phạm vi ủy quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Để biết thêm thông tin, hãy xem Hướng dẫn ủy quyền.