Работа с API облачных коммуникаций в Microsoft Graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
API облачных коммуникаций в Microsoft Graph добавляет новое измерение для взаимодействия приложений и служб с пользователями путем использования основных возможностей общения в приложениях и службах. Этот API можно использовать для создания и приема звонков, создания и получения координат собраний, а также проверки присутствия пользователей.
API облачных коммуникаций можно использовать для создания служебных приложений (ботов), выполняющих роль участников в звонке, создающих собрания и получающих приглашения на них от имени пользователей, а также для проверки доступности пользователей и их действий. Этот API предоставляет функции звонков, а также возможность создавать собрания по сети и получать приглашения на них. С помощью этого API можно использовать служебные приложения (боты), при этом боты могут участвовать в звонках VoIP или собраниях Microsoft Teams.
Важно!
Вы не можете использовать API облачных коммуникаций для записи или сохранения иным образом содержимого мультимедиа из звонков или собраний, к которым обращается ваше приложение, или данных, полученных из этого мультимедийного содержимого. Убедитесь, что вы соблюдаете требования региональных законов и норм, связанных с защитой данных и конфиденциальности коммуникаций. Дополнительные сведения можно узнать из условий использования и обратившись за юридической помощью.
Авторизация
Для доступа к API облачных коммуникаций требуется одно из указанных ниже разрешений. Эти разрешения должны предоставляться администратором.
| Сценарий | Разрешения |
|---|---|
| Записи звонков | CallRecords.Read.All |
| Звонки | Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All |
| Собрания | OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All |
| Присутствие | Presence.Read, Presence.Read.All |
| Виртуальное событие | VirtualEvent.Read, VirtualEvent.ReadWrite |
Основные варианты использования
В таблице ниже перечислены некоторые распространенные варианты использования API облачных коммуникаций.
| Варианты использования | Ресурсы REST | См. также |
|---|---|---|
| Создание приватных и групповых звонков, а также присоединение к ним | call | Методы звонков |
| Звонки с интерактивным речевым взаимодействием | call | Методы для интерактивного речевого взаимодействия |
| Элементы управления звонком (участник) | participant | |
| Собрания | onlineMeeting | Методы для собраний |
| Присутствие | presence | Методы для присутствия |
| Получение записей звонков | callRecord | Подписки веб-перехватчиков |
| Виртуальные события | virtualEvent | Методы для virtualEventTownhall, методы для virtualEventWebinar |
Общие свойства
| Ресурс | Свойства |
|---|---|
| call | свойства объекта call |
| participant | свойства объекта participant |
| onlineMeeting | свойства объекта onlineMeeting |
| presence | свойства объекта presence |
| callRecord | Свойства callRecord |