概要

Gemini Enterprise の Microsoft Outlook データストアを使用すると、OneDrive と SharePoint に保存されているメール、カレンダー、連絡先、Microsoft 365 ファイル（Excel ワークブック、Word ドキュメント、PowerPoint プレゼンテーション）を検索して操作できます。

サポートされている Microsoft Outlook のバージョン

Microsoft Outlook データストアは、IDP 統合で Microsoft Graph API v1.0 をサポートしています。

サポートされているアクション

Microsoft Outlook データストアが有効になっている場合、エンドユーザーは Gemini Enterprise で自然言語のコマンドを使用して次の操作を行うことができます。

アクション	説明
連絡先の作成	Microsoft Outlook に新しい連絡先を作成します。
イベントを作成	新しい予定を作成します。
添付ファイルをダウンロード	Microsoft Outlook のメール メッセージから添付ファイルをダウンロードします。
メールを送信	メール メッセージを送信します。これには、添付ファイル付きのメールの送信も含まれます。
連絡先を更新する	Microsoft Outlook の既存の連絡先を更新します。
更新イベント	既存の予定を更新します。
Excel データを読み取る	OneDrive または SharePoint に保存されている Excel（.xlsx）ファイルからワークブックを一覧表示し、ワークシート、テーブル、行を読み取ります。
Excel データを編集する	OneDrive または SharePoint に保存されている Excel（.xlsx）ファイルで、行の追加と更新、ワークシートとテーブルの作成、キー列の追加を行います。
Word ドキュメントを作成する	ユーザーの OneDrive に新しい Word（.docx）ドキュメントを作成します。
Word 文書を PDF に変換する	OneDrive または SharePoint に保存されている Word（.docx）ドキュメントを PDF に変換します。
PowerPoint プレゼンテーションを作成する	ユーザーの OneDrive に新しい PowerPoint（.pptx）プレゼンテーションを作成します。
PowerPoint を PDF に変換する	OneDrive または SharePoint に保存されている PowerPoint（.pptx）プレゼンテーションを PDF に変換します。

注:

• 読み取り専用の操作もあります。
• Gemini Enterprise でのファイルのアップロードとダウンロードの最大ファイルサイズは 25 MB です。
• Excel、Word、PowerPoint のアクションでは、ユーザーが操作している OneDrive または SharePoint ファイルに対する Microsoft Graph API の追加の権限が必要です。詳細については、[必要な権限](#required-permissions) をご覧ください。

必要な権限

次の表に、Microsoft Outlook の検索と操作に必要な権限を示します。

接続モード	権限	目的
連携検索	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	（委任）データストアがログイン ユーザーのメールボックス、共有メールボックスからのメール、カレンダーの予定、連絡先を読み取れるようにします。
データの取り込み	Calendars.Read	（アプリケーション）データストアがすべてのカレンダーの予定を読み取れるようにします。
	Calendars.ReadBasic.All	（アプリケーション）データストアが、本文、添付ファイル、拡張機能などのプロパティを除く、すべてのカレンダーの予定を読み取れるようにします。
	Contacts.Read	（アプリケーション）データストアがすべてのメールボックスのすべての連絡先を読み取れるようにします。
	Mail.Read	（アプリケーション）データストアがすべてのメールボックスのメールを読み取れるようにします。
	Mail.ReadBasic	（アプリケーション）データストアがすべてのメールボックスの基本的なメール プロパティを読み取れるようにします。body、previewBody、attachments、拡張プロパティを除くすべてのプロパティが含まれます。
	Mail.ReadBasic.All	（アプリケーション）データストアがすべてのメールボックスの基本的なメール プロパティを読み取れるようにします。body、previewBody、attachments、拡張プロパティを除くすべてのプロパティが含まれます。
	User.Read	（委任）データストアがログインしているユーザーのプロファイルを読み取れるようにします。
	User.Read.All	（アプリケーション）データストアが組織内の他のユーザーのプロファイル プロパティ、レポート、マネージャーの完全なセットを読み取れるようにします。
	User.ReadBasic.All	（アプリケーション）データストアが組織内の他のユーザーの基本的なプロファイル プロパティを読み取れるようにします。
アクション	Mail.Send	（委任）データストアが組織内のユーザーとしてメールを送信できるようにします。
	Calendars.ReadWrite	（委任）データストアがユーザーのカレンダーで予定の作成、読み取り、更新、削除を行えるようにします。
	Contacts.ReadWrite	（委任）データストアがユーザーの連絡先を作成、読み取り、更新、削除できるようにします。
	User.Read	（委任）データストアがログインしているユーザーのプロファイルを読み取れるようにします。
ファイルの生産性（Excel、Word、PowerPoint）	Files.Read.All	（委任）Excel ワークブックの読み取りオペレーション（ワークシートのリスト取得、テーブルの取得、行の取得）と、Word または PowerPoint から PDF への変換に必要です。ユーザーがアクセスできるすべてのファイル（ユーザーがアクセスできる SharePoint サイトに保存されているファイルを含む）を読み取ります。
	Files.ReadWrite.All	（委任）書き込みオペレーション（Excel ワークシートとテーブルの作成、Excel 行の追加と更新、キー列の追加、ユーザーの OneDrive での Word ドキュメントと PowerPoint ドキュメントの作成）に必要です。
	User.Read	（委任）ファイル操作でログイン ユーザーの OneDrive の場所を解決するために必要です。
タスク（Outlook の ToDo リストとタスク）	Tasks.Read	（委任）サインインしているユーザーの Outlook のタスクリストとタスクに対する読み取りオペレーション（タスクリストのリスト、タスクのリスト、タスクの取得）に必要です。
	Tasks.ReadWrite	（委任）書き込みオペレーション（ログイン ユーザーの Outlook タスクリストでのタスクの作成、更新、削除）に必要です。
ユーザーとディレクトリ（委任された列挙）	User.ReadBasic.All	（委任）組織内の他のユーザーのプロファイルを列挙または検索するツール（ユーザーの取得、ユーザーのリスト、他のユーザーのメールボックスまたはカレンダーで動作するツール）に必要です。

注: 上記のファイル生産性アクションでは、ユーザーのテナント管理者が OAuth アプリ登録で対応する Microsoft Graph API 権限を付与する必要があります。これらの権限が付与されていない場合、Excel、Word、PowerPoint ツールへのリクエストは HTTP 403 accessDenied エラーで失敗します。最小権限の要件が厳しいテナントは、対応する Files.* スコープの代わりに Sites.Read.All / Sites.ReadWrite.All（サイト スコープ）または Sites.Selected（Microsoft Entra で構成された特定のサイト コレクション）を使用できます。設定手順については、Microsoft Outlook を構成して必要な権限を設定するをご覧ください。受け入れられる代替手段の完全なリストについては、Microsoft Graph の委任された権限をご覧ください。

注: Tasks.Read または Tasks.ReadWrite がないと、Outlook タスクツールが HTTP 403 notAllowed で失敗します。User.ReadBasic.All（委任）がないと、ユーザー検索ツールが HTTP 403 Authorization_RequestDenied で失敗します。より高い権限を持つユーザー アクセスが必要なテナントは、User.ReadBasic.All の代わりに User.Read.All または Directory.Read.All を使用できます。

Microsoft Outlook の権限を追加する方法については、Microsoft Outlook を構成して必要な権限を設定するをご覧ください。

データ取り込みのレート上限

リクエスト数の上限は、10 分あたり 10,000 件の API リクエストです。これらのレート上限は、接続モードとして取り込みを使用する場合に、Microsoft Outlook データストアにのみ適用されます。

制限事項

このセクションでは、Microsoft Outlook データストアの使用に影響する可能性のある既知の問題と制限事項について説明します。

• 新しいアプリを作成する場合や、既存のアプリにデータストアを追加する場合は、単一のコネクタタイプに属するアクションを含むデータストアを 1 つだけ関連付けることをおすすめします。

• 既存の Microsoft Outlook データストアに VPC Service Controls 境界を適用することはできません。VPC Service Controls を適用するには、データストアを削除して再作成する必要があります。VPC Service Controls と、VPC Service Controls を有効にした後にアクションを使用する方法の詳細については、VPC Service Controls でアプリを保護するをご覧ください。

• Microsoft Outlook データストアは、global、us、eu のロケーションでのみサポートされています。

• Microsoft Outlook データストアは、ノードごとに 1 秒あたり 1 件のトランザクションを処理でき、この上限を超えるトランザクションはすべてスロットルされます。

• Microsoft Outlook データストアがレート制限超過エラーで再試行できるかどうかは、Microsoft Graph API から retry-after 値を受け取るかどうかに依存します。この値は Outlook データストアでのみ提供されます。デフォルトの再試行回数は 3 回です。

• Microsoft Outlook データストアのスループットは、Microsoft Graph によって課せられる API 呼び出しの制限によって制限されます。上限は、各アプリ ID とメールボックスの組み合わせ（特定のユーザーまたはグループのメールボックスにアクセスする特定のアプリ）に適用されます。1 つのメールボックスの制限を超えても、アプリケーションが別のメールボックスにアクセスする機能には影響しません。

次のステップ

• Microsoft Outlook でデータストアを作成して構成する。Microsoft Outlook データストアを設定するをご覧ください。