teamworkTag-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt ein Tag dar, das einem Team zugeordnet ist.

Tags bieten Kunden eine flexible Möglichkeit, Benutzer oder Gruppen basierend auf einem gemeinsamen Attribut innerhalb eines Teams zu klassifizieren. Beispielsweise ermöglicht eine Krankenschwester oder ein Vorgesetzter oder Designer Tag Benutzern, Gruppen von Personen in Teams zu erreichen, ohne jeden einzelnen Namen eingeben zu müssen.

Wenn ein Tag hinzugefügt wird, können @mention Benutzer es in einem Kanal verwenden. Jeder, dem dieses Tag zugewiesen wurde, erhält eine Benachrichtigung, wie er es einzeln wäre @mentioned . Benutzer können auch ein Tag verwenden, um einen neuen Chat mit den Mitgliedern dieses Tags zu starten.

Methoden

Methode Rückgabetyp Beschreibung
TeamworkTags auflisten teamworkTag-Sammlung Rufen Sie eine Liste der teamworkTag-Objekte und deren Eigenschaften ab.
Erstellen von teamworkTag teamworkTag Erstellen Sie ein neues teamworkTag-Objekt .
Teamarbeit abrufenTag teamworkTag Liest die Eigenschaften und Beziehungen eines teamworkTag-Objekts .
TeamworkTag aktualisieren teamworkTag Aktualisieren sie die Eigenschaften eines teamworkTag-Objekts .
TeamworkTag löschen Keine Löschen Sie ein teamworkTag-Objekt dauerhaft.

Eigenschaften

Eigenschaft Typ Beschreibung
description Zeichenfolge Markieren Sie die Beschreibung so, wie sie dem Benutzer in Microsoft Teams angezeigt wird. Ein teamworkTag darf nicht mehr als 200 teamworkTagMembers haben.
displayName Zeichenfolge Tagname, wie er dem Benutzer in Microsoft Teams angezeigt wird.
id Zeichenfolge ID des Tags.
memberCount Int32 Die Anzahl der Benutzer, die dem Tag zugewiesen sind.
tagType teamworkTagType Der Tagtyp. Der Standardwert ist Standard.
teamId Zeichenfolge ID des Teams, in dem das Tag definiert ist.

teamworkTagType-Werte

Member Beschreibung
standard Standardtyp für ein Tag. Tags vom Typ Standard können im Team von Mitgliedern verwaltet werden, die über Berechtigungen verfügen.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Beziehung Typ Beschreibung
Elemente teamworkTagMember-Sammlung Benutzer, die dem Tag zugewiesen sind.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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