teamworkTag resource type
Namespace: microsoft.graph
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a tag associated with a team.
Tags provide a flexible way for customers to classify users or groups based on a common attribute within a team. For example, a Nurse or Manager or Designer tag will enable users to reach groups of people in Teams without having to type every single name.
When a tag is added, users can @mention it in a channel. Everyone who has been assigned that tag receives a notification just as they would if they were @mentioned individually. Users can also use a tag is to start a new chat with the members of that tag.
Methods
Method | Return type | Description |
---|---|---|
List teamworkTags | teamworkTag collection | Get a list of the teamworkTag objects and their properties. |
Create teamworkTag | teamworkTag | Create a new teamworkTag object. |
Get teamworkTag | teamworkTag | Read the properties and relationships of a teamworkTag object. |
Update teamworkTag | teamworkTag | Update the properties of a teamworkTag object. |
Delete teamworkTag | None | Delete a teamworkTag object permanently. |
Properties
Property | Type | Description |
---|---|---|
description | String | Tag description as it appears to the user in Microsoft Teams. A teamworkTag can't have more than 200 teamworkTagMembers. |
displayName | String | Tag name as it appears to the user in Microsoft Teams. |
id | String | ID of the tag. |
memberCount | Int32 | The number of users assigned to the tag. |
tagType | teamworkTagType | The type of tag. Default is standard. |
teamId | String | ID of the team in which the tag is defined. |
teamworkTagType values
Member | Description |
---|---|
standard | Default type for a tag. Tags of type standard can be managed in the team by members who have permissions. |
unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
Relationships
Relationship | Type | Description |
---|---|---|
members | teamworkTagMember collection | Users assigned to the tag. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.teamworkTag",
"description": "String",
"displayName": "String",
"id": "String (identifier)",
"memberCount": "Int32",
"tagType": "String",
"teamId": "String"
}
Related content
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應