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

  • Статья

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

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

Варианты использования Ресурсы REST См. также
Создание команд, групп и каналов и управление ими команда, канал, группа создание команды, перечисление команд, создание канала
Добавление вкладок, управление и установка приложений в каталоге приложений Microsoft Teams teamsTab, teamsAppInstallation создание teamsTab, перечисление teamsTab, список приложений
Создание каналов и чатов для отправки и получения сообщений чата channel, chat, chatMessage создание канала, перечисление канала, отправка chatMessage
Использование тегов для классификации пользователей или групп на основе общих атрибутов в команде teamworkTag, teamworkTagMember list teamworkTag, create teamworkTag
Создание и прием звонков, запись звонков или получение координат собраний call, callRecords ответить, пригласить участников
Подключение ботов к вызовам и реализация интерактивного голосового ответа (IVR) Сценарии IVR
Создание и получение собраний по сети или проверка присутствия и активности пользователей onlineMeetings, присутствие создание onlineMeetings, meetingAttendanceReport
Создание интеграции сотрудников и управление ими с помощью смен, расписаний, карточек времени или отгулов в организации workforceIntegration, schedule, shift, timeOff, timeOffReason create workforceIntegration, create schedule, create shift, create timeOff
Используйте API обучения сотрудников для интеграции с Viva Learning обучение сотрудников, обучениеProvider, обучениеContent list learningProviders, list learningContents

Ограничения 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 между командами и группами.

Изменение состава участников в 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 Майкрософт.

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