Google Workspace アドオンを使用することで、Google Workspace Studio を拡張、カスタマイズできます。組み込みの Workspace アクションに加えて、カスタム アドオンを使用して、フローを外部ツールや内部サービスに接続できます。
- カスタム スターター: 外部アプリまたはカスタム サービスでリアルタイム イベント（Airtable の新しいレコード、着信 Webhook、カスタマー サポート チケットの更新など）が発生したときに、自動フローを開始します。
- カスタム ステップ: フロー シーケンス内でアクションまたはタスクを実行します（メッセージの投稿、タスクの作成、SMS の送信など）。
このページの内容:
- カスタム スターターとカスタム ステップを作成する
- カスタム アドオンをインストールする
- フロー内でカスタム スターターを使用する
- フロー内でカスタム ステップを使用する
- アドオンのアカウント アクセスを管理する
- 関連リソース
カスタム スターターとカスタム ステップを作成する
次の手順で、Google Apps Script やお好みのプログラミング言語と HTTP アドオンを使用して、カスタム スターターとカスタム ステップを作成できます。
- アドオン マニフェストで、workflowTrigger を使用してスターターを定義し、workflowAction を使用してステップを定義します。
- カスタム スターターは、イベントが発生するたびに、Workspace Studio API エンドポイントを呼び出して、Workspace Studio に非同期で通知できます。
- テストデプロイを使用してカスタム アドオンをチームと非公開で共有したり、Google Workspace Marketplace に公開したりできます。
デベロッパー向けの仕様、マニフェストのサンプル、API リファレンスの詳細については、以下をご覧ください。
- スターターを構築する（Google for Developers）: https://developers.google.com/workspace/add-ons/studio/build-a-starter
- ステップを構築する（Google for Developers）: https://developers.google.com/workspace/add-ons/studio/build-a-step
カスタム アドオンをインストールする
カスタム スターター、カスタム ステップ、またはその両方を含んでいるアドオンをインストールできます。
Google Workspace Marketplace からインストールする:
- workspace.google.com/marketplace?host=workflow にアクセスします。
- このリンクをクリックすると、あらかじめフィルタされたビューが表示され、Workspace Studio で動作するアドオンと統合のみが表示されます。
- インストールするアドオンを選択します。
- [インストール] をクリックします。
- 画面上の手順に沿って、自分の Google アカウントのデータへのアクセス権をアドオンに付与し、インストールを完了します。
デベロッパーから提供された非公開のテストデプロイをインストールする: 組織内のデベロッパーが Marketplace に公開されていないカスタム アドオンを作成した場合、そのデベロッパーはテストデプロイ ID を共有できます。
- Google Workspace で、アドオンの管理設定を開きます。
- [デベロッパー アドオン] で、デベロッパーから提供されたデプロイ ID を入力します。
- [インストール] をクリックし、リクエストされた権限を承認します。
注: アドオンをアンインストールするには、Google Workspace Marketplace に戻り、アドオンを見つけて [アンインストール] をクリックします。管理者がドメインにインストールしたアドオンは、管理者のみがアンインストールできます。
フロー内でカスタム スターターを使用する
カスタム スターターを含んでいるアドオンをインストールすると、Workspace Studio のフローエディタにそのスターターが表示されます。
- Workspace Studio で [フローを作成] をクリックします。
- フローの先頭にあるスターター カードで、[スターターを追加] をクリックします。
- スターターの選択パネルで、インストールしたアドオンのセクションを見つけて、カスタム スターターを選択します。
- スターター設定カードで、必要な入力設定を行います（プロジェクト識別子の入力、リソース フィルタの選択、外部サービスへのログインなど）。
- フローに後続のステップを追加します。スターターの出力変数（イベント名、タイムスタンプ、ペイロード データなど）は、下流のステップの変数セレクタに表示されます。
- フローの準備ができたら、「オンにする」アイコン
をクリックします。
サブスクリプションのライフサイクルについて
- 自動サブスクリプション: カスタム スターターを含んでいるフローを有効にするか公開すると、Workspace Studio はデベロッパーのアドオンにサブスクリプションを自動的に登録し、イベントのモニタリングを開始します。
- 自動サブスクリプション解除: フローを無効にするか削除すると、Workspace Studio はデベロッパーのアドオンに自動的に通知し、登録を解除して今後のイベント通知の送信を停止します。
テストに関する注意事項: Workspace Studio では、カスタム スターターの手動テスト実行はサポートされていません。フローをテストするには、フローを有効にして、外部アプリまたはサービスで実際のイベントをトリガーします。
フロー内でカスタム ステップを使用する
Workspace Studio アドオンをインストールすると、フローの作成や編集を行うところにステップが表示されます。具体的には次のとおりです。
- フローエディタ内で: ステップ選択パネルで、アドオン名のセクションまでスクロールし、カスタム ステップをクリックします。
- Gemini のアシスタントで: Studio の [Discover] ページで、作成するフローを自然言語で記述します。Studio は、インストール済みのアドオンのステップを自動的に提案して配置できます。
重要: サードパーティ統合ステップやアドオンのステップに変数を追加すると、その変数に Gmail のメール内容、Google Chat のメッセージ内容、カレンダーの予定など、ユーザーの Google アカウントのデータが格納されることがあります。フローは、このデータをサードパーティ サービスと共有できます。フローの実行には、信頼できるサードパーティ サービスを利用してください。
アドオンのアカウント アクセスを管理する
アドオンが Google アカウントのデータにアクセスすることに懸念がある場合は、接続を確認、削除できます。
- myaccount.google.com/connections にアクセスします。
- サードパーティ製のアプリとサービスのリストの中からアドオンを検索して選択します。
- [（アドオン名）との接続をすべて削除しますか？] をクリックし、承認します。
注: アドオンのアカウント接続を削除すると、そのカスタム スターターやカスタム ステップを使用するフローが実行されなくなる可能性があります。アドオンを再接続するには、Workspace Studio でフローを開き、承認を求められたら接続を再度承認します。