Type de ressource Team
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 .
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 objets associatedTeamInfo 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. |
| Obtenir une photo d’équipe | Données binaires | Obtenez à jour la photo (image) d’une équipe. |
| 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 | Obtenez la liste des 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. |
| Obtenir des équipes ouvertes dans toutes les équipes jointes | collection openShift | Obtenir tous les objets openShift dans toutes les équipes dont un utilisateur est membre direct. |
| Obtenir des shifts dans toutes les équipes jointes | shift, collection | Obtenir tous les objets shift dans toutes les équipes dont un utilisateur est un membre direct. |
| Obtenir des congés pour toutes les équipes jointes | collection timeOff | Obtenir tous les objets timeOff dans toutes les équipes dont un utilisateur est un membre direct. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| classSettings | teamClassSettings | Configurer les paramètres d’une classe. Disponible uniquement lorsque l’équipe représente une classe. |
| 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. |
| createdDateTime | dateTimeOffset | Horodateur auquel le canal a été créé. |
| description | string | Description facultative de l’équipe. Longueur maximale : 1 024 caractères. |
| discoverySettings | teamDiscoverySettings | Paramètres de configuration de la détectabilité des équipes par d’autres personnes. |
| displayName | string | Nom de l’équipe. |
| firstChannelName | String | Nom du premier canal de l’équipe. Cette propriété est utilisée uniquement lors de la création de l’équipe et n’est pas retournée dans les méthodes pour obtenir et répertorier les équipes. |
| funSettings | teamFunSettings | Paramètres permettant de configurer l’utilisation de Giphy, de mèmes et d’autocollants 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. |
| 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. |
| internalId | string | ID unique pour l’équipe 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. |
| isMembershipLimitedToOwners | Booléen | Si la valeur est , l’équipe est actuellement dans l’état d’appartenance à truel’équipe propriétaire uniquement et inaccessible par les autres membres de l’équipe, tels que les étudiants. |
| 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 récapitulatives 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. Il s’agit de l’URL que vous obtenez 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 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 dans un état de migration et qu’elle est actuellement utilisée à 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. |
| owners | user | Liste des propriétaires de cette équipe. Pour l’instant, quand vous créez une équipe à l’aide des autorisations d’application, un seul propriétaire doit être spécifié. Lorsque vous utilisez des autorisations déléguées par l’utilisateur, aucun propriétaire ne peut être spécifié (l’utilisateur actuel est le propriétaire). Le propriétaire doit être spécifié en tant qu’ID d’objet (GUID), et non en tant qu’UPN. |
| opérations | Collection teamsAsyncOperation | Opérations asynchrone ayant été exécutées ou en cours d’exécution sur cette équipe. |
| photo | profilePhoto | La photo de l'équipe. |
| primaryChannel | channel | Canal général de l’équipe. |
| planifier | planifier | La planification des changements pour cette équipe. |
| template | teamsTemplate | Modèle ayant servi à la création de cette équipe. VoirModèles disponibles. |
| templateDefinition | teamtemplatedefinition | Représentation générique d’une définition de modèle d’équipe pour une équipe avec une structure et une configuration spécifiques. |
| permissionGrants | Collection resourceSpecificPermissionGrant | Collection d’autorisations accordées aux applications pour accéder à l’équipe. |
| balises | Collection teamworkTag | Balises associées à 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",
"discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
"displayName": "String",
"firstChannelName": "String",
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"id": "String (identifier)",
"internalId": "String",
"isArchived": "Boolean",
"isMembershipLimitedToOwners": "Boolean",
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"specialization": "String",
"summary": {"@odata.type": "microsoft.graph.teamSummary"},
"tenantId": "String",
"visibility": "String",
"webUrl": "String (URL)"
}