teamworkRessourcentyp für Sektion

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 einen Abschnitt in der Microsoft Teams-Chatliste eines Benutzers dar, der Chats, Kanäle und Besprechungen in benutzerdefinierten oder systemdefinierten Gruppen organisiert. Abschnitte können benutzerdefiniert sein, so dass Benutzer sie erstellen, umbenennen und löschen können, oder systemdefiniert, die vom Dienst verwaltet werden.

Methoden

Methode Rückgabetyp Beschreibung
List teamworkSection-Sammlung Rufen Sie die Liste der Abschnitte in der Teamarbeit eines Benutzers ab.
Create teamworkSection Erstellen eines neuen Abschnitts in der Teamarbeit eines Benutzers.
Get teamworkSection Lesen Sie die Eigenschaften eines Abschnitts in der Teamarbeit eines Benutzers.
Update teamworkSection Aktualisieren Sie die Eigenschaften eines Abschnitts in der Teamarbeit eines Benutzers.
Löschen Keine Löschen Sie einen benutzerdefinierten Abschnitt aus der Teamarbeit eines Benutzers.
Listenelemente teamworkSectionItem collection Rufen Sie die Liste der Elemente in einem Abschnitt der Teamarbeit eines Benutzers ab.

Eigenschaften

Eigenschaft Typ Beschreibung
createdDateTime DateTimeOffset Datum und Uhrzeit der Erstellung des Abschnitts. Schreibgeschützt. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Mitternacht UTC am 1. Januar 2024 ist 2024-01-01T00:00:00Zbeispielsweise.
displayIcon sectionDisplayIcon Das für den Abschnitt angezeigte Symbol.
displayName Zeichenfolge Der Anzeigename des Abschnitts. Erforderlich. Die maximale Länge beträgt 50 Zeichen. Bei Anzeigenamen wird zwischen Groß- und Kleinschreibung unterschieden, und sie müssen innerhalb der Abschnitte eines Benutzers eindeutig sein. Die folgenden Namen sind für systemseitig definierte Abschnitte reserviert und können beim Erstellen eines benutzerdefinierten Abschnitts nicht verwendet werden: RecentChats, QuickViews, TeamsAndChannels, MutedChatsMeetingChatsEngageCommunities, , .
id Zeichenfolge Der eindeutige Bezeichner für den Abschnitt. Schreibgeschützt.
isExpanded Boolean Gibt an, ob der Abschnitt in der Benutzeroberfläche erweitert ist. Der Standardwert ist true.
isHierarchicalViewEnabled Boolean Gibt an, ob die hierarchische Ansicht für den Abschnitt aktiviert ist. Schreibgeschützt.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung des Abschnitts. Schreibgeschützt. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Mitternacht UTC am 1. Januar 2024 ist 2024-01-01T00:00:00Zbeispielsweise.
sectionType sectionType Der Typ des Abschnitts. Die möglichen Werte sind: userDefined, systemDefined, unknownFutureValue. Schreibgeschützt.
sortType sectionSortType Die Sortierreihenfolge der Elemente im Abschnitt. Die gültigen Werte hängen vom sectionType ab. Mögliche Werte sind: mostRecent, unreadThenMostRecent, nameAlphabetical, userDefinedCustomOrder, unknownFutureValue.

sectionType-Werte

Member Beschreibung
userDefined Ein vom Benutzer erstellter Abschnitt, der umbenannt, neu angeordnet und gelöscht werden kann.
systemDefined Ein vom Dienst verwalteter Abschnitt, der nicht gelöscht werden kann. Nur die sortType-Eigenschaft kann aktualisiert werden.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Systemdefinierte Abschnitte

Systemdefinierte Abschnitte werden vom Dienst bereitgestellt und in der Abschnittsliste jedes Benutzers angezeigt. Ihre displayName-Werte sind reserviert und können nicht für benutzerdefinierte Abschnitte verwendet werden.

displayName Beschreibung
RecentChats Der Standard-Chatabschnitt.
Schnellansichten Der Abschnitt "Schnellansichten".
TeamsAndChannels Der Abschnitt Teams und Kanäle.
MutedChats Der Abschnitt "Stummgeschaltete Chats".
MeetingChats Der Abschnitt "Besprechungschats".
EngageCommunities Der Community-Bereich.

Vom System definierte Abschnitte können nicht gelöscht werden, und nur die sortType-Eigenschaft kann aktualisiert werden. Versuche, andere Eigenschaften zu aktualisieren oder einen vom System definierten Abschnitt return 403 Forbiddenzu löschen. Das Auflisten von Elementen in einem systemdefinierten Abschnitt durch Aufrufen von Listenelemente wird nicht unterstützt und gibt zurück 400 Bad Request. Wenn entweder List sections oder Get teamworkSection mit ?$expand=itemsaufgerufen wird, werden systemdefinierte Abschnitte mit einem leeren Elementarray zurückgegeben, da systemdefinierte Abschnittsinhalte nicht über die öffentliche Graph-API verfügbar gemacht werden.

sectionSortType-Werte

Member Beschreibung
mostRecent Elemente nach der letzten Aktivität sortieren. Gültig für benutzerdefinierte und die meisten systemdefinierten Abschnitte.
unreadThenMostRecent Sortieren Sie ungelesene Elemente zuerst und dann nach der letzten Aktivität. Gültig für benutzerdefinierte und die meisten systemdefinierten Abschnitte.
nameAlphabetical Sortieren Sie Elemente alphabetisch nach Namen. Gilt nur für bestimmte systemdefinierte Abschnitte, z. B. Teams und Kanäle. Gilt nicht für benutzerdefinierte Abschnitte.
userDefinedCustomOrder Sortieren Sie Elemente gemäß einer benutzerdefinierten benutzerdefinierten Reihenfolge. Nur gültig für benutzerdefinierte Abschnitte. Dies ist der Standardsortiertyp für neue benutzerdefinierte Abschnitte.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Hinweis

Die zulässigen Sortierarten für systemdefinierte Abschnitte hängen vom jeweiligen Abschnitt ab. Beispielsweise unterstützen nameAlphabeticaldie Abschnitte "Teams" und "Kanäle" "", aber die Abschnitte "RecentChats" und "MutedChats" unterstützen nur mostRecent und unreadThenMostRecent. Wenn die Eigenschaft "isHierarchicalViewEnabled" für einen Abschnitt "Teams und Kanäle" festgelegt true ist, ist nur nameAlphabetical sie gültig. Beim Festlegen eines nicht unterstützten Sortiertyps wird ein 400 Bad Request Fehler zurückgegeben.

Instanzenattribute

Instanzattribute sind Eigenschaften mit besonderem Verhalten. Diese Eigenschaften sind temporär und definieren entweder a) das Verhalten, das der Dienst ausführen soll, oder b) stellen kurzfristige Eigenschaftswerte bereit, z. B. eine Download-URL für ein Element, das abläuft.

Eigenschaftenname Typ Beschreibung
@microsoft.graph.sectionsOrder String collection Ein geordnetes Array von Abschnitts-IDs, die die bevorzugte Abschnittsreihenfolge des Benutzers darstellen.
@microsoft.graph.sectionsVersion Zeichenfolge Die aktuelle Version der Abschnittshierarchie. Verwenden Sie diesen Wert als Header für die If-Match optimistische Parallelitätssteuerung bei Mutationsvorgängen (Erstellen, Aktualisieren oder Löschen von Abschnitten sowie Hinzufügen, Entfernen oder Verschieben von Elementen).

Beziehungen

Beziehung Typ Beschreibung
items teamworkSectionItem collection Die Elemente (Chats, Kanäle, Besprechungen oder Communitys), die innerhalb des Abschnitts organisiert sind.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.teamworkSection",
  "createdDateTime": "String (timestamp)",
  "displayIcon": {"@odata.type": "microsoft.graph.sectionDisplayIcon"},
  "displayName": "String",
  "id": "String (identifier)",
  "isExpanded": "Boolean",
  "isHierarchicalViewEnabled": "Boolean",
  "lastModifiedDateTime": "String (timestamp)",
  "sectionType": "String",
  "sortType": "String"
}

Verwandte Inhalte

  • Last updated on