次の方法で共有


Microsoft Graph コネクタ API を使用する

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

Microsoft Graph コネクタを使用して、外部サービスからのデータを Microsoft Graph に取り込むことができます。 Microsoft Graph コネクタ API を使用すると、外部データのインデックスを作成して、 CopilotMicrosoft Search などの Microsoft 365 のインテリジェント エクスペリエンスを強化できます。

インデックス データへの要求は、アプリケーションの アクセス許可を持つアクセス トークンを介してサインインユーザーが存在することなく、アプリケーションに代わって実行されます。

カスタム Microsoft Graph コネクタを構築する

カスタム Microsoft Graph コネクタを構築するには、次の 4 つの手順が必要です。

  1. Entra ID (旧称 Azure Active Directory) アプリの登録を作成します。 Microsoft Graph への要求と共に、アプリに必要なアプリ登録と API アクセス許可の名前を送信します。 Microsoft Graph は、新しく作成されたアプリの登録に関する情報で応答します。
  2. 外部接続を作成します。 各接続には、一意の ID、名前、および説明が必要です。
  3. 外部接続のスキーマを作成します。 スキーマは、この Microsoft Graph 接続を介して取り込む外部コンテンツの形状を定義します。 スキーマの作成は、実行時間の長い操作です。 接続を作成するためにスキーマを送信した後、Microsoft Graph は、操作の状態を確認するために使用できる URL で応答します。 操作の状態が である限り、スキーマは inprogressプロビジョニングされています。 プロビジョニングが完了すると、操作によって状態が返 completed されます。
  4. 外部コンテンツを取り込む。 外部アイテムごとに、ソース コンテンツ リポジトリから抽出し、外部接続のスキーマと一致するように変換し、外部アイテムとして Microsoft Graph に送信します。 項目と共に、アクセスを許可されたユーザーに関する情報 (アクセス制御リスト (ACL) とも呼ばれます) を含めます。

次に、Microsoft Graph コネクタを構築する 4 つの手順を示すシーケンス図を示します。

Microsoft Graph コネクタを構築する 4 つの手順を示す図

一般的なユース ケース

次の表に、Microsoft Graph コネクタ API の一般的なユース ケースを示します。

ユース ケース REST リソース 関連項目
アクションの構成
接続の作成、更新、または削除 externalConnection externalConnection メソッド
外部データ用のスキーマの登録 schema schema メソッド
インデックス作成のアクション
インデックスでのカスタム アイテムの追加、更新、または削除 externalItem externalItem メソッド

既知の制限

以下は、現在の既知の制限です。

  • 組織の最大接続数は 10 接続に制限されています。 (さらに接続が必要な場合は、 要求フォームに入力してください)。
  • 1 秒あたり最大 25 個 の externalItem リソース 項目を作成できます。
  • アプリケーションは、接続に対して 25 個の同時操作に制限されます。
  • 接続には容量制限があり、5,000,000 アイテムまたは 350 GB 以下のデータに制限されます。
  • externalItem エンティティの最大サイズは 4 MB です。

次の手順