Type de ressource Teamteam resource type

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version.To determine whether an API is available in v1.0, use the Version selector.

Une équipe dans Microsoft Teams est une collection d’objets decanaux.A team in Microsoft Teams is a collection of channel objects. Un canal représente un sujet de discussion, et donc une isolation logique de la discussion, au sein d’une équipe.A channel represents a topic, and therefore a logical isolation of discussion, within a team.

Chaque équipe est associée à un groupe.Every team is associated with a group. Le groupe a le même ID que l’équipe : par exemple, /groups/{id}/team est identique à /teams/{id}.The group has the same ID as the team - for example, /groups/{id}/team is the same as /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.For more information about working with groups and members in teams, see Use the Microsoft Graph REST API to work with Microsoft Teams.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Créer une équipeCreate team teamsAsyncOperationteamsAsyncOperation Crée une équipe de A à Z.Create a team from scratch.
Créer une équipe à partir d’un groupeCreate team from group teamteam Crée une équipe ou ajoute une équipe à un groupe existant.Create a new team, or add a team to an existing group.
Récupérer l’équipeGet team teamteam Récupère les propriétés et les relations de l’équipe spécifié.Retrieve the properties and relationships of the specified team.
Mettre à jour une équipeUpdate team teamteam Met à jour les propriétés de l’équipe spécifiée.Update the properties of the specified team.
Supprimer l’équipeDelete team AucunNone Supprime l’équipe et le groupe associé.Delete the team and its associated group.
Liste des membresList members Collection conversationMemberconversationMember collection Obtenez la liste des membres de l’équipe.Get the list of members in the team.
Ajouter un membreAdd member conversationMemberconversationMember Ajoutez un nouveau membre à l’équipe.Add a new member to the team.
Ajouter des membres en blocAdd members in bulk Collection actionResultPartactionResultPart collection Ajoutez plusieurs membres à l’équipe dans une seule demande.Add multiple members to the team in a single request.
Obtenir un membreGet member Collection conversationMemberconversationMember collection Obtenez un membre de l’équipe.Get a member in the team.
Mettre à jour le rôle d’un membreUpdate member's role conversationMemberconversationMember Changer un membre en propriétaire ou revenir à un membre régulier.Change a member to an owner or back to a regular member.
Supprimer un membreRemove member AucuneNone Supprimez un membre existant de l’équipe.Remove an existing member from the team.
Archiver une équipeArchive team teamsAsyncOperationteamsAsyncOperation Met l’équipe en lecture seule.Put the team in a read-only state.
Annuler l’archivage d’une équipeUnarchive team teamsAsyncOperationteamsAsyncOperation Remet l’équipe en lecture/écriture.Restore the team to a read-write state.
Dupliquer une équipeClone team teamsAsyncOperationteamsAsyncOperation Copie l’équipe et le groupe associé.Copy the team and its associated group.
Lister vos équipesList your teams collection teamteam collection Liste les équipes dont vous êtes membre.List the teams you are a member of.
Obtenir une photo d’équipeGet team photo Données binairesBinary data Obtenez à jour la photo (image) d’une équipe.Get the photo (picture) for a team.
Complete-MigrationComplete migration teamteam Supprime le mode migration de l’équipe et rend les membres de l’équipe accessibles aux utilisateurs pour publier et lire les messages.Removes migration mode from the team and makes the team available to users to post and read messages.
Liste des applications installées dans l’équipeList apps installed in team Collection teamsAppInstallationteamsAppInstallation collection Liste des applications installées dans une équipe.List apps installed in a team.
Ajouter l’application à l’équipeAdd app to team AucuneNone Ajoutez (installez) une application dans une équipe.Add (install) an app to a team.
Obtenir l’application installée dans l’équipeGet app installed in team teamsAppInstallationteamsAppInstallation Obtenez l’application spécifiée installée dans une équipe.Get the specified app installed in a team.
Mettre à niveau l’application installée dans l’équipeUpgrade app installed in team AucuneNone Mettez à niveau l’application installée dans une équipe vers la dernière version.Upgrade the app installed in a team to the latest version.
Supprimer l’application de l’équipeRemove app from team AucuneNone Supprimez (désinstallez) une application d’une équipe.Remove (uninstall) an app from a team.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
displayNamedisplayName stringstring Nom de l’équipe.The name of the team.
descriptiondescription stringstring Description facultative de l’équipe.An optional description for the team.
classificationclassification stringstring Nom facultatif.An optional label. Décrit généralement la confidentialité des données ou des activités de l’équipe.Typically describes the data or business sensitivity of the team. Doit correspondre à l’un des jeux préconfigurés dans le répertoire du client.Must match one of a pre-configured set in the tenant's directory.
specializationspecialization teamSpecializationteamSpecialization Facultatif.Optional. Indique si l’équipe est destinée à une utilisation particulière.Indicates whether the team is intended for a particular use case. Chaque spécialisation de l’équipe a accès à des comportements et à des expériences propres à son utilisation.Each team specialization has access to unique behaviors and experiences targeted to its use case.
visibilityvisibility teamVisibilityTypeteamVisibilityType La visibilité du groupe et de l’équipe.The visibility of the group and team. La valeur par défaut est Public.Defaults to Public.
funSettingsfunSettings teamFunSettingsteamFunSettings Paramètres pour configurer l’utilisation de Giphy, des mèmes et des stickers dans l’équipe.Settings to configure use of Giphy, memes, and stickers in the team.
guestSettingsguestSettings teamGuestSettingsteamGuestSettings Paramètres pour indiquer si les invités peuvent créer, mettre à jour ou supprimer des canaux dans l’équipe.Settings to configure whether guests can create, update, or delete channels in the team.
internalIdinternalId stringstring ID unique de l’équipe utilisé à plusieurs emplacements, tels que le journal d’audit ou l’API Activité de gestion Office 365.A unique ID for the team that has been used in a few places such as the audit log/Office 365 Management Activity API.
isArchivedisArchived BooleanBoolean Indique si cette équipe est en mode lecture seule.Whether this team is in read-only mode.
memberSettingsmemberSettings teamMemberSettingsteamMemberSettings Paramètres pour indiquer si les membres peuvent effectuer certaines actions dans l’équipe. Par exemple, créer des canaux ou ajouter des bots.Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
messagingSettingsmessagingSettings teamMessagingSettingsteamMessagingSettings Paramètres pour configurer la messagerie et les mentions dans l’équipe.Settings to configure messaging and mentions in the team.
discoverySettingsdiscoverySettings teamDiscoverySettingsteamDiscoverySettings Paramètres de configuration de la détectabilité des équipes par d’autres personnes.Settings to configure team discoverability by others.
webUrlwebUrl string (readonly)string (readonly) Lien hypertexte permettant d’accéder à l’équipe dans le client Microsoft Teams.A hyperlink that will go to the team in the Microsoft Teams client. 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.This is the URL that you get when you right-click a team in the Microsoft Teams client and select Get link to team. Cette URL doit être traitée comme un objet blob opaque et ne doit pas être analysée.This URL should be treated as an opaque blob, and not parsed.
classSettingsclassSettings teamClassSettingsteamClassSettings Configurer les paramètres d’une classe.Configure settings of a class. Disponible uniquement lorsque l’équipe représente une classe.Available only when the team represents a class.
isMembershipLimitedToOwnersisMembershipLimitedToOwners BooléenBoolean 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.If set to true, the team is currently in the owner-only team membership state and not accessible by other team members, such as students.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Horodateur auquel le canal a été créé.Timestamp at which the team was created.

Attributs d’instanceInstance attributes

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.Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.

Nom de la propriétéProperty name TypeType DescriptionDescription
@microsoft.graph.teamCreationMode@microsoft.graph.teamCreationMode stringstring Indique que l’équipe est à l’état de la migration et est actuellement utilisé à des fins de migration.Indicates that the team is in migration state and is currently being used for migration purposes. Elle accepte une valeur : migration.It accepts one value: 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.Note: In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data imported.

Pour consulter un exemple de demande POST, voir Demande (Créer une équipe en état de migration).For a POST request example, see Request (create team in migration state).

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
channelschannels collection channelchannel collection Collection de canaux et de messages associés à l’équipe.The collection of channels & messages associated with the team.
installedAppsinstalledApps collection teamsAppInstallationteamsAppInstallation collection Applications installées dans cette équipe.The apps installed in this team.
membresmembers Collection conversationMemberconversationMember collection Les membres et les propriétaires de l'équipe.Members and owners of the team.
ownersowners useruser Liste des propriétaires de cette équipe.The list of this team's owners. Pour l’instant, quand vous créez une équipe à l’aide des autorisations d’application, un seul propriétaire doit être spécifié.Currently, when creating a team using application permissions, exactly one owner must be specified. 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).When using user delegated permissions, no owner can be specified (the current user is the owner). Le propriétaire doit être spécifié par un ID objet (GUID), et non par un nom d’utilisateur principal.Owner must be specified as an object ID (GUID), not a UPN.
operationsoperations Collection teamsAsyncOperationteamsAsyncOperation collection Opérations asynchrone ayant été exécutées ou en cours d’exécution sur cette équipe.The async operations that ran or are running on this team.
photophoto profilePhotoprofilePhoto La photo de l'équipe.The team photo.
primaryChannelprimaryChannel channelchannel Canal général de l’équipe.The general channel for the team.
planifierschedule planifierschedule La planification des changements pour cette équipe.The schedule of shifts for this team.
templatetemplate teamsTemplateteamsTemplate Modèle ayant servi à la création de cette équipe.The template this team was created from. VoirModèles disponibles.See available templates.

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.The following is a JSON representation of the resource.

Remarque : si l’équipe est de type classe, une propriété classSettings est appliquée à l’équipe.Note: If the team is of type class, a classSettings property is applied on the team.

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

Voir aussiSee also