Тип ресурса team

Пространство имен: microsoft.graph

Команда в Microsoft Teams — это коллекция объектов channel. Канал представляет тему и логически обособляет обсуждение в команде.

Каждая команда связана с группой Microsoft 365. У группы такой же идентификатор, как у команды. Например, /groups/{id}/team совпадает с /teams/{id}. Дополнительные сведения о работе с группами и участниками в командах см. в статье Работа с Microsoft Teams при помощи REST API Microsoft Graph.

Методы

Метод Возвращаемый тип Описание
Создание команды teamsAsyncOperation Создание команды с нуля.
Создание команды из группы team Создание команды или добавление команды в существующую группу Microsoft 365.
Получение команды team Получение свойств и связей указанной команды.
Обновление команды team Обновление свойств указанной команды.
Удаление команды Нет Удаление команды и ее связанной группы.
Перечисление участников Коллекция conversationMember Получение списка участников группы.
Добавление участника conversationMember Добавление нового участника в группу.
Массовое добавление участников Коллекция actionResultPart Добавление нескольких участников в команду одним запросом.
Получение участника Коллекция conversationMember Получение участника группы.
Обновление роли участника conversationMember Перевод пользователя из категории участников в категорию владельцев или наоборот, из категории владельцев в категорию обычных участников.
Удаление участника Нет Удаление существующего участника из группы.
Архивация команды teamsAsyncOperation Перевод команды в состояние только для чтения.
Распаковка команды teamsAsyncOperation Восстановление команды в состояние чтения и записи.
Клонирование команды teamsAsyncOperation Копирование команды и ее связанной группы.
Перечисление ваших команд Коллекция team Перечисление команд, в которых вы являетесь участником.
Завершение миграции team Удаление режима миграции из команды, после чего команда становится доступной для публикации и чтения сообщений пользователями.
Перечисление приложений, установленных в команде Коллекция teamsAppInstallation Перечисление приложений, установленных в команде.
Добавление приложения в команду Нет Добавление (установка) приложения в команду.
Получение приложения, установленного в команде teamsAppInstallation Получение указанного приложения, установленного в команде.
Обновление приложения, установленного в команде Нет Обновление приложения, установленного в команде, до последней версии.
Удаление приложения из команды Нет Удаление приложения из команды.

Свойства

Свойство Тип Описание
displayName string Имя команды.
description string Необязательное описание для команды. Максимальная длина: 1024 символа.
classification string Необязательная метка. Обычно описывает конфиденциальность данных или работы команды. Должно соответствовать одному из предварительно настроенных наборов в каталоге клиента.
specialization teamSpecialization Необязательное свойство. Указывает, предназначена ли команда для определенного варианта использования. У каждой специализации команды есть доступ к уникальным действиям и возможностям, предназначенным для своего варианта использования.
visibility teamVisibilityType Видимость группы и команды. Значение по умолчанию — "общедоступно".
funSettings teamFunSettings Параметры для настройки использования Giphy, мемов и наклеек в команде.
guestSettings teamGuestSettings Параметры для настройки того, могут ли гости создавать, изменять или удалять каналы в команде.
internalId string Уникальный идентификатор для команды, используемый в нескольких местах, например в журнале аудита или API действий управления Office 365.
isArchived Boolean Находится ли команда в режиме только для чтения.
memberSettings teamMemberSettings Параметры для настройки того, могут ли участники выполнять определенные действия, например создавать каналы и добавлять ботов в команде.
messagingSettings teamMessagingSettings Параметры для настройки обмена сообщениями и упоминаний в команде.
webUrl string (только для чтения) Гиперссылка, ведущая к команде в клиенте Microsoft Teams. Это URL-адрес, получаемый при щелчке правой кнопкой мыши по команде в клиенте Microsoft Teams и выборе пункта Получить ссылку на команду. Этот URL-адрес должен обрабатываться как непрозрачный BLOB-объект и не должен анализироваться.
createdDateTime dateTimeOffset Метка времени создания команды.

Атрибуты экземпляра

Атрибуты экземпляра — это свойства с особым поведением. Эти свойства — временные и а) определяют поведение выполнения службы; или б) предоставляют краткосрочные значения свойств, например URL-адрес скачивания элемента, у которого истекает срок действия.

Имя свойства Тип Описание
@microsoft.graph.teamCreationMode Строка Указывает, что команда находится в состоянии миграции и в настоящее время используется для миграции. Принимает одно значение: migration. Примечание. В дальнейшем корпорация Майкрософт может потребовать у вас или ваших клиентов оплаты дополнительных сборов на основе количества импортированных данных.

Пример запроса POST см. в разделе Запрос (создание команды в состоянии миграции).

Связи

Связь Тип Описание
channels Коллекция channel Коллекция каналов и сообщений, связанных с командой.
installedApps teamsAppInstallation collection Приложения, установленные в команде.
members Коллекция conversationMember Участники и владельцы команды.
operations Коллекция teamsAsyncOperation Асинхронные операции, которые выполнялись или выполняются для этой команды.
primaryChannel channel Общий канал для команды.
schedule schedule Расписание смен для команды.
шаблон teamsTemplate Шаблон, из которого создана команда. См. доступные шаблоны.

Представление JSON

Ниже указано представление ресурса в формате JSON.

Примечание. Если команда относится к типу class, к ней применяется свойство classSettings.

{
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "createdDateTime": "dateTimeOffset"
}

См. также