Google Workspace Studio を拡張する

フローを使用すると、Google Workspace ユーザーは、コードを記述することなく、一連のステップを組み合わせてサービス間でタスクを自動化できます。フローを拡張することで、ユーザーはアプリのイベントからワークフローをトリガーし、アプリの関数をステップとして追加できます。

たとえば、ユーザーは次の処理を行うフローを使用して、受信したお客様からの質問をトリアージして割り当てることができます。

  1. お客様からメールを受信する。
  2. Gemini にメールのトリアージを指示する。
  3. 営業チームまたはサポートチームにフォローアップするタスクを作成する。

このドキュメントでは、フローで実行できるカスタムのスターターとステップを作成して、 Google Workspace Studio の機能を拡張する方法について説明します。

まず、 スタートガイドのクイックスタート、Codelab、デベロッパー ガイドをご覧ください。

顧客からのメールの受信、Gemini へのプロンプトの送信、フォローアップ タスクの作成の手順が表示された Flows インターフェース。
図 1: ユーザーが Gemini でお客様からの質問をトリアージするフローを構成する。

Workspace Studio のコンセプト

次の用語とコンセプトは、Workspace Studio の主要コンポーネントを定義します。

フロー

ユーザーは

Workspace Studio でフローを作成して、Google Workspace などのタスクを自動化します。 フローは、システムとの緊密な統合、コンテキスト認識を備えており、必要に応じて AI を使用できます。

ステップ

フローの自動化プロセスの 1 つのステップ。基本的には、開始イベントに続く一連のタスクの 1 つのタスクです。各ステップは同期的に実行されます。つまり、シーケンス内の次のステップが開始される前にオペレーションが完了します。ユーザーはステップの順序を設定して、タスクの論理フローをカスタマイズできます。ステップには入力と出力を含めることができますが、必須ではありません。ステップの例としては、「メールを送信する」、「Chat スペースに投稿する」、「Gemini に質問する」などがあります。ステップには、CRM リードの作成など、Google Workspace 以外のタスクを含めることができます。

スターター
フローの自動化プロセスのエントリ ポイント。UI では、 ユーザーに「スターター」として表示されますが、マニフェスト スキーマと Google Workspace Studio API では、workflowTriggerとして定義されます。「ステップ」 はシーケンスの途中で同期アクションを実行しますが、「スターター」 はフローの先頭に配置され、イベント（Google Workspace アプリまたはサードパーティのウェブフックからのイベント）をリッスンします。トリガーされると、イベントの詳細を取得し、初期データ変数を出力して、フローの実行を開始します。
入力変数
入力変数はステップで受信されます。入力変数は、ユーザーがステップを設定するときに、ステップの構成カードで設定されます。たとえば、メールアドレス、日時、Gemini プロンプトを収集します。
出力変数
出力変数はステップから返され、別のステップに送信できます。たとえば、出力変数を使用して、メールアドレスを別のステップに渡します。このステップでは、メールの受信者を指定するために使用されます。
動的変数
ユーザーがフローを構成するときにのみデータを特定できる変数。たとえば、Google フォームにはさまざまな質問と回答があります。特定のフォームがフローを開始するまで、質問と回答の数（およびその内容）を特定することはできません。動的変数はこのケースに対応しています。
カスタム リソース
複数の変数をグループ化するために定義できるカスタム データ構造。たとえば、CRM リードを作成するには、メールアドレス、番地、名前を含むカスタム リソースを渡します。
カード

アドオンのユーザー インターフェースのビルディング ブロック。カードは、定義されたレイアウト、ボタンなどのインタラクティブな UI 要素、画像などのリッチメディアをサポートしています。カードには、フローを作成するための特別な機能があります。

  • IncludeVariables: 動的変数の包含を有効にするプロパティ。
  • Type: 入力変数が想定するデータの型を定義します。
アクティビティ ログ
フローの実行時に発生する処理について説明します。デフォルトでは、アクティビティ ログには、マニフェストで静的に定義されたスターターまたはステップの名前が含まれます。 カスタマイズされたアクティビティ ログをさらに提供できます。

始める

フローは、Google Workspace のアドオン プラットフォームで構築されます。既存のアドオンがある場合は、フロー固有のセクションを含むようにマニフェストを更新することで、フローを含めるように機能を拡張できます。

ゼロから始める場合は、次のクイックスタート、Codelab、デベロッパー ガイドをご覧ください。

クイックスタート

クイックスタート ガイドに沿って、最初のカスタムステップを作成してテストします。

クイックスタートを試す

Codelab

スターターとステップの両方を実装するエンドツーエンドの例については、次の Codelab をご覧ください。

デベロッパー ガイド

フローのスターターとステップの作成とカスタマイズを続けるには、次のガイドをご覧ください。