REST Resource: spreadsheets.values

資源：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 會設定 A1=1,B1=3,A2=2,B2=4。[[1,2],[3,4]]

寫入時，如果未設定這個欄位，則預設為 ROWS。
values[]

array (ListValue format)

已讀取或要寫入的資料。這是陣列的陣列，外部陣列代表所有資料，而每個內部陣列則代表主要維度。內部陣列中的每個項目都對應一個儲存格。

輸出內容不會包含空白的尾隨資料列和資料欄。

輸入內容支援的值類型為：布林值、字串和雙精度浮點值。系統會略過空值。如要將儲存格設為空白值，請將字串值設為空白字串。

方法

append

 將值附加至試算表。

batchClear

 清除試算表中一或多個值範圍。

batchClearByDataFilter

 清除試算表中一或多個值範圍。

batchGet

 傳回試算表中一或多個值的範圍。

batchGetByDataFilter

 傳回符合指定資料篩選條件的一或多個值範圍。

batchUpdate

 設定試算表中一或多個範圍的值。

batchUpdateByDataFilter

 設定試算表中一或多個範圍的值。

clear

 清除試算表中的值。

get

 傳回試算表中的值範圍。

update

 設定試算表範圍內的值。