Method: spreadsheets.values.append

Thêm các giá trị vào một bảng tính. Dải ô đầu vào được dùng để tìm kiếm dữ liệu hiện có và tìm "bảng" trong dải ô đó. Các giá trị sẽ được nối thêm vào hàng tiếp theo của bảng, bắt đầu từ cột đầu tiên của bảng. Xem hướng dẫn và mã mẫu để biết thông tin chi tiết cụ thể về cách phát hiện bảng và thêm dữ liệu.

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. valueInputOption chỉ kiểm soát cách thêm dữ liệu đầu vào vào trang tính (theo cột hoặc theo hàng), không ảnh hưởng đến việc dữ liệu bắt đầu được ghi vào ô nào.

Yêu cầu HTTP

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

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 một dải ô để tìm kiếm bảng dữ liệu logic. Các giá trị được thêm vào sau hàng cuối cùng của bảng.

Tham số truy vấn

Thông số
valueInputOption

enum (ValueInputOption)

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

enum (InsertDataOption)

Cách chèn 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 nối thêm 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.
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 responseValueRenderOption là FORMATTED_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

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,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
Trường
spreadsheetId

string

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

string

Dải ô (trong ký hiệu A1) của bảng mà các giá trị đang được thêm vào (trước khi các giá trị được thêm vào). Để trống nếu không tìm thấy bảng nào.
updates

object (UpdateValuesResponse)

Thông tin về những nội dung cập nhật đã được áp dụng.

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.

InsertDataOption

Xác định cách dữ liệu hiện có thay đổi khi nhập dữ liệu mới.

Enum
OVERWRITE Dữ liệu mới sẽ ghi đè dữ liệu hiện có trong các khu vực được ghi. (Lưu ý: việc thêm dữ liệu vào cuối trang tính sẽ vẫn chèn các hàng hoặc cột mới để có thể ghi dữ liệu.)
INSERT_ROWS Các hàng sẽ được chèn vào dữ liệu mới.