Поделиться через


Работа с API соединителей Microsoft Graph

Соединители Microsoft Graph добавляют внешние данные в Microsoft Graph и улучшают интеллектуальные возможности Microsoft 365. Для интеграции со службами, которые недоступны в роли соединителей, созданных корпорацией Майкрософт, необходимо создать настраиваемый соединитель. Для создания настраиваемых соединителей вы используете REST API соединителей Microsoft Graph. Элементы, которые поглощаются через подключения, созданные с помощью API, потребляют квоту элементов. Дополнительные сведения о том, как определить, сколько у вас есть квоты на элементы и приобретение дополнительной квоты, см. в разделе Требования к лицензированию и цены.

Изображение внешних данных, исходящих из разных соединителей Microsoft Graph

Используйте API Microsoft Graph, чтобы выполнять следующие задачи:

  1. Создание подключений к внешним данным и управление ими.
  2. Определите и зарегистрируйте схему внешних типов данных.
  3. Запись элементов внешних данных в Microsoft Graph.
  4. Синхронизация внешних групп.

Создание подключений к внешним данным и управление ими

Ресурс externalConnection (API внешнего подключения) — это логический контейнер для внешних данных, которым вы можете управлять как единым блоком.

Дополнительные сведения см. в статье Создание, обновление и удаление подключений в Microsoft Graph.

Определение и регистрация схем внешних типов данных

Подключение schema (API схемы) определяет, как содержимое используется в различных возможностях Microsoft 365. Схема представляет собой простой список всех свойств, которые вы планируете добавить в соединение, вместе с их атрибутами, метками и псевдонимами. Перед добавлением элементов в Microsoft Graph вы должны зарегистрировать схему.

Дополнительные сведения см. в разделе Регистрация и обновление схемы для подключения Microsoft Graph.

Запись элементов внешних данных в Microsoft Graph

Элементы, добавленные приложением в службу "Поиск (Майкрософт)", представлены ресурсом externalItem (API внешнего элемента) в Microsoft Graph.

Дополнительные сведения см. в статье Создание, обновление и удаление элементов, добавленных приложением с помощью соединителей Microsoft Graph.

Синхронизация внешних групп

Элементы во внешней службе могут быть предоставлены или запрещены через ACL для различных типов групп, не Microsoft Entra. Например, элементы Salesforce могут иметь наборы разрешений и профили, а элементы ServiceNow могут иметь локальные группы. При записи этих элементов в Microsoft Graph необходимо соблюдать эти ACL.

Вы можете использовать API внешней группы для установки разрешений для внешних элементов, загружаемых в Microsoft Graph. ExternalGroup представляет конструкцию, не Microsoft Entra группу или группу, и определяет разрешения на содержимое во внешнем источнике данных.

Дополнительные сведения см. в статье Использование внешних групп для управления разрешениями на источники данных соединителей Microsoft Graph.

Следующее действие