Google Spreadsheet
Google Spreadsheetを操作するアクション一覧です。
CreateSpreadsheetは、スプレッドシートを新たに作成するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
title* | 文字列 | スプレッドシートのタイトル | test |
provider* | 文字列 | 利用するコネクション(GoogleSpreadsheet)のプロバイダーID | gsheet_1234abcd |
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Spreadsheet | スプレッドシート | 作成したスプレッドシートオブジェクト | ※使用例のアウトプット参照 |
+create_spreadsheet_1:
action>: CreateSpreadsheet
title: test
provider: gsheet_********************
# => {
# "spreadsheetId": "1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro",
# "properties": {
# "title": "test",
# "locale": "ja_JP",
# "autoRecalc": "ON_CHANGE",
# "timeZone": "Etc/GMT",
# "defaultFormat": {
# "backgroundColor": {
# "red": 1,
# "green": 1,
# "blue": 1
# },
# "padding": {
# "top": 2,
# "right": 3,
# "bottom": 2,
# "left": 3
# },
# "verticalAlignment": "BOTTOM",
# "wrapStrategy": "OVERFLOW_CELL",
# "textFormat": {
# "foregroundColor": {},
# "fontFamily": "arial,sans,sans-serif",
# "fontSize": 10,
# "bold": false,
# "italic": false,
# "strikethrough": false,
# "underline": false
# }
# }
# },
# "sheets": [
# {
# "properties": {
# "sheetId": 0,
# "title": "シート1",
# "index": 0,
# "sheetType": "GRID",
# "gridProperties": {
# "rowCount": 1000,
# "columnCount": 26
# }
# }
# }
# ],
# "spreadsheetUrl": "https://docs.google.com/a/autoro.io/spreadsheets/d/1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro/edit",
# "provider": "gsheet_********************"
# }
GetSpreadsheetは、GoogleSpreadsheetオブジェクトを取得するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
provider* | 文字列 | 利用するコネクション(GoogleSpreadsheet)のプロバイダーID | gsheet_1234abcd |
spreadsheet_id* | 文字列 | 使用するスプレッドシートIDまたはURL | 1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33roまたはhttps://docs.google.com/a/autoro.io/spreadsheets/d/example/edit |
ranges | 配列 | 取得したいシート名の配列。特定のシートから、さらに特定のセルのみ取得したい場合、A1記法で指定可能。 | ["シート1", "シート2!A1:B3"] |
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Spreadsheet | スプレッドシート | 取得したスプレッドシートオブジェクト | ※使用例のアウトプット参照 |
+get_spreadsheet_1:
action>: GetSpreadsheet
provider: gsheet_********************
spreadsheet_id: 1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro
# => {
# "spreadsheetId": "1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro",
# "properties": {
# "title": "test",
# "locale": "ja_JP",
# "autoRecalc": "ON_CHANGE",
# "timeZone": "Etc/GMT",
# "defaultFormat": {
# "backgroundColor": {
# "red": 1,
# "green": 1,
# "blue": 1
# },
# "padding": {
# "top": 2,
# "right": 3,
# "bottom": 2,
# "left": 3
# },
# "verticalAlignment": "BOTTOM",
# "wrapStrategy": "OVERFLOW_CELL",
# "textFormat": {
# "foregroundColor": {},
# "fontFamily": "arial,sans,sans-serif",
# "fontSize": 10,
# "bold": false,
# "italic": false,
# "strikethrough": false,
# "underline": false
# }
# }
# },
# "sheets": [
# {
# "properties": {
# "sheetId": 0,
# "title": "シート1",
# "index": 0,
# "sheetType": "GRID",
# "gridProperties": {
# "rowCount": 1000,
# "columnCount": 26
# }
# }
# }
# ],
# "spreadsheetUrl": "https://docs.google.com/a/autoro.io/spreadsheets/d/1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro/edit",
# "provider": "gsheet_********************"
# }
GetCellsは、セルの値を取得するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
spreadsheet* | スプレッドシート、文字列、オブジェクト | 対象のスプレッドシート | +get_spreadsheet_1 |
range* | 文字列 | 取得する値のセルの範囲(A1記法, R1C1記法) | !A1:D4 |
findAll* | 真理値 | trueの場合、範囲内の空白セルを全て含む配列を返却します。falseの場合、左以外の外側の空白行・列を除いた配列を返却します。 | true |
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Array | 配列 | 取得したセルの値を[行][列]の二次元配列で返します。 | *使用例を参照 |
A1:D4(画像赤枠)を選択

- findAllにfalseを指定した時
# セルの値を取得
+get_cells_1:
action>: GetCells
spreadsheet: +get_spreadsheet_1
range: 'Sheet1!A1:D4'
findAll: false
# => [
# [],
# [
# "",
# "B2",
# "C2"
# ],
# [
# "",
# "B3",
# "C3"
# ]
# ]
- findAll にtrueを指定した時
+get_cells_1:
action>: GetCells
spreadsheet: +get_spreadsheet_1
range: 'Sheet1!A1:D4'
findAll: true
# => [
# [
# "",
# "",
# "",
# ""
# ],
# [
# "",
# "B2",
# "C2",
# ""
# ],
# [
# "",
# "B3",
# "C3",
# ""
# ],
# [
# "",
# "",
# "",
# ""
# ]
# ]
UpdateCellsは、セルの値を更新するアクションです。セルの値はすぐに更新されます。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
spreadsheet* | スプレッドシート、文字列、オブジェクト | 対象のスプレッドシート | +get_spreadsheet_1 |
range* | 文字列 | 更新するセルの範囲(A1記法) | !A1:D4 |
values* | 配列 | 書き込む値 | [['A1','B1'],['A2', 'B2']] |
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Spreadsheet | スプレッドシート | 更新されたスプレッドシートオブジェクト | ※使用例のアウトプット参照 |
+update_cells_1:
action>: UpdateCells
spreadsheet: +get_spreadsheet_1
range: 'シート1!A6:D6'
values: [["平均","=SUM(B2:B5)","=SUM(C2:C5)","=SUM(D2:D5)"]]
# => {
# "spreadsheetId": "1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro",
# "properties": {
# "title": "test",
# "locale": "ja_JP",
# "autoRecalc": "ON_CHANGE",
# "timeZone": "Etc/GMT",
# "defaultFormat": {
# "backgroundColor": {
# "red": 1,
# "green": 1,
# "blue": 1
# },
# "padding": {
# "top": 2,
# "right": 3,
# "bottom": 2,
# "left": 3
# },
# "verticalAlignment": "BOTTOM",
# "wrapStrategy": "OVERFLOW_CELL",
# "textFormat": {
# "foregroundColor": {},
# "fontFamily": "arial,sans,sans-serif",
# "fontSize": 10,
# "bold": false,
# "italic": false,
# "strikethrough": false,
# "underline": false
# }
# }
# },
# "sheets": [
# {
# "properties": {
# "sheetId": 0,
# "title": "シート1",
# "index": 0,
# "sheetType": "GRID",
# "gridProperties": {
# "rowCount": 1000,
# "columnCount": 26
# }
# }
# }
# ],
# "spreadsheetUrl": "https://docs.google.com/a/autoro.io/spreadsheets/d/1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro/edit",
# "provider": "gsheet_********************"
# }
AppendValuesは、指定した範囲が含む表の直後に値を追加するアクションです。シート名を指定した場合、シートの最後の空行に値を追加します。
詳しい仕様に関しましては、AppendValuesの挙動についてをご参照ください。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
spreadsheet* | スプレッドシート、文字列、オブジェクト | 対象のスプレッドシート | +get_spreadsheet_1 |
range* | 文字列 | 指定する表の範囲(A1記法) | シート1 ,シート1!A1:B4 |
values* | 配列(2次元配列) | 追加する値 | [['A1','B1'],['A2', 'B2']] |
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Spreadsheet | スプレッドシート | 更新されたスプレッドシートオブジェクト | ※使用例のアウトプット参照 |
+append_values_1:
action>: AppendValues
spreadsheet: +get_spreadsheet_1
range: '!A2:D5'
values: [["E森","23","34","45"]]
# => {
# "spreadsheetId": "1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro",
# "properties": {
# "title": "test",
# "locale": "ja_JP",
# "autoRecalc": "ON_CHANGE",
# "timeZone": "Etc/GMT",
# "defaultFormat": {
# "backgroundColor": {
# "red": 1,
# "green": 1,
# "blue": 1
# },
# "padding": {
# "top": 2,
# "right": 3,
# "bottom": 2,
# "left": 3
# },
# "verticalAlignment": "BOTTOM",
# "wrapStrategy": "OVERFLOW_CELL",
# "textFormat": {
# "foregroundColor": {},
# "fontFamily": "arial,sans,sans-serif",
# "fontSize": 10,
# "bold": false,
# "italic": false,
# "strikethrough": false,
# "underline": false
# }
# }
# },
# "sheets": [
# {
# "properties": {
# "sheetId": 0,
# "title": "シート1",
# "index": 0,
# "sheetType": "GRID",
# "gridProperties": {
# "rowCount": 1000,
# "columnCount": 26
# }
# }
# }
# ],
# "spreadsheetUrl": "https://docs.google.com/a/autoro.io/spreadsheets/d/1zTG_XHbCnC5a5BD5k5WWxdbcYpnEDv4_FfdAPaE33ro/edit",
# "provider": "gsheet_********************"
# }
rangeパラメーターに指定した範囲は、その範囲内にある「テーブル」を見つけるために使用されます。値は範囲内にある最後のテーブルの次の行に、テーブルの開始列と同じ列から追加されます。
以下のシートを例に、AppendValuesの実行結果を解説します。
シートには
A1:C2
とB4:D6
の2つのテーブルがあります。
次のようにrangeパラメーターを指定すると、値は
B7
を起点として追加されます。シート名
のみの指定: シート内の最後のテーブルは②であるため。B4
またはC5:D5
: 両方とも②に含まれるため。B2:D4
: この範囲は①も含むが、範囲内の最後のテーブルは②であるため。A3:G10
: 範囲内にある最後のテーブルが②であるため。
次のようにrangeパラメーターを指定すると、値は
B7
以外を起点として追加されます。A1
: 範囲内のテーブルは①になるので、値はA3
に追加されます。E4
: 範囲内にテーブルがないので、値はE4
に追加されます。
こちらの解説はGoogle Sheets API のドキュメントを翻訳・加筆したものになります。詳細・原文は以下をご参照ください。
ClearValuesは、指定した範囲の値を削除するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
spreadsheet* | スプレッドシート、文字列、オブジェクト | 対象のスプレッドシート | +get_spreadsheet_1 |
range | 文字列 | 削除する表の範囲(A1記法) | シート1!A1:B4 |