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

Microsoft Graph コネクタを使用して、外部サービスからのデータを Microsoft Graph に取り込むことができます。 Microsoft Graph コネクタ API を使用すると、外部データのインデックスを作成して、Copilot や Microsoft 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 コネクタ API の一般的なユース ケースを示します。

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

既知の制限

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

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

次の手順

• 「Microsoft Search API の概要」を参照してください。
• リソースの externalConnection、schema、および externalItem リソースのメソッド、プロパティ、および関係をドリル ダウンします。
• Microsoft Graph Postman コレクションをご確認ください (詳細情報)
• GitHub でサンプルの検索コネクタについて調べます。