Method: spreadsheets.values.batchUpdate

Đặt giá trị trong một hoặc nhiều dải ô của một 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

Tham số
spreadsheetId

string

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 (ValueInputOption),
  "data": [
    {
      object (ValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Trường
valueInputOption

enum (ValueInputOption)

Cách diễn giải dữ liệu đầu vào.

data[]

object (ValueRange)

Các giá trị mới để áp dụng cho bảng tính.

includeValuesInResponse

boolean

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 updatedData trong mỗi BatchUpdateValuesResponse.responses chứa giá trị đã cập nhật. Nếu dải ô cần ghi lớn hơn dải ô thực tế đã viết, thì phản hồi sẽ bao gồm tất cả giá trị trong dải ô được yêu cầu (ngoại trừ các hàng và cột trống ở cuối).

responseValueRenderOption

enum (ValueRenderOption)

Xác định cách hiển thị các giá trị trong phản hồi. Tuỳ chọn kết xuất mặc định là FORMATTED_VALUE.

responseDateTimeRenderOption

enum (DateTimeRenderOption)

Xác định cách hiển thị ngày, giờ và thời lượng trong phản hồi. Tham số này sẽ bị bỏ qua nếu responseValueRenderOptionFORMATTED_VALUE. Tuỳ chọn hiển thị dateTime mặc định là SERIAL_NUMBER.

Nội dung phản hồi

Phản hồi khi cập nhật 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,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesResponse)
    }
  ]
}
Trường
spreadsheetId

string

Bảng tính áp dụng nội dung cập nhật.

totalUpdatedRows

integer

Tổng số hàng trong đó có ít nhất một ô trong hàng được cập nhật.

totalUpdatedColumns

integer

Tổng số cột mà có ít nhất một ô trong cột được cập nhật.

totalUpdatedCells

integer

Tổng số ô được cập nhật.

totalUpdatedSheets

integer

Tổng số trang tính mà trong đó có ít nhất một ô trong trang tính được cập nhật.

responses[]

object (UpdateValuesResponse)

Một UpdateValuesResponse cho mỗi dải ô được yêu cầu, theo cùng thứ tự như khi các yêu cầu xuất hiện.

Phạm vi uỷ 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 uỷ quyền.