Тип ресурса 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 Получение участника группы.
Получение основного канала channel Общий канал для команды.
Обновление роли участника conversationMember Перевод пользователя из категории участников в категорию владельцев или наоборот, из категории владельцев в категорию обычных участников.
Удаление участника Нет Удаление существующего участника из группы.
Архивация команды teamsAsyncOperation Перевод команды в состояние только для чтения.
Распаковка команды teamsAsyncOperation Восстановление команды в состояние чтения и записи.
Клонирование команды teamsAsyncOperation Копирование команды и ее связанной группы.
Перечисление ваших команд Коллекция team Перечисление команд, в которых вы являетесь участником.
Перечисление связанных команд коллекция associatedTeamInfo Получите список команд в Microsoft Teams, с которыми связан пользователь.
Перечисление всех команд в организации Коллекция team Перечисление всех команд в организации.
Завершение миграции team Удаление режима миграции из команды, после чего команда становится доступной для публикации и чтения сообщений пользователями.
Перечисление всех каналов Коллекция channel Получить список каналов в этой команде или общих с этойкомандой (входящие каналы).
Перечисление каналов Коллекция channel Получение списка каналов в команде.
Перечисление входящих каналов Коллекция channel Получить список входящих каналов (каналы, к которым был открыт общий доступ длякоманды).
Удаление входящего канала Нет Удаление входящего канала (канал с общим доступом длякоманды) из команды.
Перечисление приложений, установленных в команде Коллекция teamsAppInstallation Перечисление приложений, установленных в команде.
Добавление приложения в команду Нет Добавление (установка) приложения в команду.
Получение приложения, установленного в команде teamsAppInstallation Получение указанного приложения, установленного в команде.
Обновление приложения, установленного в команде Нет Обновление приложения, установленного в команде, до последней версии.
Удаление приложения из команды Нет Удаление приложения из команды.
Перечисление предоставленных разрешений Коллекция resourceSpecificPermissionGrant Список разрешений, предоставленных приложениям для доступа к команде.

Свойства

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

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

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

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

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

Связи

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

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

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

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

{
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "classification": "String",
  "createdDateTime": "DateTimeOffset",
  "description": "String",
  "displayName": "String",
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "internalId": "String",
  "isArchived": "Boolean",
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "specialization": "String",
  "tenantId": "String",
  "visibility": "String",
  "webUrl": "String (URL)"
}

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