概要

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 データストアは、グローバル、US、EU のロケーションでのみサポートされています。

  • 新しいアプリケーションを作成する場合や、既存のアプリケーションにデータストアを追加する場合は、単一のコネクタタイプに属するアクションを含むデータストアを追加することをおすすめします。たとえば、2 つの Microsoft OneDrive データストアを、アクションが有効になっている同じアプリケーションに関連付けないでください。

Microsoft OneDrive 連携コネクタには次の制限事項があります。

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

Microsoft OneDrive 取り込みコネクタの制限事項は次のとおりです。

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

次のステップ