REST Resource: spreadsheets.values

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

string

值涵蓋的範圍，以 A1 標示法表示。對於輸出內容，這個範圍會指出整個要求範圍，即使值會排除尾隨的資料列和資料欄也是如此。附加值時，這個欄位代表搜尋表格的範圍，之後會附加值。

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。

array (ListValue format)

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

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

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