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)

読み取られたデータまたは書き込まれるデータ。これは配列の配列です。外側の配列はすべてのデータを表し、内部配列は主要なディメンションを表します。内部配列の各アイテムは 1 つのセルに対応しています。

出力では、以降の空の行と列は含まれません。

入力では、bool、string、double の値の型がサポートされています。Null 値はスキップされます。セルを空の値に設定するには、文字列値を空の文字列に設定します。