概要

Gemini Enterprise の Microsoft OneDrive データストアを使用すると、Microsoft OneDrive にアクセスして、ファイルやフォルダを操作できます。

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

Microsoft OneDrive データストアは、Microsoft Graph API v1.0 を介して、Microsoft OneDrive のすべてのホスト型バージョンをサポートしています。

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

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

アクション 説明
フォルダを作成する Microsoft OneDrive の指定したパスに新しいフォルダを作成します。
ファイルをコピーする Microsoft OneDrive のソースから宛先にファイルをコピーします。

必要な権限

Gemini Enterprise が Microsoft OneDrive データストアを使用して検索とデータ取り込みを実行できるようにするには、次の権限が必要です。

Microsoft Graph API の権限

次の表に、接続モードごとに必要な権限を示します。

注: 次の表に、接続モードごとに必要な権限の概要を示します。連携検索またはデータの取り込みのいずれかの接続モードで [アクション] を有効にした場合は、[アクション] 行に表示されている権限も選択してください。

接続モード スコープ 目的
連携検索 Files.Read.All （委任）ユーザーがアクセスできるすべてのファイルをデータストアが読み取れるようにします。
Sites.Read.All （委任）ユーザーがアクセスできるすべてのサイト コレクション内のドキュメントとリストアイテムをデータストアが読み取れるようにします。
データの取り込み GroupMember.Read.All （フェデレーション認証情報と OAuth 2.0 更新トークン）ログインしているユーザーがいなくても、データストアがすべてのグループのメンバーシップと基本的なグループ プロパティを読み取れるようにします。
User.Read （フェデレーション認証情報と OAuth 2.0 更新トークン）データストアがログイン ユーザーのプロファイルを読み取れるようにします。また、データストアがログイン ユーザーの基本的な会社情報を読み取れるようにします。
User.Read.All （OAuth 2.0 更新トークンのみ）データストアがユーザー プロファイルを読み取れるようにします。
Sites.FullControl.All（オプション 1）
Sites.Selected（オプション 2）		 （フェデレーション認証情報と OAuth 2.0 更新トークン）オプション 1 では、データストアがすべてのサイト コレクションを完全に制御できます。オプション 2 では、データストアがサイト コレクションのサブセットにアクセスできます。特定のサイト コレクションと付与された権限は、Microsoft OneDrive で構成できます。
User.Read.All（オプション 1）
User.ReadBasic.All（オプション 2）		 （フェデレーション認証情報のみ）オプション 1 では、データストアがユーザー プロファイルを読み取ることができます。オプション 2 では、データストアが組織内の他のユーザーの基本的なプロファイル プロパティを読み取ることができます。
アクション Files.ReadWrite.AppFolder （委任）Microsoft OneDrive フォルダ内のファイルをデータストアが読み取り、作成、更新、削除できるようにします。
Files.ReadWrite （委任）ユーザーがアクセスできるファイルをデータストアが読み取り、作成、更新、削除できるようにします。

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

制限事項

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

  • 新しいアプリを作成する場合や、既存のアプリにデータストアを追加する場合は、単一のコネクタタイプに属するアクションを含むデータストアを 1 つだけ関連付けることをおすすめします。
  • 既存の Microsoft OneDrive データストアに VPC Service Controls 境界を適用することはできません。VPC Service Controls を適用するには、データストアを削除して再作成する必要があります。VPC Service Controls と、VPC Service Controls を有効にした後にアクションを使用する方法の詳細については、VPC Service Controls でアプリを保護するをご覧ください。
  • Microsoft OneDrive データストアは、global、us、eu のロケーションでのみサポートされています。

Microsoft OneDrive 連携データストアの制限事項は次のとおりです。

  • 検索の制限事項: 検索結果は変動する可能性があり、すべてのファイル形式を網羅しているとは限りません。アーカイブされたフォルダや暗号化されたフォルダ内のコンテンツは、検索できない場合があります。連携検索では、添付ファイル内の検索はサポートされていません。
  • 委任されたアクセス: 共有 Microsoft OneDrive ファイルまたはフォルダへのアクセスには、標準のユーザー認証には含まれない特定の権限が必要になる場合があります。

Microsoft OneDrive 取り込みデータストアの制限事項は次のとおりです。

  • 増分同期では、コピー、移動、名前の変更などのフォルダレベルの操作は検出されません。

次のステップ