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

詳情請參閱授權指南。

插入選項

決定輸入新資料時，現有資料的變化方式。

列舉
OVERWRITE 新資料會覆寫其寫入區域內的現有資料。(注意：在工作表結尾加入資料後，系統仍可能插入新的列或欄，以便寫入資料)。
INSERT_ROWS 系統會為新資料插入資料列。