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

  • Статья

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

Создание пользовательского соединителя 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

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

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

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

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