Тип ресурса teamworkTag

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

Важно!

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

Представляет тег, связанный с командой.

Теги предоставляют клиентам гибкий способ классификации пользователей или групп на основе общего атрибута в команде. Например, тег "Медсестра" или "Менеджер" или Designer позволяет пользователям обращаться к группам людей в Teams без необходимости вводить каждое имя.

При добавлении тега пользователи могут @mention использовать его в канале. Все, кому назначен этот тег, получают уведомление так же, как если бы они были @mentioned по отдельности. Пользователи также могут использовать тег , чтобы начать новый чат с участниками этого тега.

Методы

Метод Тип возвращаемых данных Описание
Вывод списка тегов командной работы коллекция teamworkTag Получите список объектов teamworkTag и их свойств.
Создание teamworkTag teamworkTag Создайте новый объект teamworkTag .
Получение teamworkTag teamworkTag Чтение свойств и связей объекта teamworkTag .
Обновление teamworkTag teamworkTag Обновление свойств объекта teamworkTag .
Удаление teamworkTag Нет Окончательное удаление объекта teamworkTag .

Свойства

Свойство Тип Описание
description String Описание тега, как оно отображается для пользователя в Microsoft Teams. TeamworkTag не может содержать более 200 teamworkTagMembers.
displayName String Имя тега, как оно отображается пользователю в Microsoft Teams.
id String Идентификатор тега.
memberCount Int32 Число пользователей, назначенных тегу.
tagType teamworkTagType Тип тега. Значение по умолчанию — стандартное.
teamId String Идентификатор команды, в которой определен тег.

значения teamworkTagType

Member Описание
стандарт Тип по умолчанию для тега. Теги типа Standard могут управляться в команде участниками, имеющими разрешения.
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.

Связи

Связь Тип Описание
members коллекция teamworkTagMember Пользователи, назначенные тегу.

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

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.teamworkTag",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "memberCount": "Int32",
  "tagType": "String",
  "teamId": "String"
}