Type de ressource Team
Espace de noms: microsoft.graph
Une équipe dans Microsoft Teams est une collection d’objets decanaux. Un canal représente un sujet de discussion, et donc une isolation logique de la discussion, au sein d’une équipe.
Chaque équipe est associée à un groupe Microsoft 365.
Le groupe a le même ID que l’équipe : par exemple, /groups/{id}/team est identique à /teams/{id}.
Pour en savoir plus sur l’utilisation des groupes et des membres dans les équipes, consultez l’article relatif à l’utilisation de Microsoft Teams via l’API REST Microsoft Graph.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Créer | teamsAsyncOperation | Crée une équipe de A à Z. |
| Créer une équipe à partir d’un groupe | team | Créez une équipe ou ajoutez une équipe à un groupe de Microsoft 365 existant. |
| Obtenir | team | Récupère les propriétés et les relations de l’équipe spécifié. |
| Mettre à jour | team | Met à jour les propriétés de l’équipe spécifiée. |
| Supprimer | Aucun | Supprime l’équipe et le groupe associé. |
| Liste des membres | Collection conversationMember | Obtenez la liste des membres de l’équipe. |
| Ajouter un membre | conversationMember | Ajoutez un nouveau membre à l’équipe. |
| Ajouter des membres en bloc | Collection actionResultPart | Ajoutez plusieurs membres à l’équipe dans une seule demande. |
| Obtenir un membre | Collection conversationMember | Obtenez un membre de l’équipe. |
| Obtenir le canal principal | channel | Canal général de l’équipe. |
| Mettre à jour un membre | conversationMember | Changer un membre en propriétaire ou revenir à un membre régulier. |
| Supprimer un membre | Aucune | Supprimez un membre existant de l’équipe. |
| Archiver une équipe | teamsAsyncOperation | Met l’équipe en lecture seule. |
| Annuler l’archivage d’une équipe | teamsAsyncOperation | Remet l’équipe en lecture/écriture. |
| Dupliquer une équipe | teamsAsyncOperation | Copie l’équipe et le groupe associé. |
| Lister vos équipes | collection team | Liste les équipes dont vous êtes membre. |
| Répertorier vos équipes associées | Collection associatedTeamInfo | Obtenez la liste des équipes dans Microsoft Teams auxquelles un utilisateur est associé. |
| Répertorier toutes les équipes d'une organisation | Collection team | Répertoriez toutes les équipes d'une organisation. |
| Terminer la migration pour l’équipe | team | Supprime le mode migration de l’équipe et rend les membres de l’équipe accessibles aux utilisateurs pour publier et lire les messages. |
| Répertorier tous les canaux | collection channel | Obtenez la liste des canaux de cette équipe ou partagés avec cette équipe (canaux entrants). |
| Répertorier les canaux | collection channel | Obtenir la liste des canaux dans une équipe. |
| Répertorier les canaux entrants | collection channel | Obtenir la liste des canaux entrants (canaux partagés avec une équipe). |
| Supprimer un canal entrant | Aucun | Supprimez un canal entrant ( canal partagé avec une équipe) d’une équipe. |
| Liste des applications dans équipe | Collection teamsAppInstallation | Liste des applications installées dans une équipe. |
| Ajouter l’application à l’équipe | Aucune | Ajoutez (installez) une application dans une équipe. |
| Obtenir l’application installée dans l’équipe | teamsAppInstallation | Obtenez l’application spécifiée installée dans une équipe. |
| Mettre à niveau l’application installée dans l’équipe | Aucune | Mettez à niveau l’application installée dans une équipe vers la dernière version. |
| Supprimer l’application de l’équipe | Aucune | Supprimez (désinstallez) une application d’une équipe. |
| Répertorier les octrois d’autorisations | Collection resourceSpecificPermissionGrant | Répertoriez les autorisations qui ont été accordées aux applications pour accéder à l’équipe. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| id | string | Identificateur unique de l’équipe. Le groupe a le même ID que l’équipe. Cette propriété est en lecture seule et est héritée du type d’entité de base. |
| classification | string | Nom facultatif. Décrit généralement la confidentialité des données ou des activités de l’équipe. Doit correspondre à l’un des jeux préconfigurés dans le répertoire du client. |
| classSettings | teamClassSettings | Configurer les paramètres d’une classe. Disponible uniquement lorsque l’équipe représente une classe. |
| createdDateTime | dateTimeOffset | Horodateur auquel le canal a été créé. |
| description | string | Description facultative de l’équipe. Longueur maximale : 1024 caractères. |
| displayName | string | Nom de l’équipe. |
| funSettings | teamFunSettings | Paramètres pour configurer l’utilisation de Giphy, des mèmes et des stickers dans l’équipe. |
| guestSettings | teamGuestSettings | Paramètres pour indiquer si les invités peuvent créer, mettre à jour ou supprimer des canaux dans l’équipe. |
| internalId | string | ID unique de l’équipe utilisé à plusieurs emplacements, tels que le journal d’audit ou l’API Activité de gestion Office 365. |
| isArchived | Boolean | Indique si cette équipe est en mode lecture seule. |
| memberSettings | teamMemberSettings | Paramètres pour indiquer si les membres peuvent effectuer certaines actions dans l’équipe. Par exemple, créer des canaux ou ajouter des bots. |
| messagingSettings | teamMessagingSettings | Paramètres pour configurer la messagerie et les mentions dans l’équipe. |
| specialization | teamSpecialization | Facultatif. Indique si l’équipe est destinée à une utilisation particulière. Chaque spécialisation de l’équipe a accès à des comportements et à des expériences propres à son utilisation. |
| résumé | teamSummary | Contient des informations sommaires sur l'équipe, notamment le nombre de propriétaires, de membres et d'invités. |
| tenantId | chaîne | ID du locataire Microsoft Entra. |
| visibility | teamVisibilityType | La visibilité du groupe et de l’équipe. La valeur par défaut est Public. |
| webUrl | string (readonly) | Lien hypertexte permettant d’accéder à l’équipe dans le client Microsoft Teams. Il s’agit de l’URL que vous obtenez quand vous cliquez sur une équipe dans le client Microsoft Teams et sélectionnez Récupérer le lien de l’équipe. Cette URL doit être traitée comme un objet blob opaque et ne doit pas être analysée. |
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.teamCreationMode | string | Indique que l’équipe est à l’état de la migration et est actuellement utilisé à des fins de migration. Elle accepte une valeur : migration.
Remarque : à l’avenir, Microsoft pourra exiger que vous ou vos clients payiez des frais supplémentaires en fonction du volume de données accessible via l’API. |
Pour consulter un exemple de demande POST, voir Demande (Créer une équipe en état de migration).
Relations
| Relation | Type | Description |
|---|---|---|
| allChannels | collection channel | Liste des canaux hébergés dans ou partagés avec l’équipe (canaux entrants). |
| channels | collection channel | La collection de canaux et de messages associés à l’équipe. |
| incomingChannels | collection channel | Liste des canaux partagés avec l’équipe. |
| installedApps | collection teamsAppInstallation | Applications installées dans cette équipe. |
| membres | Collection conversationMember | Les membres et les propriétaires de l'équipe. |
| opérations | Collection teamsAsyncOperation | Opérations asynchrone ayant été exécutées ou en cours d’exécution sur cette équipe. |
| photo | profilePhoto | Photo de profil de l’équipe. |
| primaryChannel | channel | Canal général de l’équipe. |
| planifier | planifier | La planification des changements pour cette équipe. |
| balises | Collection teamworkTag | Balises associées à l’équipe. |
| template | teamsTemplate | Modèle ayant servi à la création de cette équipe. VoirModèles disponibles. |
| permissionGrants | Collection resourceSpecificPermissionGrant | Collection d’autorisations accordées aux applications pour accéder à l’équipe. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
Remarque : si l’équipe est de type classe, une propriété classSettings est appliquée à l’équipe.
{
"classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
"classification": "String",
"createdDateTime": "DateTimeOffset",
"description": "String",
"displayName": "String",
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"internalId": "String",
"isArchived": "Boolean",
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"specialization": "String",
"tenantId": "String",
"visibility": "String",
"webUrl": "String (URL)"
}