Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente une section de la liste de conversations Microsoft Teams d’un utilisateur qui organise les conversations, les canaux et les réunions en groupes personnalisés ou définis par le système. Les sections peuvent être définies par l’utilisateur, ce qui permet aux utilisateurs de les créer, de les renommer et de les supprimer, ou définies par le système, qui sont gérées par le service.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | collection teamworkSection | Obtenez la liste des sections du travail d’équipe d’un utilisateur. |
| Create | teamworkSection | Créez une section dans le travail d’équipe d’un utilisateur. |
| Obtenir | teamworkSection | Lire les propriétés d’une section dans le travail d’équipe d’un utilisateur. |
| Mettre à jour | teamworkSection | Mettez à jour les propriétés d’une section dans le travail d’équipe d’un utilisateur. |
| Supprimer | Aucun | Supprimer une section définie par l’utilisateur du travail d’équipe d’un utilisateur. |
| Éléments de liste | collection teamworkSectionItem | Obtenez la liste des éléments d’une section du travail d’équipe d’un utilisateur. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | Date et heure de création de la section. En lecture seule. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2024 est 2024-01-01T00:00:00Z. |
| displayIcon | sectionDisplayIcon | Icône affichée pour la section. |
| displayName | String | Nom complet de la section. Obligatoire. La longueur maximale est de 50 caractères. Les noms d’affichage respectent la casse et doivent être uniques dans les sections d’un utilisateur. Les noms suivants sont réservés aux sections définies par le système et ne peuvent pas être utilisés lors de la création d’une section définie par l’utilisateur : RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, EngageCommunities. |
| id | String | Identificateur unique de la section. En lecture seule. |
| isExpanded | Booléen | Indique si la section est développée dans l’interface utilisateur. La valeur par défaut est true. |
| isHierarchicalViewEnabled | Booléen | Indique si la vue hiérarchique est activée pour la section. En lecture seule. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification de la section. En lecture seule. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2024 est 2024-01-01T00:00:00Z. |
| sectionType | sectionType | Type de la section. Les valeurs possibles sont userDefined, systemDefined, unknownFutureValue. En lecture seule. |
| sortType | sectionSortType | Ordre de tri des éléments de la section. Les valeurs valides dépendent du sectionType. Les valeurs possibles sont : mostRecent, unreadThenMostRecent, nameAlphabetical, userDefinedCustomOrder, unknownFutureValue. |
valeurs sectionType
| Member | Description |
|---|---|
| userDefined | Section créée par l’utilisateur qui peut être renommée, réorganisé et supprimée. |
| systemDefined | Section gérée par le service qui ne peut pas être supprimée. Seule la propriété sortType peut être mise à jour. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
Sections définies par le système
Les sections définies par le système sont approvisionnées par le service et apparaissent dans la liste des sections de chaque utilisateur. Leurs valeurs displayName sont réservées et ne peuvent pas être utilisées pour les sections définies par l’utilisateur.
| displayName | Description |
|---|---|
| RecentChats | Section conversations par défaut. |
| QuickViews | Section Affichages rapides. |
| TeamsAndChannels | Section équipes et canaux. |
| MutedChats | Section conversations en sourdine. |
| MeetingChats | Section conversations de réunion. |
| EngageCommunités | La section des communautés. |
Les sections définies par le système ne peuvent pas être supprimées et seule la propriété sortType peut être mise à jour. Les tentatives de mise à jour d’autres propriétés ou de suppression d’une section définie par le système retournent 403 Forbidden. La liste des éléments d’une section définie par le système n’est pas prise en charge et retourne 400 Bad Request.
valeurs sectionSortType
| Member | Description |
|---|---|
| mostRecent | Triez les éléments par activité la plus récente. Valide pour les sections définies par l’utilisateur et la plupart des sections définies par le système. |
| unreadThenMostRecent | Triez d’abord les éléments non lus, puis par activité la plus récente. Valide pour les sections définies par l’utilisateur et la plupart des sections définies par le système. |
| nameAlphabetical | Triez les éléments par ordre alphabétique par nom. Valide uniquement pour des sections spécifiques définies par le système, telles que Teams et Channels. Non valide pour les sections définies par l’utilisateur. |
| userDefinedCustomOrder | Triez les éléments selon un ordre personnalisé défini par l’utilisateur. Valide uniquement pour les sections définies par l’utilisateur. Il s’agit du type de tri par défaut pour les nouvelles sections définies par l’utilisateur. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
Remarque
Les types de tri valides pour les sections définies par le système dépendent de la section spécifique. Par exemple, les sections Teams et Channels prennent en charge nameAlphabetical, mais les sections RecentChats et MutedChats prennent uniquement mostRecent en charge et unreadThenMostRecent. Lorsque la propriété isHierarchicalViewEnabled est définie sur true pour une section Teams et Channels , seule nameAlphabetical est valide. La définition d’un type de tri non pris en charge renvoie une 400 Bad Request erreur.
Attributs d’instance
Les attributs d’instance sont des propriétés avec des comportements spéciaux. Ces propriétés sont provisoires et, a) définissent le comportement que le service doit adopter, ou b) fournissent des valeurs à court terme, comme une URL de téléchargement pour un élément qui arrive à expiration.
| Nom de la propriété | Type | Description |
|---|---|---|
| @microsoft.graph.sectionsOrder | String collection | Tableau ordonné d’ID de section qui représentent l’ordre de section préféré de l’utilisateur. |
| @microsoft.graph.sectionsVersion | String | Version actuelle de la hiérarchie de section. Utilisez cette valeur comme en-tête pour le If-Match contrôle d’accès concurrentiel optimiste sur les opérations de mutation (créer, mettre à jour ou supprimer des sections et ajouter, supprimer ou déplacer des éléments). |
Relations
| Relation | Type | Description |
|---|---|---|
| éléments | collection teamworkSectionItem | Éléments (conversations, canaux, réunions ou communautés) organisés dans la section. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@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"
}