Выбор 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.