Method: spreadsheets.values.clear

Xoá các giá trị khỏi bảng tính. Phương thức gọi phải chỉ định mã nhận dạng và dải ô của bảng tính. Chỉ xoá giá trị – 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.) sẽ được giữ lại.

Yêu cầu HTTP

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

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.
range

string

Chú thích A1 hoặc chú thích R1C1 của các giá trị cần xoá.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi khi xoá một dải ô 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,
  "clearedRange": string
}
Trường
spreadsheetId

string

Bảng tính mà bạn đã áp dụng nội dung cập nhật.
clearedRange

string

Dải ô (theo ký hiệu A1) đã bị xoá. (Nếu yêu cầu là 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 sẽ là dải ô thực tế đã bị xoá, được giới hạn theo giới hạn 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.