Тип ресурса 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 | Перевод пользователя из категории участников в категорию владельцев или наоборот, из категории владельцев в категорию обычных участников. |
| Удаление участника | Нет | Удаление существующего участника из группы. |
| Массовое удаление элементов | Коллекция actionResultPart | Удаление нескольких участников из команды в одном запросе. |
| Архивация команды | teamsAsyncOperation | Перевод команды в состояние только для чтения. |
| Распаковка команды | teamsAsyncOperation | Восстановление команды в состояние чтения и записи. |
| Клонирование команды | teamsAsyncOperation | Копирование команды и ее связанной группы. |
| Перечисление ваших команд | Коллекция team | Перечисление команд, в которые вы являетесь членом. |
| Вывод списка связанных команд | коллекция associatedTeamInfo | Получите список объектов associatedTeamInfo в Microsoft Teams, с которыми связан пользователь. |
| Перечисление всех команд в организации | Коллекция team | Перечисление всех команд в организации. |
| Получение фотографии команды | Двоичные данные | Вы можете получить фотографию (изображение) для команды. |
| Завершение миграции для команды | team | Удаление режима миграции из команды, после чего команда становится доступной для публикации и чтения сообщений пользователями. |
| Перечисление всех каналов | Коллекция channel | Получить список каналов в этой команде или общих с этойкомандой (входящие каналы). |
| Перечисление каналов | Коллекция channel | Получение списка каналов в команде. |
| Перечисление входящих каналов | Коллекция channel | Получение списка каналов, к которым предоставлен общий доступ этой команде. |
| Удаление входящего канала | Нет | Удаление входящего канала (канал с общим доступом длякоманды) из команды. |
| Список приложений в команде | Коллекция teamsAppInstallation | Перечисление приложений, установленных в команде. |
| Добавление приложения в команду | Нет | Добавление (установка) приложения в команду. |
| Получение приложения, установленного в команде | teamsAppInstallation | Получение указанного приложения, установленного в команде. |
| Обновление приложения, установленного в команде | Нет | Обновление приложения, установленного в команде, до последней версии. |
| Удаление приложения из команды | Нет | Удаление приложения из команды. |
| Перечисление предоставленных разрешений | Коллекция resourceSpecificPermissionGrant | Список разрешений, предоставленных приложениям для доступа к команде. |
| Получение открытых смен во всех присоединенных командах | Коллекция openShift | Получение всех объектов openShift во всех командах, в которые входит пользователь. |
| Получение смен во всех объединенных командах | Коллекция shift | Получение всех объектов shift во всех командах, в которые входит пользователь. |
| Получите время отгула для всех присоединенных команд | Коллекция timeOff | Получение всех объектов timeOff во всех командах, в которые непосредственно входит пользователь. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| classSettings | teamClassSettings | Настройка параметров класса. Доступна только в том случае, если команда представляет класс. |
| classification | string | Необязательная метка. Обычно описывает конфиденциальность данных или работы команды. Должно соответствовать одному из предварительно настроенных наборов в каталоге клиента. |
| createdDateTime | dateTimeOffset | Метка времени создания команды. |
| description | string | Необязательное описание для команды. Максимальная длина: 1024 символа. |
| discoverySettings | teamDiscoverySettings | Параметры для настройки возможности обнаружения команды другими пользователями. |
| displayName | string | Имя команды. |
| funSettings | teamFunSettings | Параметры для настройки использования Giphy, мемов и наклейки в команде. |
| guestSettings | teamGuestSettings | Параметры для настройки того, могут ли гости создавать, изменять или удалять каналы в команде. |
| id | string | Уникальный идентификатор команды. У группы тот же идентификатор, что и у команды. Это свойство доступно только для чтения и наследуется от базового типа сущности. |
| 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"},
"id": "String (identifier)",
"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)"
}