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

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