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

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

array (ListValue format)

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

如果是輸出，則不包括空白的結尾資料列和資料欄。

輸入值支援的值類型為：bool、string 和 Double。空值會略過。如要將儲存格設為空白值，請將字串值設為空白字串。