Xoá các giá trị khỏi một bảng tính. Phương thức gọi phải chỉ định mã nhận dạng bảng tính và dải ô. Chỉ các 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/{range}:clear
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số | |
|---|---|
spreadsheetId |
Mã của bảng tính cần cập nhật. |
range |
Ký hiệu A1 hoặc ký hiệu 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 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, "clearedRange": string } |
| Trường | |
|---|---|
spreadsheetId |
Bảng tính áp dụng nội dung cập nhật. |
clearedRange |
Dải ô (trong ký hiệu A1) đã bị xoá. (Nếu yêu cầu dành cho một dải ô không bị 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ế đã được xoá và giới hạn trong 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/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.