Тип ресурса team

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

Важно!

API в версии /beta Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте выбор версии .

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

Свойства

Свойство Тип Описание
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 Параметры для настройки обмена сообщениями и упоминаний в команде.
discoverySettings teamDiscoverySettings Параметры для настройки возможности обнаружения команды другими пользователями.
webUrl string (только для чтения) Гиперссылка, ведущая к команде в клиенте Microsoft Teams. Это URL-адрес, получаемый при щелчке правой кнопкой мыши по команде в клиенте Microsoft Teams и выборе пункта Получить ссылку на команду. Этот URL-адрес должен обрабатываться как непрозрачный BLOB-объект и не должен анализироваться.
classSettings teamClassSettings Настройка параметров класса. Доступна только в том случае, если команда представляет класс.
isMembershipLimitedToOwners Boolean Если присвоено значение true, команда в настоящее время находится в состоянии участия только для владельцев команды и недоступна другим участникам, например учащимся.
createdDateTime dateTimeOffset Метка времени создания команды.
summary teamSummary Содержит сводную информацию о команде, включая количество владельцев, участников и гостей.
tenantId string Идентификатор клиента Azure Active Directory.

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

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

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

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

Связи

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

Представление 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"},
  "discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "displayName": "string",
  "description": "string",
  "classification": "string",
  "specialization": "string",
  "visibility": "string",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "isMembershipLimitedToOwners":"boolean",
  "createdDateTime": "dateTimeOffset",
  "summary":  {"@odata.type": "microsoft.graph.teamSummary"}
}

См. также