Microsoft Graph コネクタ API と連携する

Microsoft Graph コネクタは、外部データを Microsoft Graph に取り込み、Microsoft 365 のインテリジェントなエクスペリエンスを向上させます。 Microsoft が構築したコネクタを利用できないサービスと統合するカスタム コネクタを構築したい場合もあります。 カスタム コネクタを構築するには、Microsoft Graph コネクタ REST API を使用します。 API で構築された接続を介して取り込まれたアイテムは、アイテム クォータを消費します。 持っているアイテム クォータの量と追加のクォータの購入方法の詳細については、「 ライセンス要件と価格」を参照してください。

Microsoft Graph API の使用で次のことを実行できます:

1. 外部データ接続の作成と管理。
2. 外部データ型のスキーマの定義と登録。
3. Microsoft Graph への外部データ アイテムの取り込み。
4. 外部グループとの同期。

外部データ接続の作成と管理

externalConnection リソース (外部接続API) は、外部データを1つの単位として管理するための論理的なコンテナです。

詳細については、「Microsoft Graph で接続を作成、更新、削除する」を参照してください。

外部データ型のスキーマの定義と登録

接続 スキーマ (スキーマ API) は、Microsoft 365 のさまざまなエクスペリエンスでお客様のコンテンツがどのように使用されるかを決定します。 スキーマは、属性、ラベル、エイリアスと共に、接続に追加する予定のすべてのプロパティのフラットな一覧です。 Microsoft Graph にアイテムを取り込む前に、スキーマを登録する必要があります。

詳細については、「Microsoft Graph 接続のスキーマの登録と更新」を参照してください。

Microsoft Graph への外部データ アイテムの取り込み

アプリケーションが Microsoft Search サービスに追加したアイテムは、Microsoft Graph の externalItem リソース (外部アイテムAPI) で表現されます。

詳細については、「Microsoft Graph コネクタからアプリケーションで追加されたアイテムを作成、更新、削除する」を参照してください。

外部グループとの同期

外部サービス内の項目は、ACL を使用してさまざまな種類の非Microsoft Entra グループへのアクセスを許可または拒否できます。 たとえば、Salesforce アイテムにはアクセス許可セットとプロファイルがあり、ServiceNow アイテムにはローカル グループが含まれる場合があります。 これらのアイテムを Microsoft Graph に取り込む場合は、これらの ACL を優先する必要があります。

外部グループ API を使用して、Microsoft Graph に取り込まれる外部アイテムにアクセス許可を設定できます。 externalGroup は、Microsoft Entra以外のグループまたはグループに似たコンストラクト (部署、チームなど) を表し、外部データ ソース内のコンテンツに対するアクセス許可を決定します。

詳細については、「外部グループを使用して、Microsoft Graph コネクタ データ ソースへのアクセス許可を管理する」を参照してください。

次の手順