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 の場合、[[1,2],[3,4]] は A1=1,B1=3,A2=2,B2=4 を設定します。

書き込み時にこのフィールドが設定されていない場合、デフォルトは ROWS になります。
values[]

array (ListValue format)

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

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

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

メソッド

append

 スプレッドシートに値を追加します。

batchClear

 スプレッドシートから 1 つ以上の値の範囲を消去します。

batchClearByDataFilter

 スプレッドシートから 1 つ以上の値の範囲を消去します。

batchGet

 スプレッドシートの 1 つ以上の値の範囲を返します。

batchGetByDataFilter

 指定されたデータフィルタに一致する値の範囲を 1 つ以上返します。

batchUpdate

 スプレッドシートの 1 つ以上の範囲に値を設定します。

batchUpdateByDataFilter

 スプレッドシートの 1 つ以上の範囲に値を設定します。

clear

 スプレッドシートの値を消去します。

get

 スプレッドシートの値の範囲を返します。

update

 スプレッドシートの範囲に値を設定します。