Method: spreadsheets.values.batchClear

Xoá một hoặc nhiều dải ô giá trị khỏi bảng tính. Người gọi phải chỉ định mã nhận dạng bảng tính và một hoặc nhiều dải ô. Chỉ có các giá trị được xoá, còn tất cả các thuộc tính khác của ô (chẳng hạn như định dạng và xác thực dữ liệu) vẫn được giữ nguyên.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông 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 sau:

Biểu diễn dưới dạng JSON 
{
  "ranges": [
    string
  ]
}
Trường
ranges[]

string

Các dải ô cần xoá, theo ký hiệu A1 hoặc ký hiệu R1C1.

Nội dung phản hồi

Phản hồi khi xoá một dải giá trị trong 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
  ]
}
Trường
spreadsheetId

string

Bảng tính mà nội dung cập nhật được áp dụng.
clearedRanges[]

string

Các dải ô đã bị xoá, theo ký hiệu A1. Nếu các yêu cầu là cho một dải ô không 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ế đã được xoá, bị giới hạn trong phạm vi của trang tính.

Phạm vi uỷ 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 uỷ quyền.