Partager via


Ajouter un membre à une équipe

Espace de noms: microsoft.graph

Ajoutez un nouveau membre de conversation à une équipe.

Remarque

  • La propriété roles est vide par défaut pour tous les membres. Cette propriété contient uniquement des qualificateurs supplémentaires le cas échéant ; par exemple, si le membre dispose owner de privilèges, la propriété roles contient owner comme l’une des valeurs. De même, si le membre est un invité, la propriété rôles contient guest comme l’une des valeurs. Un membre de base ne doit pas avoir de valeurs spécifiées dans la propriété roles .
  • Après avoir ajouté un nouveau membre de conversation à une équipe, la réflexion de l’ajout peut prendre un certain temps. Les utilisateurs peuvent utiliser les notifications de modification pour s’abonner aux notifications relatives aux modifications d’appartenance dans une équipe particulière.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) TeamMember.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application TeamMember.ReadWrite.All Non disponible.

Remarque

L'utilisation des autorisations de l'application pour ajouter des membres invités à une équipe n'est pas prise en charge.

Requête HTTP

POST /teams/{team-id}/members

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet membre de conversation.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 201 Created et un objet conversationMember dans le corps de la réponse.

Pour de meilleurs résultats, échelonnez les appels avec une mémoire tampon de 2 secondes.

Remarque

Le code 404 Not Found de réponse est retourné lorsque vous tentez d’ajouter un utilisateur désactivé/bloqué.

Exemples

Exemple 1 : ajouter un membre à une équipe

Demande

POST https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"],
    "user@odata.bind": "https://graph.microsoft.com/v1.0/users('8b081ef6-4792-4def-b2c9-c363a1bf41d5')"
}

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
    "roles": [
        "owner"
    ],
    "userId": "50dffbae-ad0f-428e-a86f-f53b0acfc641",
    "displayName": "Cameron White",
    "email": "CameronW@contoso.com"
}

Exemple 2 : ajouter un membre à une équipe à l'aide du nom d'utilisateur principal

Demande

POST https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"],
    "user@odata.bind": "https://graph.microsoft.com/v1.0/users('jacob@contoso.com')"
}

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
    "roles": [
        "owner"
    ],
    "userId": "50dffbae-ad0f-428e-a86f-f53b0acfc641",
    "displayName": "Jacob Hancock",
    "email": "jacob@contoso.com"
}