説明

スプレッドシートの指定した範囲を、決まった間隔で確認するトリガーです。監視対象にした列(または行)の値が前回の確認から変わっていると、ワークフローが実行されます。更新された行(または列)の番号と値を、後続のコネクタで使えます。

更新を検知するしくみ

  • ワークフローを公開した時点の値を基準として保存します。公開より前の変更は検知しません
  • 実行間隔ごとに 監視対象の列(または行)の値だけ を前回の確認時と比べ、値が変わったセルの行(または列)を「更新された」とみなします。値の追加・変更・削除のどれも更新として扱います
  • 監視対象以外の列(または行)が変わっても検知しません
  • 更新が無いときは、ワークフローは実行されません

例えば、A列〜D列の表で「ステータス」のC列を監視対象にすると、C列の値が変わった行だけが通知されます。同じ行のほかの列(A・B・D列)の値も、見出しの名前の変数で受け取れます。

C列(ステータス)を監視対象にした場合に、値が変わった2行目と4行目だけが通知され、B列だけが変わった3行目は通知されない例

項目ごとの説明

Google Sheets の指定範囲の更新検知の設定画面(縦方向で、ステータスの列を監視対象にした例)

項目 必須 説明
コネクタ名 ○ ワークフローの中でこのコネクタを見分けるための名前
認証 ○ 使う 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件ずつ処理するときは、トリガーの後に リスト処理コネクタ をつなぎます
  • 実行間隔の間に値が変わって元に戻った場合は、検知しません。比べるのは確認した時点の値どうしです
  • 値は位置(行番号・列番号)ごとに比べます。範囲の途中で行(横方向では列)を挿入・削除すると、それより後ろの値の位置がずれるため、ずれた行(列)がまとめて更新として検知されることがあります