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