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