概要

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

注: フェデレーション検索またはフェデレーション コネクタを使用すると、有効になっているすべてのサードパーティ検索バックエンドにクエリ文字列が送信されます。サードパーティ システムに送信されるクエリ文字列には、検索リクエストと会話履歴のデータの一部が含まれる場合があります。サードパーティ システムは、クエリをユーザーの ID に関連付けることができます。データがサードパーティ システムに送信されると、Google Cloud の利用規約ではなく、サードパーティ システムの利用規約とプライバシー ポリシーが適用されます。

サポートされている 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 ワークブックのリスト表示、Excel ワークブックのメタデータの読み取り、Word（.docx）または PowerPoint（.pptx）ドキュメントの PDF への変換など）にのみ十分です。ユーザーがアクセスできるすべてのファイル（ユーザーがアクセスできる SharePoint サイトに保存されているファイルを含む）を読み取ります。Excel ワークブックのコンテンツ操作には十分ではありません（次の行を参照）。
	Files.ReadWrite.All	（委任）ワークシートの取得、テーブルの取得、行の取得、行の取得、ワークシートとテーブルの作成、行の追加と更新、キー列の追加など、Excel ワークブックのコンテンツ操作（読み取りと書き込み）すべてに必要です。これらのエンドポイントの Microsoft Graph API リファレンス（worksheet-list、table-list、tablerow-list など）によると、受け入れられる委任された権限は Files.ReadWrite です。Files.ReadWrite.All は、ユーザーがアクセスできるすべてのドライブ（個人用 OneDrive とユーザーがアクセスできる SharePoint ドキュメント ライブラリ）で同じ機能を提供します。ユーザーの OneDrive で Word ドキュメントと PowerPoint ドキュメントを作成する場合にも必要です。
	User.Read	（委任）ファイル操作でログイン ユーザーの OneDrive の場所を解決するために必要です。
タスク（Outlook の To-Do リストとタスク）	Tasks.Read	（委任）サインインしているユーザーの Outlook のタスクリストとタスクに対する読み取りオペレーション（タスクリストのリスト、タスクのリスト、タスクの取得）に必要です。
	Tasks.ReadWrite	（委任）書き込みオペレーション（ログイン ユーザーの Outlook タスクリストでのタスクの作成、更新、削除）に必要です。
ユーザーとディレクトリ（委任された列挙）	User.ReadBasic.All	（委任）組織内の他のユーザーのプロファイルを列挙または検索するツール（ユーザーの取得、ユーザーのリスト、他のユーザーのメールボックスまたはカレンダーで動作するツール）に必要です。

注: 上記のファイル生産性アクションでは、ユーザーのテナント管理者が OAuth アプリ登録で対応する Microsoft Graph API 権限を付与する必要があります。これらの権限が付与されていない場合、Excel、Word、PowerPoint ツールへのリクエストは HTTP 403 accessDenied エラーで失敗します。推奨: すべてのファイル生産性向上ツールを対象とする Files.ReadWrite.All を付与します。Word または PowerPoint の PDF 変換と Excel ワークブックのリスト/メタデータのみが必要な場合（ワークシート、テーブル、行へのアクセスは不要）、Files.Read.All だけで十分です。driveItem ベースのオペレーション（Word/PowerPoint の PDF 変換、Excel ワークブックのリスト表示、Excel ワークブックのメタデータの読み取り）では、Microsoft Graph は Sites.Read.All または Sites.ReadWrite.All を許容される代替手段として文書化しています（driveItem-get と driveItem-get-content-format を参照）。設定手順については、Microsoft Outlook を構成して必要な権限を設定するをご覧ください。

注: 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 データストアは、単一の Azure テナント ID と 1 対 1 でマッピングされます。マルチテナント組織（MTO）内の複数の独立した Microsoft 365 テナントにまたがることはできません。個別のテナントごとに専用のデータストアを作成する必要があります。

• メールボックスが Exchange Online に完全に移行されている必要があります。ハイブリッド Exchange 環境でオンプレミスでホストされているメールボックスには、Microsoft Graph API を介してアクセスできません。これらのメールボックスまたはテナント間のメールボックスをクエリしようとすると、MailboxNotEnabledForRESTAPI エラーが発生する可能性があります。

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

次のステップ

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