Google Sheets連携：AI Flowi Workflow

著者：Ai Flowi · 公開日 · 更新日

公式情報源：Google Sheets API ドキュメント

Google Sheets連携では、利用可能なコンポーネントを使い、AI Flowi Workflowからスプレッドシートのデータを読み取ったり変更したりできます。プラン：Goは年払いで月額USD8から（月払いUSD10）、全5プランでPro 500まで。全プランは料金ページに掲載しています。2026年10月8日の本番検証では、Webhookの構成例に有効な認証済みリクエストを送ると、1行が追加され、200が返されました。まずワークフローをダウンロードし、Googleアカウントとシートを設定してください。

Google Sheetsでできること

コンポーネントカタログには、Google Sheets向けに利用可能な23個のコンポーネントが掲載されています。以下の一覧では、すべてカタログに記載された正式名称を使用しています。いずれもコンポーネントとして利用できますが、カタログに掲載されているだけでは、実行時の成功を証明できません。Append Rowsは10月8日の構成例で、Upsert Rowは10月9日の重複防止版で、本番検証済みです。これらの結果は、記録された設定に対して得られたものです。

  • Add Sheet
  • Append Rows
  • Bulk Upsert Rows
  • Clear Range
  • Clear Sheet
  • Copy Sheet
  • Create Spreadsheet
  • Delete Columns
  • Delete Rows
  • Delete Sheet
  • Duplicate Sheet
  • Find & Replace
  • Get Spreadsheet
  • Insert Columns
  • Insert Rows
  • List Sheets
  • Read Range
  • Rename Sheet
  • Resize Sheet
  • Search & Delete Row
  • Search Row
  • Update Range
  • Upsert Row

出典：Google Sheetsコンポーネントカタログ。独自のフローを作成する前に、選択したコンポーネントの必須フィールドと認証情報を確認してください。

Googleアカウントを接続する

選択したSheetsコンポーネントで、保存済みのGoogle接続を使用します。設定ガイドでは、次の手順を案内しています。

  1. Settings > Google Connectionsを開き、使用するGoogleアカウントへのアクセスを許可します。
  2. コンポーネントに戻り、接続フィールドで保存済みのGoogleアカウントを選択します。
  3. コンポーネントの必須フィールドを設定し、操作に必要なスコープが接続に付与されていることを確認します。
  4. Google Sheetsで確認できるテスト用データを使って、ワークフローを実行します。

失敗した場合は、保存済みのConnection、ログイン中のアカウントがシートにアクセスできるかどうか、操作に必要なスコープを確認してください。認証を更新できなくなった場合は再認証し、そのアカウントがアクセスできるリソースに対して同じ操作を再試行してください。

出典：Googleアカウントの接続設定、Google接続のトラブルシューティング。

検証済みの構成例：WebhookからGoogle Sheetsへ

AIモデルを使わないこの構成例は、2026年10月8日に、模擬HTTP POSTリクエストとアプリで作成したGoogle Sheetsのスプレッドシートを使って本番検証されました。使用するのはUniversal Webhook、JSON Operations、Verification Router、Append Rows、Webhook Responseです。JSON Operationsは入力を検証して行データを準備し、Verification Routerは有効な入力と拒否された入力をそれぞれの分岐に送ります。

POSTを有効にし、認証にはPlatform API Keyを選択して、POST Response ModeをFrom Flowに設定します。本番エンドポイントはフローを実行します。テスト用エンドポイントはリクエストを取得するだけなので、書き込みの完了やFrom Flowによる応答を検証することはできません。実行された分岐に適用されるWebhook Responseは、必ず1つだけにしてください。

記録された結果：2026年10月8日
リクエストHTTPの結果シートの結果
有効な認証済み入力2001行追加されました。
メールアドレスの欠落、フィールドの型の誤り、無効なメールアドレス、または不正なJSON422行は追加されませんでした。
APIキーの欠落または無効なAPIキー403行は追加されませんでした。

機密情報を除去したワークフローは、新規のフローにインポートして再検証されました。インポート後にGoogle Accountを選択し、Spreadsheet IDと範囲を設定して、Webhook認証を構成してください。シンプル版はSheet1!A:Cとname,email,request列を使用し、同一のデータが届くたびに新しい行を追加します。

検証済みのWebhookからSheetsへの設定手順に従ってください。

出典：記録された構成例の結果、Universal Webhook、Webhook Response。

ダウンロードしたワークフローを使用する前に、WebhookからGoogle Sheetsへのテスト結果を確認してください。結果は、記録された設定に対して得られたものです。

行の重複を防ぐ

2026年10月9日に検証された版は、Upsert Rowを使用し、呼び出し元が指定するevent_idでイベントを識別します。同じイベントを再試行する場合は同じ識別子を再利用し、新しいイベントには別の識別子を使用してください。初回の送信では200 {"status":"inserted"}が返されます。初回の処理後に同じイベントを再送すると、同じ行が更新され、行は追加されず、200 {"status":"duplicate"}が返されます。最後の書き込みが優先されます。

キーは大文字と小文字を区別する1～100文字のテキストで、前後の空白を除去せずに保存されます。重複防止の対象は、1つのスプレッドシート内の1つのワークシートに限られ、行が存在する間だけ有効です。キーを編集または削除すると、再び行を追加できるようになります。コンポーネントはロックせずに読み取り後に書き込むため、重複したデータが同時に届くと、両方が挿入されることがあります。既存の重複行は統合されません。

この版をダウンロードして使用する前に、重複防止の設定、テスト結果、制限を確認してください。

フローでGoogle Sheetsのエラーが起きるとどうなりますか？

記録されているAI Flowi Workflow 1.9.2の構成例では、Google Sheetsのエラーが発生すると、後続のWebhook Responseが実行される前にフローが停止します。エンドポイントはHTTP 404（または500）を返し、Google APIのURLとSpreadsheet IDを含むコンポーネントのエラーをそのまま出力します。誤ったSpreadsheet IDを指定したテストでは、未加工の404エラーが返されました。制御された502応答は実現できませんでした。

本番運用の前に、Spreadsheet IDと共有設定を確認してください。このバージョンにはフロー内のエラー分岐がなく、後続の応答処理ではエラーを捕捉できません。エンドポイントの応答をそのままエンドユーザーに公開しないでください。

出典：検証で確認されたスプレッドシート障害時の制限。

Webhookのエラー処理ガイドで、スプレッドシートのエラーがそのまま返される制限を確認し、呼び出し元での応答処理を計画してください。

費用

ノードを1回実行するごとに1 Flowi Tokenを消費します。プラン：Goは年払いで月額USD8から（月払いUSD10）、全5プランでPro 500まで。全プランは料金ページに掲載しています。

検証済みの構成例はAIモデルを使用しません。外部サービスのAPI利用料はAI Flowiのサブスクリプションに含まれません。プランについては、AI Flowi Workflowの料金をご覧ください。

出典：コンポーネントカタログ、Google接続ガイド、接続のトラブルシューティング、検証済みのSheets構成例、Webhookトリガー、Webhookの応答。