Microsoft Graph コネクタ API を使用する
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Graph コネクタを使用して、外部サービスからのデータを Microsoft Graph に取り込むことができます。 Microsoft Graph コネクタ API を使用すると、外部データのインデックスを作成して、 Copilot や Microsoft Search などの Microsoft 365 のインテリジェント エクスペリエンスを強化できます。
インデックス データへの要求は、アプリケーションの アクセス許可を持つアクセス トークンを介してサインインユーザーが存在することなく、アプリケーションに代わって実行されます。
カスタム Microsoft Graph コネクタを構築する
カスタム Microsoft Graph コネクタを構築するには、次の 4 つの手順が必要です。
- Entra ID (旧称 Azure Active Directory) アプリの登録を作成します。 Microsoft Graph への要求と共に、アプリに必要なアプリ登録と API アクセス許可の名前を送信します。 Microsoft Graph は、新しく作成されたアプリの登録に関する情報で応答します。
- 外部接続を作成します。 各接続には、一意の ID、名前、および説明が必要です。
- 外部接続のスキーマを作成します。 スキーマは、この Microsoft Graph 接続を介して取り込む外部コンテンツの形状を定義します。 スキーマの作成は、実行時間の長い操作です。 接続を作成するためにスキーマを送信した後、Microsoft Graph は、操作の状態を確認するために使用できる URL で応答します。 操作の状態が である限り、スキーマは
inprogressプロビジョニングされています。 プロビジョニングが完了すると、操作によって状態が返completedされます。 - 外部コンテンツを取り込む。 外部アイテムごとに、ソース コンテンツ リポジトリから抽出し、外部接続のスキーマと一致するように変換し、外部アイテムとして Microsoft Graph に送信します。 項目と共に、アクセスを許可されたユーザーに関する情報 (アクセス制御リスト (ACL) とも呼ばれます) を含めます。
次に、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 です。
次の手順
- Microsoft Graph コネクタの概要を参照してください。
- リソースの externalConnection、schema、および externalItem リソースのメソッド、プロパティ、および関係をドリル ダウンします。
- Microsoft Graph postman コレクションを確認してください。
- サンプル検索コネクタを確認してください。