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)"
}