- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi ủy quyền
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Hãy làm thử!
Đặt giá trị trong một hoặc nhiều dải ô của bảng tính. Phương thức gọi phải chỉ định mã nhận dạng bảng tính, valueInputOption
và một hoặc nhiều DataFilterValueRanges
.
Yêu cầu HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham 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 với cấu trúc như sau:
Biểu diễn dưới dạng JSON |
---|
{ "valueInputOption": enum ( |
Các trường | |
---|---|
valueInputOption |
Cách diễn giải dữ liệu đầu vào. |
data[] |
Các giá trị mới sẽ áp dụng cho bảng tính. Nếu có nhiều dải ô khớp với |
includeValuesInResponse |
Xác định xem phản hồi cập nhật có bao gồm giá trị của các ô đã được cập nhật hay không. Theo mặc định, phản hồi không bao gồm các giá trị được cập nhật. Trường |
responseValueRenderOption |
Xác định cách hiển thị các giá trị trong phản hồi. Tùy chọn hiển thị mặc định là |
responseDateTimeRenderOption |
Xác định cách hiển thị ngày, giờ và thời lượng trong phản hồi. Giá trị này sẽ bị bỏ qua nếu |
Nội dung phản hồi
Phản hồi khi cập nhật một dải ô giá trị trong một 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,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Các trường | |
---|---|
spreadsheetId |
Bảng tính đã áp dụng bản cập nhật. |
totalUpdatedRows |
Tổng số hàng đã cập nhật ít nhất một ô trong hàng. |
totalUpdatedColumns |
Tổng số cột đã cập nhật ít nhất một ô trong cột. |
totalUpdatedCells |
Tổng số ô được cập nhật. |
totalUpdatedSheets |
Tổng số trang tính có ít nhất một ô trong trang tính đã được cập nhật. |
responses[] |
Đã cập nhật phản hồi cho mỗi dải ô. |
Phạm vi ủy 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 ủy quyền.
Giá trị bộ lọc dữ liệu
Dải ô giá trị có vị trí được DataFilter
chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ "dataFilter": { object ( |
Các trường | |
---|---|
dataFilter |
Bộ lọc dữ liệu mô tả vị trí của các giá trị trong bảng tính. |
majorDimension |
Thứ nguyên chính của các giá trị. |
values[] |
Dữ liệu cần ghi. Nếu các giá trị đã cung cấp vượt quá bất kỳ phạm vi nào khớp với bộ lọc dữ liệu thì yêu cầu không thành công. Nếu giá trị đã cho nhỏ hơn phạm vi phù hợp, chỉ giá trị được chỉ định được ghi, giá trị hiện tại trong phạm vi phù hợp sẽ không bị ảnh hưởng. |
UpdateValuesByDataFilterResponse
Phản hồi khi cập nhật một dải giá trị bằng bộ lọc dữ liệu trong bảng tính.
Biểu diễn dưới dạng JSON |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Các trường | |
---|---|
updatedRange |
Dải ô (trong ký hiệu A1) đã áp dụng bản cập nhật. |
updatedRows |
Số lượng hàng mà ít nhất một ô trong hàng đã được cập nhật. |
updatedColumns |
Số cột mà ít nhất một ô trong cột đã được cập nhật. |
updatedCells |
Số ô đã cập nhật. |
dataFilter |
Bộ lọc dữ liệu đã chọn dải ô được cập nhật. |
updatedData |
Giá trị của các ô trong dải ô được phù hợp bởi dataFilter sau khi tất cả các cập nhật được áp dụng. Điều này chỉ được bao gồm nếu trường |