Google Workspace Studio で自動フローを構築して実行する場合、セキュリティとデータ プライバシーはデフォルトで組み込まれています。Workspace Studio は最小権限の ID モデルを使用します。つまり、自動化されたフローは、ユーザーの Google アカウント全体への広範で無制限のアクセス権を持つのではなく、個々のアクションを実行するために必要な最小限の権限のみを使用してバックグラウンド タスクを実行します。
自動化を安全に構成し、組織のデータへのアクセス方法を可視化するには、このガイドを使用して、フローの各ステップに必要な権限を特定します。このページでは、各フロー ステップ タイプと、必要な Open Authorization(OAuth)スコープのマッピングについて説明します。
OAuth スコープが Studio の使用に与える影響
Workspace Studio を使用する場合、OAuth スコープはフローの構築、実行、管理に次のように影響します。
- 1 回限りの承認: Google サービス(Gmail や Google ドライブなど)を操作するステップを初めて追加すると、Google からのログイン メッセージが表示されます。これにより、そのステップの特定のスコープが承認され、フローがバックグラウンドで独立して実行できるようになります。
- 非同期のバックグラウンド実行: フローが有効になると、Google のインフラストラクチャで非同期に実行されます。フローは、ユーザーがアクティブにログインしていない場合でも、承認された特定のスコープのみを使用してタスク(カレンダーの予定のスケジュール設定や下書きの作成など)を実行します。
- 管理者による一元管理: 管理者は、管理コンソールのエージェント アクセス管理設定を使用して、組織全体のアクティブなフローをすべて確認できます。特定のフローを一時停止したり、個々の OAuth スコープをターゲットにして制限したり(Gmail を有効にしたままドライブへのアクセスを削除するなど)して、組織のデータ セーフティを維持できます。詳細
権限不足のトラブルシューティング
フローが実行されず、アクティビティ ログに「権限が不十分です」または「エラーが発生しました」というエラーが表示される場合は、次の点を確認してください。
- フローを再承認する: Builder でフローを開き、[変更を保存] をクリックして、承認ボックスのプロンプトに沿って、期限切れまたは欠落している OAuth トークンを更新します。
- コンテキストアウェア アクセス(CAA)ブロック: 組織でデバイス ポリシーや IP ポリシーを厳格に適用している場合、バックグラウンド フローの実行がブロックされることがあります。コア Workspace Studio クライアント ID が CAA の制限から除外されていることを確認します。
フローのステップと必要な OAuth スコープ
次の表に、Workspace Studio の標準的なステップと、各ステップが舞台裏で実行するために必要な OAuth スコープを示します。
| ステップの名前 | 構成とスコープ |
|---|---|
| Studio AI ステップ | |
| AIP プリミティブ(Gemini に相談、Gem に相談、Gemini で作成、Deep Research、未読メールの要約、抽出、決定、要約) | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/cloud_search.query |
| 一般、ユーティリティ | |
| 設定スケジュールで実行 | なし |
| Webhook を送信する | 該当なし - 外部サードパーティ |
| 条件分岐 | 該当なし - 内部ロジック |
| リストをフィルタする | 該当なし - 内部ロジック |
| Gmail | |
| メールの受信時 | https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger |
| メールで通知する | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| メールを送信する | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| メールの下書きを作成する | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| メールを転送する | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| 返信を下書き | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| メールに返信する | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| ラベルを追加または削除する | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| 既読または未読にする | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| スターを付ける、スターを外す | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| アーカイブ(または削除) | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Google Chat | |
| 誰かがスペースに参加したとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| チャット メッセージを受信したとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| 自分の名前リンクが追加されたとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| 絵文字のリアクションが追加されたとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| Chat で通知する | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| Chat スペースを送信する | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| 他のユーザーに送信する | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| メッセージに返信する | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| Google スプレッドシート | |
| シートの変更時 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly |
| 行を追加する | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| 行を更新 | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| 行をクリア | https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| シートのコンテンツを取得 | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Google ドキュメント | |
| Google ドキュメントを作成する | https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly |
| ドキュメントに追加 | https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly |
| Google カレンダーと ToDo リスト | |
| 会議に基づく | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly |
| タスクを作成 | https://www.googleapis.com/auth/tasks |
| イベントを作成する | https://www.googleapis.com/auth/calendar.events |
| ゲストを追加する | https://www.googleapis.com/auth/calendar.events |
| Google ドライブ | |
| フォルダにアイテムが追加されたとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly |
| ファイルが編集されたとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| フォルダ内のアイテムが編集されたとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly |
| ファイルを移動する | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| ファイルをコピーする | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| 添付ファイルの保存 | https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| フォルダを作成する | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Google Meet | |
| 会議メモが | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/meetings.space.readonly |
| Google フォーム | |
| フォームの回答が届いたとき | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/drive.readonly(Google フォームでの DLP ファイルのサポートのみ) |
| NotebookLM | |
| NotebookLM にソースを追加 | https://www.googleapis.com/auth/drive.readonly |
| NotebookLM に質問 | https://www.googleapis.com/auth/drive.readonly |