Gemini Enterprise の Microsoft OneDrive データストアを使用すると、ファイルやフォルダを検索して操作できます。
サポートされている Microsoft OneDrive のバージョン
Microsoft OneDrive データストアは、Microsoft Graph API v1.0 を介して、Microsoft OneDrive のすべてのホスト型バージョンをサポートしています。
サポートされているアクション
Microsoft OneDrive データストアが有効になっている場合、エンドユーザーは Gemini Enterprise で自然言語のコマンドを使用して次の操作を行うことができます。
| アクション | 説明 |
|---|---|
| フォルダを作成する | Microsoft OneDrive の指定したパスに新しいフォルダを作成します。 |
| ファイルをコピーする | Microsoft OneDrive のソースから宛先にファイルをコピーします。 |
| ファイルをアップロード | Microsoft OneDrive の指定した場所にファイルをアップロードします。 |
| ファイルをダウンロード | Microsoft OneDrive から指定された場所にファイルをダウンロードします。 |
必要な権限
Gemini Enterprise が Microsoft OneDrive データストアを使用して検索とデータ取り込みを実行できるようにするには、次の権限が必要です。
Microsoft Graph API の権限
次の表に、接続モードごとに必要な権限を示します。
注: 次の表に、接続モードごとに必要な権限の概要を示します。連携検索またはデータの取り込みのいずれかの接続モードで [アクション] を有効にした場合は、[アクション] 行に表示されている権限も選択してください。
| 接続モード | スコープ | 目的 |
|---|---|---|
| 連携検索 | Files.Read.All |
（委任）ユーザーがアクセスできるすべてのファイルをデータストアが読み取れるようにします。 |
Sites.Read.All |
（委任）ユーザーがアクセスできるすべてのサイト コレクション内のドキュメントとリストアイテムをデータストアが読み取れるようにします。 | |
User.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 ファイルまたはフォルダへのアクセスには、標準のユーザー認証には含まれない特定の権限が必要になる場合があります。
- 連携検索モードのレイアウト パーサー: レイアウト パーサーは標準ですが、連携検索モードでは、複雑な PDF（表、複数列のレイアウト、OCR が必要な PDF など）に対する有効性は限定的です。このモードのリアルタイム API 呼び出しでは、レイアウト パーサーがデータの取り込み時に実行する詳細な分析に必要なデータや時間が提供されないことがあります。
サポートされていない PDF 機能: そのため、複雑な PDF 構造は完全に分析または検索できない可能性があります。これには次のものが含まれます。
- マルチカラム テキスト レイアウト
- 埋め込まれた表とグラフ内のデータ
- 光学式文字認識（OCR）が必要なスキャンされたドキュメント内のテキスト
- 読み取り順序が線形でないドキュメントや、複雑な書式設定が施されているドキュメント。
Microsoft OneDrive 取り込みデータストアの制限事項は次のとおりです。
- 増分同期では、コピー、移動、名前の変更などのフォルダレベルの操作は検出されません。
推奨事項
複雑な機能（表、複数列のレイアウト、OCR 依存のコンテンツなど）を含む PDF を含む Microsoft OneDrive データの場合は、効果的な検索のためにデータの取り込みモードを使用することをおすすめします。このモードでは、レイアウト パーサーがドキュメント コンテンツ全体を詳細に処理してインデックス登録できます。
次のステップ
- Microsoft OneDrive でデータストアを作成して構成する。Microsoft OneDrive データストアを設定するをご覧ください。