Microsoft Search API を使用してデータのインデックスを作成する

重要

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

Microsoft Graph を使用すると、Microsoft Search エクスペリエンスの検索結果にカスタム アイテムを追加できます。

データのインデックスを作成する要求は、サインインしているユーザーの存在なしにアプリケーションの代わりに実行されます。このユーザーはアプリケーションのアクセス許可を持つアクセス トークンを使用して識別されます。

一般的なユース ケース

このセクションの API のユース ケースには、Microsoft Graph コネクタの構築が含まれています。これに含まれる主な手順は次のとおりです。

1. 外部データ ソースへの接続を作成する。
2. 外部データの種類とインデックスの作成方法を記述するスキーマを作成して登録する。
3. 外部アイテムとしてデータのインデックスを作成する。

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

既知の制限

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

• 組織の最大接続数は 10 接続に制限されています。
• 1 秒あたりに作成できる externalItem リソース アイテムは、4 つまでです。
• アプリケーションが 1 つの接続で同時に実行できる操作は 4 操作に制限されます。
• 接続には容量制限があり、700,000 アイテムまたは 70 GB 以下のデータに制限されます。
• externalItem エンティティの最大サイズは 4 MB です。
• 結果の並べ替えは、サポートされていません。

新機能

この API セットに関する 最新機能や更新プログラム を検索してください。

次の手順

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