Работа с API облачных коммуникаций в Microsoft Graph

  • Статья

Важно!

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

API облачных коммуникаций в Microsoft Graph добавляет новое измерение для взаимодействия приложений и служб с пользователями путем использования основных возможностей общения в приложениях и службах. Этот API можно использовать для создания и приема звонков, создания и получения координат собраний, а также проверки присутствия пользователей.

API облачных коммуникаций можно использовать для создания служебных приложений (ботов), выполняющих роль участников в звонке, создающих собрания и получающих приглашения на них от имени пользователей, а также для проверки доступности пользователей и их действий. Этот API предоставляет функции звонков, а также возможность создавать собрания по сети и получать приглашения на них. С помощью этого API можно использовать служебные приложения (боты), при этом боты могут участвовать в звонках VoIP или собраниях Microsoft Teams.

Важно!

Вы не можете использовать API облачных коммуникаций для записи или сохранения иным образом содержимого мультимедиа из звонков или собраний, к которым обращается ваше приложение, или данных, полученных из этого мультимедийного содержимого. Убедитесь, что вы соблюдаете требования региональных законов и норм, связанных с защитой данных и конфиденциальности коммуникаций. Дополнительные сведения можно узнать из условий использования и обратившись за юридической помощью.

Авторизация

Для доступа к API облачных коммуникаций требуется одно из указанных ниже разрешений. Эти разрешения должны предоставляться администратором.

Сценарий Разрешения
Звонки 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
Записи звонков CallRecords.Read.All

Основные варианты использования

В таблице ниже перечислены некоторые распространенные варианты использования API облачных коммуникаций.

Варианты использования Ресурсы REST См. также
Создание приватных и групповых звонков, а также присоединение к ним Звонок Методы звонков
Звонки с интерактивным речевым взаимодействием Методы для интерактивного речевого взаимодействия
Элементы управления звонком (участник) Участник
Собрания onlineMeeting Методы для собраний
Присутствие presence Методы для присутствия
Получение записей звонков callRecord Подписки веб-перехватчиков

Общие свойства

Ресурс Свойства
call свойства объекта call
participant свойства объекта participant
onlineMeeting свойства объекта onlineMeeting
presence свойства объекта presence
callRecord Свойства callRecord

Связанные материалы