Xoá 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 dải ô. 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 và xác thực dữ liệu) vẫn được giữ lại.
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 |
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 có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "ranges": [ string ] } |
Trường | |
---|---|
ranges[] |
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 |
Bảng tính áp dụng nội dung cập nhật. |
clearedRanges[] |
Các dải ô đã bị xoá, theo ký hiệu A1. Nếu yêu cầu là dành 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à những dải ô thực tế đã bị xoá và 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.