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

Использование API соединителей Microsoft Graph

  • Статья

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

Запросы на индексирование данных выполняются от имени приложения без присутствия пользователя, выполнившего вход, через маркер доступа с разрешением приложения.

Создание пользовательского соединителя Microsoft Graph

Создание пользовательского соединителя Microsoft Graph состоит из четырех этапов:

  1. Создайте регистрацию приложения с идентификатором Entra (ранее — Azure Active Directory). Вместе с запросом в Microsoft Graph вы отправляете имя регистрации приложения и разрешения API, необходимые приложению. Microsoft Graph отправляет сведения о регистрации созданного приложения.
  2. Создайте внешнее подключение. Для каждого подключения требуется уникальный идентификатор, имя и описание.
  3. Создайте схему для внешнего подключения. Схема определяет форму внешнего содержимого, которое вы будете принимать через это подключение Microsoft Graph. Создание схемы — это длительная операция. После отправки схемы для создания подключения Microsoft Graph возвращает URL-адрес, который можно использовать для проверка состояния операции. Схема подготавливается при условии, что состояние операции — inprogress. После завершения подготовки операция вернет completed состояние.
  4. Прием внешнего содержимого. Для каждого внешнего элемента извлеките его из исходного репозитория содержимого, преобразуйте его так, чтобы он соответствовал схеме для внешнего подключения, и отправьте его в Microsoft Graph в качестве внешнего элемента. Наряду с элементом, включите сведения о том, кому разрешен доступ к нему, также известный как список управления доступом (ACL).

Ниже приведена схема последовательностей, на которую иллюстрируются четыре этапа создания соединителя Microsoft Graph.

Схема, на которую показаны четыре этапа создания соединителя Microsoft Graph

Основные варианты использования

В следующей таблице перечислены распространенные варианты использования API соединителей Microsoft Graph.

Варианты использования Ресурсы REST См. также
Действия для настройки
Создание, обновление или удаление подключения externalConnection Методы externalConnection
Регистрация схемы для внешних данных schema Методы schema
Действия для индексирования
Добавление, обновление или удаление пользовательского элемента индекса externalItem Методы externalItem

Известные ограничения

Далее представлены текущие известные ограничения:

  • Организациям разрешено не более 30 подключений. (Если требуется больше подключений, заполните форму запроса.)
  • Вы можете создавать до 25 externalItem элементов ресурсов в секунду.
  • Приложение ограничено 25 одновременными операциями при подключении.
  • Максимальная емкость соединений составляет 5 000 000 элементов или ~350 ГБ данных.
  • Максимальный размер объекта externalItem составляет 4 МБ.

Дальнейшие действия