Method: spreadsheets.values.update

Đặt giá trị trong một dải ô của bảng tính. Phương thức gọi phải chỉ định mã nhận dạng, dải ô và valueInputOption của bảng tính.

Yêu cầu HTTP

PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
spreadsheetId

string

Mã của bảng tính cần cập nhật.

range

string

Ký hiệu A1 của các giá trị cần cập nhật.

Tham số truy vấn

Thông số
valueInputOption

enum (ValueInputOption)

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

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. Nếu dải ô cần ghi lớn hơn dải ô thực tế được ghi thì phản hồi sẽ bao gồm tất cả giá trị trong dải ô được yêu cầu (không bao gồm 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 hiển thị 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. Trạng thái 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 yêu cầu

Nội dung yêu cầu chứa một bản sao của ValueRange.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của UpdateValuesResponse.

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.