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

Свойства

Свойство Тип Описание
id string Уникальный идентификатор команды. У группы тот же идентификатор, что и у команды. Это свойство доступно только для чтения и наследуется от базового типа сущности.
classSettings teamClassSettings Настройка параметров класса. Доступна только в том случае, если команда представляет класс.
classification string Необязательная метка. Обычно описывает конфиденциальность данных или работы команды. Должно соответствовать одному из предварительно настроенных наборов в каталоге клиента.
createdDateTime dateTimeOffset Метка времени создания команды.
description string Необязательное описание для команды. Максимальная длина: 1024 символа.
discoverySettings teamDiscoverySettings Параметры для настройки возможности обнаружения команды другими пользователями.
displayName string Имя команды.
funSettings teamFunSettings Параметры для настройки использования Giphy, мемов и наклейки в команде.
guestSettings teamGuestSettings Параметры для настройки того, могут ли гости создавать, изменять или удалять каналы в команде.
internalId string Уникальный идентификатор команды, используемый в нескольких местах, таких как API действий по управлению журналом аудита или Office 365.
isArchived Boolean Находится ли команда в режиме только для чтения.
isMembershipLimitedToOwners Boolean Если задано значение true, команда в настоящее время находится в состоянии членства в команде только для владельцев и недоступна для других участников команды, таких как учащиеся.
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 Участники и владельцы команды.
owners user Список владельцев команды. В настоящее время при создании группы с использованием разрешений для приложения необходимо указать только одного владельца. При использовании делегированных пользователем разрешений невозможно указать владельца (текущий пользователь является владельцем). Владелец должен быть указан в качестве идентификатора объекта (GUID), а не имени участника-пользователя.
operations Коллекция teamsAsyncOperation Асинхронные операции, которые выполнялись или выполняются для этой команды.
photo; profilePhoto Фотография команды
primaryChannel channel Общий канал для команды.
schedule schedule Расписание смен для команды.
шаблон teamsTemplate Шаблон, из которого создана команда. См. доступные шаблоны.
templateDefinition teamtemplatedefinition Универсальное представление определения шаблона команды для команды с определенной структурой и конфигурацией.
permissionGrants Коллекция resourceSpecificPermissionGrant Коллекция разрешений, предоставленных приложениям для доступа к команде.
tags Коллекция teamworkTag Теги, связанные с командой.

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

В представлении JSON отображается тип ресурса.

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

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

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