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. |
| Supprimer des membres en bloc | Collection actionResultPart | Supprimez plusieurs membres d’une équipe dans une seule requête. |
| 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 | Répertoriez 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épertorier les autorisations 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 ensembles préconfigurés dans l’annuaire du locataire. |
| 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 : 1 024 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 pour l’équipe qui a été utilisé à quelques endroits tels que l’API activité de gestion du journal d’audit/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 qui accède à l’équipe dans le client Microsoft Teams. Vous obtenez cette URL lorsque vous cliquez avec le bouton droit sur une équipe dans le client Microsoft Teams et sélectionnez Obtenir le lien vers 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 temporaires. Ils définissent le comportement que le service doit effectuer ou fournissent des valeurs de propriété à court terme, telles qu’une URL de téléchargement pour un élément qui expire.
| 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 peut exiger que vous ou vos clients payiez des frais supplémentaires en fonction de la quantité de données importées. |
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)"
}