Тип ресурса 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"
}
См. также
Обратная связь
Отправить и просмотреть отзыв по