Type de ressource Team

Espace de noms: microsoft.graph

Important

Les API sous la /beta version de 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 de 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 une équipe 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.
Récupérer l’équipe team Récupère les propriétés et les relations de l’équipe spécifié.
Mettre à jour une équipe team Met à jour les propriétés de l’équipe spécifiée.
Supprimer l’équipe 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.
Mettre à jour le rôle d’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 les é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.
Complete-Migration 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.
Liste des applications installées dans l’é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
displayName string Nom de l’équipe.
description string Description facultative de l’équipe. Longueur maximale : 1024 caractères.
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.
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.
visibility teamVisibilityType Visibilité du groupe et de l’équipe. Prend la valeur par défaut Public.
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.
discoverySettings teamDiscoverySettings Paramètres de configuration de la détectabilité des équipes par d’autres personnes.
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.
classSettings teamClassSettings Configurer les paramètres d’une classe. Disponible uniquement lorsque l’équipe représente une classe.
isMembershipLimitedToOwners Booléen Si la valeur est true, l’équipe est actuellement dans l’état d’appartenance au propriétaire uniquement et n’est pas accessible par d’autres membres de l’équipe, tels que des étudiants.
createdDateTime dateTimeOffset Horodateur auquel le canal a été créé.
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 client Azure Active Directory.

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.
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é. Quand vous utilisez les autorisations déléguées d’un utilisateur, aucun propriétaire ne peut être spécifié (l’utilisateur actuel est le propriétaire). Le propriétaire doit être spécifié par un ID objet (GUID), et non par un nom d’utilisateur principal.
operations 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 à partir duquel cette équipe a été créée. Consultez modèles disponibles.
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

Voici une représentation JSON de la ressource.

Remarque : si l’équipe est de type classe, une propriété classSettings est appliquée à l’équipe.

{
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "displayName": "string",
  "description": "string",
  "classification": "string",
  "specialization": "string",
  "visibility": "string",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "isMembershipLimitedToOwners":"boolean",
  "createdDateTime": "dateTimeOffset",
  "summary":  {"@odata.type": "microsoft.graph.teamSummary"}
}

Voir aussi