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 系統會為新資料插入列。