teamworkTag 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示与团队关联的标记。

标记为客户提供了一种灵活的方法来根据团队中的通用属性对用户或组进行分类。 例如，“护士”或“经理”或“Designer”标记将使用户能够访问 Teams 中的一组人员，而无需键入每个名称。

添加标记后，用户可以 @mention 在频道中使用它。 已分配该标记的每个人都会收到通知，就像单独 @mentioned 接收通知一样。 用户还可以使用 标记 is 开始与该标记的成员的新聊天。

方法

方法	返回类型	说明
列出 teamworkTags	teamworkTag 集合	获取 teamworkTag 对象及其属性的列表。
创建 teamworkTag	teamworkTag	创建新的 teamworkTag 对象。
获取 teamworkTag	teamworkTag	读取 teamworkTag 对象的属性和关系。
更新 teamworkTag	teamworkTag	更新 teamworkTag 对象的属性。
删除 teamworkTag	无	永久删除 teamworkTag 对象。

属性

属性	类型	说明
说明	String	在 Microsoft Teams 中向用户显示的标记说明。 teamworkTag 不能超过 200 个 teamworkTagMembers。
displayName	String	在 Microsoft Teams 中向用户显示的标记名称。
id	String	标记的 ID。
memberCount	Int32	分配给标记的用户数。
tagType	teamworkTagType	标记的类型。 默认值为标准。
teamId	String	在其中定义标记的团队的 ID。

teamworkTagType 值

成员	说明
标准	标记的默认类型。 标准类型的标记可由具有权限的成员在团队中管理。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。

关系

关系	类型	说明
成员	teamworkTagMember 集合	分配给标记的用户。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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

相关内容

• teamworkTagMember