Method: spreadsheets.values.append

Thêm các giá trị vào bảng tính. Phạm vi đầu vào được dùng để tìm kiếm dữ liệu hiện có và tìm "bảng" trong phạm vi đó. Các giá trị sẽ được 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. Hãy 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 bảng tính, dải ô và valueInputOption. valueInputOption chỉ kiểm soát cách dữ liệu đầu vào được thêm vào trang tính (theo cột hoặc theo hàng), không ảnh hưởng đến ô mà dữ liệu bắt đầu được ghi và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 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 các giá trị của các ô đã được thêm vào hay không. Theo mặc định, các phản hồ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 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. Giá trị 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 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 mà bạn đã áp dụng nội dung cập nhật.
tableRange

string

Dải ô (theo 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ề các bản 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:

  • 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.

InsertDataOption

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

Enum
OVERWRITE Dữ liệu mới sẽ ghi đè dữ liệu hiện có trong các khu vực mà dữ liệu mới được ghi. (Lưu ý: việc thêm dữ liệu vào cuối trang tính vẫn sẽ 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 cho dữ liệu mới.