Использование API соединителей Microsoft Graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Соединители Microsoft Graph можно использовать для переноса данных из внешних служб в Microsoft Graph. API соединителей Microsoft Graph позволяет индексировать внешние данные, чтобы обеспечить интеллектуальные возможности в Microsoft 365, такие как Copilot и Поиск (Майкрософт).
Запросы на индексирование данных выполняются от имени приложения без присутствия пользователя, выполнившего вход, через маркер доступа с разрешением приложения.
Создание пользовательского соединителя Microsoft Graph
Создание пользовательского соединителя Microsoft Graph состоит из четырех этапов:
- Создайте регистрацию приложения с идентификатором Entra (ранее — Azure Active Directory). Вместе с запросом в Microsoft Graph вы отправляете имя регистрации приложения и разрешения API, необходимые приложению. Microsoft Graph отправляет сведения о регистрации созданного приложения.
- Создайте внешнее подключение. Для каждого подключения требуется уникальный идентификатор, имя и описание.
- Создайте схему для внешнего подключения. Схема определяет форму внешнего содержимого, которое вы будете принимать через это подключение Microsoft Graph. Создание схемы — это длительная операция. После отправки схемы для создания подключения Microsoft Graph возвращает URL-адрес, который можно использовать для проверки состояния операции. Схема подготавливается при условии, что состояние операции —
inprogress. После завершения подготовки операция вернетcompletedсостояние. - Прием внешнего содержимого. Для каждого внешнего элемента извлеките его из исходного репозитория содержимого, преобразуйте его так, чтобы он соответствовал схеме для внешнего подключения, и отправьте его в Microsoft Graph в качестве внешнего элемента. Наряду с элементом, включите сведения о том, кому разрешен доступ к нему, также известный как список управления доступом (ACL).
Ниже приведена схема последовательностей, на которую иллюстрируются четыре этапа создания соединителя Microsoft Graph.
Основные варианты использования
В следующей таблице перечислены распространенные варианты использования API соединителей Microsoft Graph.
| Варианты использования | Ресурсы REST | См. также |
|---|---|---|
| Действия для настройки | ||
| Создание, обновление или удаление подключения | externalConnection | Методы externalConnection |
| Регистрация схемы для внешних данных | schema | Методы schema |
| Действия для индексирования | ||
| Добавление, обновление или удаление пользовательского элемента индекса | externalItem | Методы externalItem |
Известные ограничения
Далее представлены текущие известные ограничения:
- Организациям доступно до 10 подключений. (Если требуется больше подключений, заполните форму запроса.)
- В секунду можно создавать до 25 элементов ресурсов externalItem .
- Приложение ограничено 25 одновременными операциями при подключении.
- Максимальная емкость соединений составляет 5 000 000 элементов или ~350 ГБ данных.
- Максимальный размер сущности externalItem составляет 4 МБ.
Дальнейшие действия
- См. обзор соединителей Microsoft Graph.
- Разверните методы, свойства и отношения ресурсов externalConnection, схемы и externalItem.
- Ознакомьтесь с коллекцией postman Microsoft Graph.
- Ознакомьтесь с примером соединителя поиска.