Google スプレッドシート - マイドライブ内のシートの新規/更新行トリガー(リアルタイム)
このトリガーは、選択したシート内の行の変更と、末尾に追加された新しい行をリアルタイムで検出します。
このトリガーは最大10,000行を監視できます。 10,000行目より後の新規または更新された行は取得されません。
制限事項
リアルタイムトリガーはOAuth 2.0コネクションでのみ機能し、サービスアカウントでは機能しません。
このトリガーはマイドライブでのみ機能します。 チームドライブを監視するには、チームドライブ内シートの新規/更新された行トリガーを使用します。
入力
| 入力フィールド | 説明 |
|---|---|
| スプレッドシート | 新規/更新された行を監視するスプレッドシートを選択します。 |
| シート | 新規/更新された行を監視するシートを選択します。 シートには少なくとも1つのヘッダー行と1つのデータ行が必要です。 |
| 監視する列 | 変更を監視する列を選択します。 |
| 列名を手動で追加しますか | 列名を手動で追加するかどうかを指定します。 デフォルトはNoです。 |
出力
| 出力フィールド | 説明 |
|---|---|
| スプレッドシートID | スプレッドシートの一意の識別子。 |
| スプレッドシート名 | スプレッドシートの名前。 |
| シート名 | シート名。 |
| 行番号 | 行番号。 |
このトリガーの使用方法
My Driveのシート内の新規/更新行(リアルタイム)トリガーを設定して使用するには、次の手順を実行します:
Google Sheetを設定する
シートデータを取得するには、シートに少なくとも1つのヘッダー行と1つのデータ行が含まれている必要があります:
1つのヘッダー行と1つのデータ行を含むGoogleスプレッドシートのサンプル
トリガーを設定する
My Driveのシート内の新規/更新行(リアルタイム)トリガーを選択します。
スプレッドシートドロップダウンメニューでスプレッドシートを選択し、スプレッドシート内のシートのリストを動的に生成します。
設定済みの新規/更新シート行トリガー
新規または更新された行を監視する特定のシートをSheetフィールドで選択します。
変更を監視する列をColumn to monitorフィールドで選択します。 この列のセル内のデータが変更されるたびに、レシピは行全体のデータを取得します。
または、All columnsオプションを選択できます。このオプションでは、行が変更されるたびにトリガーがアクティブになります。
トリガーをテストする
トリガーを設定した後、レシピの設定を完了して実行できます。
このテストの目的は、トリガーがシート内の新しい行を検出することを確認することです。 このテストではアクションは重要ではないため、現在時刻を取得Schedulerアクションを使用できます。
スタートレシピをクリックして、レシピを実行します。 レシピは次のスクリーンショットのようになります:
テスト用のSchedulerアクションを含む設定済みレシピ
この例では、トリガーはスプレッドシート内の4行すべてのデータを検出します。 ユーザーに関連する情報を表示するように、ジョブレポートをカスタマイズできます:
処理されたトリガーイベントに関する選択情報を表示するカスタマイズ済みジョブレポート
次に、ジョブレポートのカスタマイズを示します:
Google スプレッドシートのデータを使用したレシピのジョブレポートのカスタマイズ
シートがDate registered列への変更のみを監視するように設定されている場合、他の列(Andyのシャツサイズなど)への変更ではレシピはトリガーされません。
変更されたフィールドが強調表示された編集済みサンプルシート
ただし、セルE5でXanderのDate registered値を編集すると、レシピはそれをトリガーイベントとして検出し、最新データで5行目を処理します。
編集済みシート。 3行目と5行目のセル(強調表示)は新しい値で更新されています
ジョブ詳細に示されているように、5行目がトリガーイベントとして処理されます:
変更を監視している唯一の列である"Date registered"により、取得されるのは5行目のみ
レシピの実行中、新規または更新された行はほぼ即座に取得されます。 レシピを停止して再起動した場合、中断した場所から処理を続行します。 つまり、レシピが停止している間に行われた変更は、レシピが再び開始されると検出および処理されます。
取得されるのは行の最新バージョンのみであることに注意してください。 たとえば、レシピが停止している間に行が作成されて複数回更新された場合、レシピの再起動時にイベントをトリガーするのは最新バージョンのみです。
Last updated: