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

Microsoft Graph コネクタは、外部データを Microsoft Graph に取り込み、Microsoft 365 のインテリジェントなエクスペリエンスを向上させます。 Microsoft が構築したコネクタを利用できないサービスと統合するカスタム コネクタを構築したい場合もあります。 カスタム コネクタを構築するには、Microsoft Graph コネクタ REST API を使用します。

Microsoft Graph ではない種類のコネクタから送られてくる外部データを示す画像

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 コネクタからアプリケーションで追加されたアイテムを作成、更新、削除する」を参照してください。

外部グループとの同期

外部サービス内のアイテムでは、違う種類の Azure Active Directory 以外のグループによるアクセスを ACL 経由で許可または拒否することができます。 たとえば、Salesforce アイテムにはアクセス許可セットとプロファイルがあり、ServiceNow アイテムにはローカル グループが含まれる場合があります。 これらのアイテムを Microsoft Graph に取り込む場合は、これらの ACL を優先する必要があります。

外部グループ API を使用して、Microsoft Graph に取り込まれる外部アイテムにアクセス許可を設定できます。 externalGroup とは、Azure Active Directory 以外のグループまたはグループのような構成 (ビジネス単位、チームなど) のことで、外部データ ソース内のコンテンツのアクセス許可を決定できます。

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

次の手順