Method: spreadsheets.values.append

Thêm các giá trị vào một bảng tính. Dải ô nhập dữ liệu được dùng để tìm dữ liệu hiện có và tìm một "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 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ã bảng tính, dải ô và 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 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

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

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 thêm vào 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 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 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 á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.
updates

object (UpdateValuesResponse)

Thông tin về các 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:

  • 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 vào.

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