概要

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 のメール メッセージから添付ファイルをダウンロードします。
メールを送信 メール メッセージを送信します。これには、添付ファイル付きのメールの送信も含まれます。
アタッチメントを追加 既存の下書きメール メッセージに 1 つ以上の添付ファイルを追加します。
メッセージの作成 ログインしているユーザーのメールボックスに新しい下書きメール メッセージを作成します。
メールを転送する 既存のメール メッセージを 1 人以上の受信者に転送します。
メールを移動する ログインしているユーザーのメールボックス内の別のメールフォルダにメール メッセージを移動します。
返信 ログインしているユーザーのメールボックス内の既存のメール メッセージに返信を送信します。
メッセージを更新 ログインしているユーザーのメールボックスにある既存の下書きメール メッセージを更新します。
連絡先の更新 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 に変換します。
カレンダーを作成 ログインしているユーザーの新しいカレンダーを作成します。
カレンダーを更新 ログイン ユーザーの既存のカレンダーを更新します。
イベントへの出欠確認 カレンダーの予定の招待に返信（承諾、辞退、仮承諾）します。

必要な権限

次の表に、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 （委任）データストアが組織内のユーザーとしてメールを送信できるようにします。
Mail.ReadWrite （委任）データストアがメッセージの作成、読み取り、更新、移動、削除、メッセージへの添付ファイルの追加を行えるようにします。**添付ファイルの追加**、**メッセージの作成**、**メッセージの更新**、**メールの移動** のアクションに必要です。
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 ワークブック コンテンツ オペレーション（読み取りと書き込み）に必要です。これらのエンドポイント（worksheet-list、table-list、tablerow-list など）の Microsoft Graph API リファレンスによると、受け入れられる委任権限は Files.ReadWrite です。Files.ReadWrite.All は、ユーザーがアクセスできるすべてのドライブ（個人の OneDrive と、ユーザーがアクセスできる SharePoint ドキュメント ライブラリ）に同じ機能を付与します。ユーザーの OneDrive で Word および PowerPoint ドキュメントを作成する場合にも必要です。
User.Read （委任）ファイル操作のために、ログインしているユーザーの OneDrive の場所を解決するために必要です。
タスク（Outlook の ToDo リストとタスク） Tasks.Read （委任）ログイン ユーザーの Outlook のタスクリストとタスクに対する読み取りオペレーション（タスクリストの一覧表示、タスクの一覧表示、タスクの取得）に必要です。
Tasks.ReadWrite （委任）書き込みオペレーション（ログイン ユーザーの Outlook タスクリストでのタスクの作成、更新、削除）に必要です。
ユーザーとディレクトリ（委任された列挙） User.ReadBasic.All （委任）組織内の他のユーザーのプロフィールを列挙または検索するツール（Get User、List Users、他のユーザーのメールボックスまたはカレンダーを操作するツール）に必要です。

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

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

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

次のステップ