REST Resource: spreadsheets.values

• 資源：ValueRange
  • JSON 表示法
• 方法

資源：ValueRange

試算表範圍內的資料。

JSON 表示法
{ "range": string, "majorDimension": enum (Dimension), "values": [ array ] }

欄位
range	string 值的範圍，以 A1 標記法表示。以輸出來說，此範圍表示整個要求的範圍，即使值會排除結尾的列和欄。附加值時，這個欄位代表用來搜尋資料表的範圍，其後將附加值。
majorDimension	enum (Dimension) 值的主要維度。 對於輸出，如果試算表資料為 A1=1,B1=2,A2=3,B2=4，則要求 range=A1:B2,majorDimension=ROWS 會傳回 [[1,2],[3,4]]，而要求 range=A1:B2,majorDimension=COLUMNS 會傳回 [[1,3],[2,4]]。 若為輸入項目，使用 range=A1:B2,majorDimension=ROWS 時，[[1,2],[3,4]] 會設定 A1=1,B1=2,A2=3,B2=4。使用 range=A1:B2,majorDimension=COLUMNS 時，[[1,2],[3,4]] 會設定 A1=1,B1=3,A2=2,B2=4。 寫入時，如果這個欄位未設定，則預設為 ROWS。
values[]	array (ListValue format) 讀取或寫入的資料。這是陣列陣列，外部資料陣列代表所有資料，每個內部陣列則代表主要維度。內部陣列中的每個項目都對應一個儲存格。 輸出內容不會包含空白的結尾列和欄。 對輸入而言，支援的值類型包括：bool、string 和 Double。系統會略過空值。如要將儲存格設為空白值，請將字串值設為空字串。

方法
append	將值附加至試算表。
batchClear	清除試算表中一或多個範圍的值。
batchClearByDataFilter	清除試算表中一或多個範圍的值。
batchGet	傳回試算表中一或多個值範圍。
batchGetByDataFilter	傳回一或多個符合指定資料篩選器的值範圍。
batchUpdate	設定試算表一或多個範圍的值。
batchUpdateByDataFilter	設定試算表一或多個範圍的值。
clear	清除試算表中的值。
get	傳回試算表中的值範圍。
update	設定試算表中特定範圍的值。