Method: spreadsheets.values.append

將值附加至試算表。輸入範圍可用於搜尋現有資料，並在該範圍內找到「表格」。值會附加到表格的下一列，從表格的第一欄開始。如要進一步瞭解如何偵測資料表並附加資料，請參閱指南和程式碼範例。

呼叫端必須指定試算表 ID、範圍和 valueInputOption。valueInputOption 只會控制輸入資料如何新增至工作表 (以列或以列為單位)，不會影響資料開始寫入的儲存格。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
spreadsheetId

string

要更新的工作表 ID。
range

string

範圍的 A1 符號，用於搜尋邏輯資料表。值會附加到表格的最後一列之後。

查詢參數

參數
valueInputOption

enum (ValueInputOption)

系統如何解讀輸入資料。
insertDataOption

enum (InsertDataOption)

輸入資料的插入方式。
includeValuesInResponse

boolean

判斷更新回應是否應包含附加的儲存格值。根據預設，回應不會包含更新的值。
responseValueRenderOption

enum (ValueRenderOption)

決定回應中的值應如何顯示。預設轉譯選項為 FORMATTED_VALUE。
responseDateTimeRenderOption

enum (DateTimeRenderOption)

決定回應中日期、時間和時間長度的顯示方式。如果 responseValueRenderOption 為 FORMATTED_VALUE，系統會忽略這項屬性。預設的 dateTime 轉譯選項為 SERIAL_NUMBER。

要求主體

要求主體包含 ValueRange 的例項。

回應主體

更新試算表中值的範圍時的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
欄位
spreadsheetId

string

套用更新的試算表。
tableRange

string

要附加值的 (在附加值之前) 表格範圍 (以 A1 符號表示)。如果找不到資料表，則為空白。
updates

object (UpdateValuesResponse)

已套用更新的相關資訊。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

詳情請參閱授權指南。

InsertDataOption

決定在輸入新資料時，如何變更現有資料。

列舉
OVERWRITE 新資料會覆寫寫入區域中的現有資料。(注意：在試算表的結尾新增資料時，系統仍會插入新列或新欄，以便寫入資料)。
INSERT_ROWS 系統會插入新資料的資料列。