説明
スプレッドシートの指定した範囲を、決まった間隔で確認するトリガーです。監視対象にした列(または行)の値が前回の確認から変わっていると、ワークフローが実行されます。更新された行(または列)の番号と値を、後続のコネクタで使えます。
更新を検知するしくみ
- ワークフローを公開した時点の値を基準として保存します。公開より前の変更は検知しません
- 実行間隔ごとに 監視対象の列(または行)の値だけ を前回の確認時と比べ、値が変わったセルの行(または列)を「更新された」とみなします。値の追加・変更・削除のどれも更新として扱います
- 監視対象以外の列(または行)が変わっても検知しません
- 更新が無いときは、ワークフローは実行されません
例えば、A列〜D列の表で「ステータス」のC列を監視対象にすると、C列の値が変わった行だけが通知されます。同じ行のほかの列(A・B・D列)の値も、見出しの名前の変数で受け取れます。

項目ごとの説明

| 項目 | 必須 | 説明 |
|---|---|---|
| コネクタ名 | ○ | ワークフローの中でこのコネクタを見分けるための名前 |
| 認証 | ○ | 使う Google Sheets の認証。認証の追加方法は Google Sheets 認証 をご覧ください |
| 実行間隔 | ○ | 5分・10分・15分・20分・30分・60分から選びます。毎時0分から、選んだ間隔ごとにワークフローが起動します |
| トリガー | ○ | 「指定範囲に更新があった場合」を選びます |
| スプレッドシートのIDの指定 | ○ | 対象のスプレッドシートのID。スプレッドシートの URL の https://docs.google.com/spreadsheets/d/ と /edit の間の文字列です |
| 一覧データの方向を指定 | ○ | 表の向きを選びます(下の「一覧データの方向」を参照) |
| シート名を指定 | ○ | 対象のシートの名前 |
| 範囲を指定 | ○ | 読み込む範囲。A1:Z10 の形で指定します。行番号を省くと(例: A:Z)、1行目から読み込みます。読み込める行数は 10,000 行までです |
| 見出しになる行または列を指定 | ○ | 見出しにする行(縦方向のとき。1行目〜50行目)または列(横方向のとき。A列〜Z列)。見出しが無い表では「見出し行設定しない」を選びます |
| 取得した項目名を変数名として利用します | 見出しから読み取った項目名が表示されます。これが変数の名前になります。表示されないときや見出しを変えたときは「見出し行リストの取得」を押します | |
| 監視対象の列または行を指定 | ○ | 更新を確認する列(縦方向のとき)または行(横方向のとき)を、見出しの項目名から選びます。監視できるのは最大 10,000 セルです |
一覧データの方向
| 方向 | 表の形 | 監視対象・通知の単位 |
|---|---|---|
| 縦方向 | 見出しが横に並んでいて、下に情報が並んでいる場合 | 監視対象は列。更新は行ごとに通知 |
| 横方向 | 見出しが縦に並んでいて、横に情報が並んでいる場合 | 監視対象は行。更新は列ごとに通知 |
見出しを設定しない場合
「見出し行設定しない」を選ぶと、縦方向では「A列」「B列」…、横方向では「1行」「2行」…が項目名(変数の名前)になります。
変数の説明
更新された行(または列)は、1回の実行でまとめてリスト(LIST)として渡されます。
縦方向のとき
| 変数名 | データタイプ | 説明 |
|---|---|---|
| 実行日時 | TEXT | コネクタが実行された日時 |
| 実行ステータス | BOOL | コネクタの実行結果 |
| 更新された行数 | TEXT | 更新された行の数 |
| 行番号 | LIST | 更新された行の番号 |
| (見出しの各項目名) | LIST | 更新された行の、その項目の値 |
横方向のとき
| 変数名 | データタイプ | 説明 |
|---|---|---|
| 実行日時 | TEXT | コネクタが実行された日時 |
| 実行ステータス | BOOL | コネクタの実行結果 |
| 更新された列数 | TEXT | 更新された列の数 |
| 列番号 | LIST | 更新された列の番号(A、B …) |
| (見出しの各項目名) | LIST | 更新された列の、その項目の値 |
注意事項(仕様など)
- 1回の確認で複数の行(または列)が更新されていた場合も、ワークフローの実行は1回です。1件ずつ処理するときは、トリガーの後に リスト処理コネクタ をつなぎます
- 実行間隔の間に値が変わって元に戻った場合は、検知しません。比べるのは確認した時点の値どうしです
- 値は位置(行番号・列番号)ごとに比べます。範囲の途中で行(横方向では列)を挿入・削除すると、それより後ろの値の位置がずれるため、ずれた行(列)がまとめて更新として検知されることがあります