Работа с Microsoft Teams при помощи API Microsoft Graph

Microsoft Teams — это рабочее пространство с чатами в Microsoft 365, обеспечивающее встроенный доступ к календарям команд, файлам, заметкам OneNote, планам Планировщика, расписаниям Смен и многому другому.

Основные ресурсы в Microsoft Teams

Ресурс Методы
team Перечисление ваших команд, перечисление всех команд, создание, чтение, обновление, удаление, клонирование, архивирование, распаковка
group Добавление участника, удаление участника, добавление владельца, удаление владельца, получение файлов, получение записной книжки, получение планов, получение календаря
channel Список, создание, чтение, обновление, удаление
teamsTab Список, создание, чтение, обновление, удаление
teamsApp Список, публикация, обновление, удаление
teamsAppInstallation Список, установка, обновление, удаление
chatMessage Список в канале, список в чате, отправка, чтение в канале, чтение в чате
call Ответ, отклонение, перенаправление, отключение звука, включение звука, изменение роли при демонстрации экрана, перечисление участников, приглашение участников
schedule Создание или замена, получение, предоставление общего доступа
schedulingGroup Создание, список, получение, замена, удаление
activityFeedNotification Отправить уведомление пользователю в области чата, Отправить уведомление пользователю в области команды, Отправить уведомление пользователю в персональной области
shift Создание, список, получение, замена, удаление
timeOff Создание, список, получение, замена, удаление
timeOffReason Создание, список, получение, замена, удаление

Ограничения Microsoft Teams

Протестированные ограничения производительности (мощности) Microsoft Teams описаны в статье Ограничения и спецификации для Microsoft Teams. Эти ограничения применяются при непосредственном использовании Microsoft Teams или с помощью API Microsoft Graph. Так как у каждой команды есть соответствующая группа, а каждая группа является объектом каталога, ограничение количества групп и количества объектов каталога ("ресурсов") может также оказывать влияние.

Файлы в каналах хранятся в SharePoint; при этом применяются ограничения SharePoint Online.

См. также Ограничения регулирования для служб Microsoft Teams.

Команды и группы

В Microsoft Graph приложение Microsoft Teams представлено ресурсом group. Команды Microsoft Teams и группы Microsoft 365 предназначены для различных требований совместной работы в группе. Почти всех групповые функции применимы к командам Microsoft Teams и группам Microsoft 365, например календарь группы, файлы, заметки, фотографии, планы и т. д. Основное различие между командой и группой Microsoft 365 состоит в режиме общения участников. Участники команды общаются в сохраняемом чате в контексте определенной команды. Участники группы Microsoft 365 общаются с помощью групповых бесед, то есть бесед по электронной почте, которые осуществляются в контексте группы в Outlook.

У любой группы, содержащей команду, есть свойство resourceProvisioningOptions со значением Team.

Примечание. Свойство Group.resourceProvisioningOptions можно изменить. Не добавляйте и не удаляйте значение Team из этой коллекции; в противном случае вы получите неправильные результаты при перечислении всех команд.

Ниже указаны различия на уровне API между командами и группами.

Примечание. Если вы используете интерфейсы API для групп в приложении Microsoft Teams, а не в отдельном приложении (например, для вкладки или бота в Microsoft Teams), следуйте инструкциям из статьи Использование Microsoft Graph на страницах Microsoft Teams.

Изменение состава участников в Microsoft Teams

Вариант использования Глагол URL-адрес
Добавление участника POST /teams/{team-id}/members
Удаление участника DELETE /teams/{team-id}/members/{membership-id}
Обновление роли участника PATCH /teams/{team-id}/members/{membership-id}
Обновление команды PATCH /teams/{team-id}

Требования к опросу

Если приложение опрашивает вас на предмет изменения ресурса, это можно делать раз в день. (teamsAsyncOperation является исключением из общего правила, так как опрашивается часто.) Если нужно узнавать об изменениях чаще, создайте подписку на этот ресурс и получайте уведомления об изменениях (веб-перехватчики). Если вы не нашли поддержку для нужного типа подписки, рекомендуем оставить свой отзыв на форуме идей платформы для разработчиков Microsoft 365.

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

При опросе для ресурса раз за разом выполняется операция GET, чтобы проверить, не изменился ли он. Операцию GET разрешается выполнять на одном и том же ресурсе несколько раз в день, пока не проводится опрос. Например, хорошо выполнять операцию GET на /me/joinedTeams каждый раз, когда пользователь посещает или обновляет вашу веб-страницу, но было бы неправильно выполнять GET на /me/joinedTeams в цикле каждые 30 секунд, чтобы обновлять эту веб-страницу.

Если приложения не удовлетворяют требованиям опроса, это будет рассматриваться как нарушение условий использования API Майкрософт. Такое нарушение может привести к дополнительному регулированию, а также приостановке или прекращению использования API Майкрософт.

Новые возможности

Узнайте о новых функциях и обновлениях для этого набора API.

См. также