將值附加至試算表。輸入範圍會搜尋現有資料,以及該範圍內的「表格」。從表格的第一欄開始,值就會附加到表格的下一列。如要進一步瞭解系統偵測資料表與附加資料的方式,請參閱指南和程式碼範例。
呼叫端必須指定試算表 ID、範圍和 valueInputOption
。valueInputOption
只能控制輸入資料新增至工作表的方式 (逐欄或逐列排列),不會影響開始寫入資料的目標儲存格。
HTTP 要求
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
spreadsheetId |
要更新的試算表 ID。 |
range |
範圍的 A1 標記法,用於搜尋邏輯資料表。值會附加在資料表的最後一列後方。 |
查詢參數
參數 | |
---|---|
valueInputOption |
如何解讀輸入資料。 |
insertDataOption |
如何插入輸入資料。 |
includeValuesInResponse |
決定更新回應是否應包含附加的儲存格的值。根據預設,回應不會包含更新的值。 |
responseValueRenderOption |
決定回應中值的呈現方式。預設的轉譯選項為 |
responseDateTimeRenderOption |
決定回應中日期、時間和持續時間的顯示方式。如果 |
要求主體
要求主體包含 ValueRange
的例項。
回應主體
更新試算表中特定範圍的值時的回應。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
欄位 | |
---|---|
spreadsheetId |
套用更新的試算表。 |
tableRange |
要附加在值的表格範圍 (採用 A1 標記法)。附加值之前。如果沒有找到資料表,則為空白。 |
updates |
已套用的更新相關資訊。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
詳情請參閱授權指南。
InsertDataOption
決定在輸入新資料時變更現有資料的方式。
列舉 | |
---|---|
OVERWRITE |
新資料會覆寫其寫入區域內的現有資料。(注意:在工作表尾端加入資料仍會插入新的列或欄,以便寫入資料)。 |
INSERT_ROWS |
系統會為新資料插入列。 |