Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 systemdefinierte Gruppen organisiert. Abschnitte können benutzerdefinierter Sein, sodass Benutzer sie erstellen, umbenennen und löschen können, oder vom System definiert, 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 Sie einen neuen Abschnitt 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 eines benutzerdefinierten Abschnitts aus der Teamarbeit eines Benutzers. |
| Listenelemente | teamworkSectionItem-Sammlung | Ruft 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 ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2024 lautet 2024-01-01T00:00:00Zbeispielsweise . |
| displayIcon | sectionDisplayIcon | Das symbol, das für den Abschnitt angezeigt wird. |
| displayName | Zeichenfolge | Der Anzeigename des Abschnitts. Erforderlich. Die maximale Länge beträgt 50 Zeichen. Bei Anzeigenamen muss die Groß-/Kleinschreibung beachtet werden und innerhalb der Abschnitte eines Benutzers eindeutig sein. Die folgenden Namen sind für systemdefinierte Abschnitte reserviert und können beim Erstellen eines benutzerdefinierten Abschnitts nicht verwendet werden: RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, EngageCommunities. |
| id | Zeichenfolge | Der eindeutige Bezeichner für den Abschnitt. Schreibgeschützt. |
| Isexpanded | Boolean | Gibt an, ob der Abschnitt in der Benutzeroberfläche erweitert wird. 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 ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2024 lautet 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 | Wert des Sentinelwerts für die vervolvbare Enumeration. 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 |
|---|---|
| Aktuelle Chats | Der Standardchatabschnitt. |
| Schnellansichten | Der Abschnitt Schnellansichten. |
| TeamsAndChannels | Der Abschnitt "Teams und Kanäle". |
| MutedChats | Der Abschnitt "Stummgeschaltete Chats". |
| MeetingChats | Der Abschnitt Besprechungschats. |
| EngagementCommunities | Der Abschnitt "Communitys". |
Systemdefinierte Abschnitte können nicht gelöscht werden, und nur die sortType-Eigenschaft kann aktualisiert werden. Versuche, andere Eigenschaften zu aktualisieren oder einen systemdefinierten Abschnitt zu löschen, geben zurück 403 Forbidden. Das Auflisten von Elementen in einem systemdefiniertem Abschnitt wird nicht unterstützt und gibt zurück 400 Bad Request.
sectionSortType-Werte
| Member | Beschreibung |
|---|---|
| mostRecent | Sortieren Sie Elemente nach der letzten Aktivität. Gültig für benutzerdefinierte und die meisten systemdefinierte Abschnitte. |
| unreadThenMostRecent | Sortieren Sie ungelesene Elemente zuerst, dann nach der letzten Aktivität. Gültig für benutzerdefinierte und die meisten systemdefinierte Abschnitte. |
| nameAlphabetical | Sortieren Sie Elemente alphabetisch nach Namen. Gilt nur für bestimmte systemdefinierte Abschnitte, z. B. Teams und Kanäle. Ungültig für benutzerdefinierte Abschnitte. |
| userDefinedCustomOrder | Sortieren Sie Elemente nach einer benutzerdefinierten Benutzerdefinierten Reihenfolge. Gilt nur für benutzerdefinierte Abschnitte. Dies ist der Standardsortierungstyp für neue benutzerdefinierte Abschnitte. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
Hinweis
Die gültigen Sortiertypen 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 Teams- und Channels-Abschnitt auf true festgelegt ist, ist nur nameAlphabetical gültig. Das Festlegen eines nicht unterstützten Sortiertyps gibt einen 400 Bad Request Fehler zurück.
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 sortiertes 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 Steuerung der optimistischen Parallelität bei Mutationsvorgängen (Erstellen, Aktualisieren oder Löschen von Abschnitten und Hinzufügen, Entfernen oder Verschieben von Elementen). |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| items | teamworkSectionItem-Sammlung | 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"
}