Đặ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 ValueRanges
.
Yêu cầu HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
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. |
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[] |
Một UpdateValuesResponse cho mỗi phạm vi được yêu cầu, theo cùng thứ tự như yêu cầu đã xuất hiện. |
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.