Выбор API в Microsoft Graph для создания онлайн-встреч и подключения к ним
В Microsoft Graph предлагаются два набора API, которые позволяют упорядочить онлайн-встречи в Microsoft Teams или Skype или присоединиться к ним:
- API календаря: используйте ресурс события.
- API облачных коммуникаций: используйте ресурс onlineMeeting.
Вы выбираете между:
- Удобным запрограммированным средством для создания онлайн-встреч в календаре Outlook, где участники могут присоединяться к собранию и продолжать работу в Teams или в Skype.
- Более обширная программная интеграция функций Teams или Skype в приложении для более индивидуального взаимодействия.
Рекомендации по выбору API для вашего сценария
Выберите API календаря для оптимизированной встроенной интеграции с календарем Outlook, что позволит настроить собрание в календаре Outlook:
- Программная поддержка:
- Приложения могут непосредственно создавать и обновлять события в виде онлайн-встречи в календаре Outlook с помощью большого двоичного объекта join-Teams-meeting, добавляемого в событие календаря Outlook.
- Приложения получают свойства для присоединения к собраниям через Интернет или по телефону.
- Пользовательский интерфейс участников с программно созданным событием календаря полностью соответствует интерфейсу события, созданного в пользовательском интерфейсе Outlook:
- Участники сами выбирают, как встречаться: по сети или лично.
- Участники могут щелкнуть объект join-Teams-meeting, чтобы присоединяться к собранию через Интернет или по телефону.
- Участники могут использовать другие широкие возможности Teams, в том числе видеоконференции и "зал собрания", если они настроены.
Примечание.
Интеграция с календарем Outlook предполагает, что администратор настроил Outlook для собраний по сети. Перед тем как использовать API, проверяйте службу поддержки.
Выберите API облачных коммуникаций для получения более гибкой и программной поддержки:
- В приложениях больше возможностей, позволяющих интегрировать результаты API в соответствии с родом занятий и другими приложениями. API не привязан к конкретному календарю и не создает событие ни в одном календаре.
- Ниже описаны возможности, которые приложения могут предоставить участникам.
- Предоставление объединенной информации на основе языковой среды.
- Присоединение к собраниям через Интернет или по телефону.
- Видеоконференции.
- Дополнительные функции безопасности, такие как "зал собрания" и автоматизация допуска участников (предварительный просмотр).
- Привязка собрания к чату в Microsoft Teams.
Сравнение API
В таблице ниже описаны различия на уровне API.
| Возможность онлайн-встреч | API календаря (ресурс события) | API облачных коммуникаций (ресурс onlineMeeting) |
|---|---|---|
| Основные участники API | Ресурс события: Свойство - isOnlineMeeting Свойство - onlineMeeting типа onlineMeetingInfo Свойство - onlineMeetingProvider Ресурс календаря: Свойство - allowedOnlineMeetingProviders Свойство - defaultOnlineMeetingProvider |
Ресурс onlineMeeting Ресурс audioConferencing |
| Интеграция с элементом календаря | - API создания или обновлениясобытий автоматически задает результирующий календарь Outlook как собрание по сети. - Использование свойства isOnlineMeeting, onlineMeeting и onlineMeetingProvider возвращенного события календаря Outlook. |
-
Создание API возвращает ресурс onlineMeeting, который не зависит от конкретного типа календаря. - Не создает и не обновляет события Outlook. - Интеграция возвращенной информации ресурса onlineMeeting в приложении, которое подходит для вашего сценария. - Использование createOrGet для возврата онлайн-встречи с указанным значением externalId или его создание в случае отсутствия, чтобы упростить внедрение получившегося собрания в стороннем календаре. |
| Переход к автономному собранию | - Нет. Если вы подключите возможность подключения к встрече по сети, вы не сможете изменить его, чтобы сделать собрание автономным. - Невозможно изменить свойство onlineMeetingProvider или задать значение isOnlineMeeting, falseчтобы отключить собрание по сети. |
Нет. Если вы создаете ресурс onlineMeeting, вы можете удалить его, но не можете сделать так, чтобы оно стало автономным. |
| Предоставление объединенной информации на основе языковой среды | Интеграция прямого API не осуществляется. | - Использование Accept-Languageзаголовка HTTP при создании онлайн-встречи. - См. пример. |
| Соединение по сети (VoIP) | Через свойство onlineMeeting получите доступ к joinUrl. | Используйте свойство joinWebUrl. |
| Соединение по телефону | Через свойство onlineMeeting получите доступ к: - conferenceId, quickDial, phones, tollFreeNumbers, tollNumber. |
Через свойство audioConferencing получите доступ к: - conferenceId, tollFreeNumber, tollNumber. Свойство - dialinUrl для веб-страницы, доступной извне, с информацией о том, как подключиться по телефону для интеграции со сторонними приложениями. |
| Присоединение по видеоконференции (аудио и видео) | Интеграция прямого API не осуществляется. | Используйте свойство videoTeleconferenceId. |
| "Зал собраний" и автоматический доступ участников к онлайн-встречам | - Интеграция прямого API не осуществляется. - Во вставленном в событие объекте join-Teams-meeting участники могут выбрать Параметры собрания, чтобы получить доступ к "залу собраний", если такая функция включена администратором. |
- API, позволяющий отличать участников организации и федеративные компании, а также других участников, включая анонимных. — Используйте свойство lobbyBypassSettings . |
| Относится к чату в Teams | Интеграция прямого API не осуществляется. | Используйте свойство chatInfo. |