- 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 uỷ 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
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 |
---|
{ "valueInputOption": enum ( |
Trường | |
---|---|
valueInputOption |
Cách diễn giải dữ liệu đầu vào. |
data[] |
Các giá trị mới để áp dụng cho bảng tính. Nếu 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, câu trả lời không bao gồm các giá trị đã cập nhật. Trường |
responseValueRenderOption |
Xác định cách hiển thị các giá trị trong phản hồi. Tuỳ 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. Trạng thái 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 ( |
Trường | |
---|---|
spreadsheetId |
Bảng tính áp dụng nội dung cập nhật. |
totalUpdatedRows |
Tổng số hàng mà ít nhất một ô trong hàng đã được cập nhật. |
totalUpdatedColumns |
Tổng số cột mà ít nhất một ô trong cột đã được cập nhật. |
totalUpdatedCells |
Tổng số ô đã được cập nhật. |
totalUpdatedSheets |
Tổng số trang tính mà trong đó có ít nhất một ô trong trang tính được cập nhật. |
responses[] |
Đã cập nhật câu trả lời cho mỗi phạm vi. |
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.
DataFilterValueRange
Một dải ô của các giá trị có vị trí được chỉ định bằng DataFilter
.
Biểu diễn dưới dạng JSON |
---|
{ "dataFilter": { object ( |
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 |
Phương diệ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á phạm vi bất kỳ mà bộ lọc dữ liệu khớp, thì yêu cầu sẽ không thành công. Nếu giá trị đã cung cấp nhỏ hơn dải ô trùng khớp, thì chỉ những giá trị được chỉ định mới được ghi, thì các giá trị hiện có trong dải ô trùng khớ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 một 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 ( |
Trường | |
---|---|
updatedRange |
Dải ô (trong ký hiệu A1) áp dụng nội dung cập nhật. |
updatedRows |
Số hàng mà bạn đã cập nhật ít nhất một ô trong hàng. |
updatedColumns |
Số cột mà ít nhất một ô trong cột đã được cập nhật. |
updatedCells |
Số lượng ô đã được 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 khớp bởi dataFilter sau khi áp dụng tất cả các nội dung cập nhật. Giá trị này chỉ được đưa vào nếu trường |