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 値はスキップされます。セルを空の値に設定するには、文字列値を空の文字列に設定します。

Methods

append

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

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

 スプレッドシートから値をクリアします。

get

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

update

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