Method: spreadsheets.values.append

Thêm giá trị vào bảng tính. Dải ô đầu vào được sử dụng để tìm kiếm dữ liệu hiện tại 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 bằng cột đầu tiên của bảng. Xem hướng dẫn và mã mẫu để biết chi tiết cụ thể về cách phát hiện bảng và dữ liệu được thêm vào.

Phương thức gọi phải chỉ định mã nhận dạng bảng tính, dải ô và một valueInputOption. 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 ô mà dữ liệu bắt đầu được ghi.

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

Các tham số
spreadsheetId

string

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

string

Ký hiệu A1 của dải ô để tìm kiếm bảng dữ liệu logic. Giá trị được nối sau hàng cuối cùng của bảng.

Tham số truy vấn

Các tham 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 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.
responseValueRenderOption

enum (ValueRenderOption)

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à 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 kết xuất 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)
  }
}
Các trường
spreadsheetId

string

Bảng tính đã áp dụng bản cập nhật.
tableRange

string

Dải ô (bằng ký hiệu A1) của bảng có nối thêm các giá trị (trước khi các giá trị đó được nối 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 ủ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.

Chèn dữ liệu

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

Enum
OVERWRITE Dữ liệu mới sẽ ghi đè dữ liệu hiện có trong khu vực mà dữ liệu được viết. (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 được chèn cho dữ liệu mới.