Xoá giá trị khỏi một bảng tính. Phương thức gọi phải chỉ định dải ô và mã nhận dạng bảng tính. Chỉ giá trị mới bị xoá -- 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.) vẫn đượ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 |
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 ô (theo ký hiệu A1) đã bị xoá. (Nếu yêu cầu là dành cho một dải ô không giới hạn hoặc một phạm vi kiểm lâm lớn hơn giới hạn của trang tính, thì đây sẽ là dải ô thực tế đã bị xoá, bị 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 đây:
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 bài viết Hướng dẫn uỷ quyền.