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 コネクタの使用に影響する可能性のある既知の問題と制限事項について説明します。
既存の Microsoft OneDrive データストアに VPC Service Controls 境界を適用することはできません。VPC Service Controls を適用するには、データストアを削除して再作成する必要があります。VPC Service Controls と、VPC Service Controls を有効にした後にアクションを使用する方法の詳細については、VPC Service Controls でアプリを保護するをご覧ください。
Microsoft OneDrive データストアは、グローバル、米国、EU のロケーションでのみサポートされています。
新しいアプリケーションを作成する場合や、既存のアプリケーションにデータストアを追加する場合は、単一のコネクタタイプのアクションを含むデータストアを追加することをおすすめします。たとえば、アクションが有効になっている 2 つの Microsoft OneDrive データストアを同じアプリケーションに関連付けないでください。
Microsoft OneDrive 連携コネクタの制限事項は次のとおりです。
- 検索の制限事項: 検索結果は変動する可能性があり、すべてのファイル形式を網羅しているとは限りません。アーカイブされたフォルダや暗号化されたフォルダ内のコンテンツは、検索できない場合があります。連携検索では、添付ファイル内の検索はサポートされていません。
- 委任されたアクセス: 共有 Microsoft OneDrive ファイルまたはフォルダへのアクセスには、標準のユーザー認証には含まれない特定の権限が必要になる場合があります。
Microsoft OneDrive 取り込みコネクタの制限事項は次のとおりです。
- 増分同期では、コピー、移動、名前の変更などのフォルダレベルの操作は検出されません。
次のステップ
- Microsoft OneDrive でコネクタを作成して構成する。Microsoft OneDrive データストアを設定するをご覧ください。