Créer des équipes et gérer des membres à l’aide de l’API Microsoft Teams

  • Article

Vous pouvez utiliser l’API Microsoft Teams dans Microsoft Graph pour créer des équipes de plusieurs manières. Cet article décrit l’approche que nous recommandons pour optimiser les résultats.

Créer une équipe

Toutes les équipes sont soutenues par les groupes Microsoft 365. Le moyen le plus rapide de rendre votre équipe opérationnelle lorsque vous créez des équipes via Microsoft Graph consiste à configurer un nouveau groupe Microsoft 365, tous les propriétaires et les membres, et à le convertir en équipe.

  1. Créez un groupe Microsoft 365 à l’aide de l’opération de création de groupe. Vous pouvez spécifier des propriétaires et des membres. Vérifiez que vous disposez des propriétaires appropriés pour le groupe nouvellement créé, comme décrit à l’étape 2.

    Pour créer une équipe pour ce groupe, vous devez définir les valeurs des propriétés suivantes, comme illustrées :

    • groupTypes = { "Unified" }
    • mailEnabled = true
    • securityEnabled = false
    POST /groups
{
    "displayName":"Flight 157",
    "mailNickname":"flight157",
    "description":"Everything about flight 157",
    "visibility":"Private",
    "groupTypes":["Unified"],
    "mailEnabled":true,
    "securityEnabled":false,
    "members@odata.bind":[
        "https://graph.microsoft.com/v1.0/users/bec05f3d-a818-4b58-8c2e-2b4e74b0246d",
        "https://graph.microsoft.com/v1.0/users/ae67a4f4-2308-4522-9021-9f402ff0fba8",
        "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783",
        "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133"
    ],
    "owners@odata.bind":[
        "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133",
        "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783"
    ]
}

    L’exemple suivant illustre la réponse.

    Remarque : l’objet de réponse affiché peut être raccourci pour plus de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.

    HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups/$entity",
    "id":"b7f968af-ca51-42f6-a77e-82c7147bc8f2"
}

  2. Assurez-vous que le groupe a plusieurs propriétaires. Pour ce faire, vous pouvez utiliser l’opération Ajouter un propriétaire. Il s’agit de comptes d’utilisateur réels, et non de comptes de service. La présence de deux propriétaires permet de gérer les cas où un propriétaire quitte l’entreprise ou n’est pas disponible pour effectuer des opérations de gestion d’équipe.

  3. Ajoutez tous les membres (et invités si nécessaire) au groupe à l’aide de l’opération Ajouter un membre, si vous ne l’avez pas fait à l’étape 1. Si vous ajoutez plusieurs membres, ajoutez un délai d'1 seconde après chaque opération d’ajout.

  4. Une fois le groupe créé, ce qui peut prendre jusqu’à 15 minutes après l’étape 1, créez une équipe Microsoft Teams à l’aide de l’opération Créer une équipe à partir d’un groupe. Si vous rencontrez une erreur, il est possible que le processus de création de groupes ne soit pas terminé ; patientez quelques minutes.

    POST https://graph.microsoft.com/v1.0/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
  "group@odata.bind": "https://graph.microsoft.com/v1.0/groups('groupId')"
}

    L’exemple suivant illustre la réponse.

    Remarque : l’objet de réponse affiché peut être raccourci pour plus de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.

    HTTP/1.1 202 Accepted
Content-Type: application/json
Location: /teams/{teamId}/operations/{operationId}
Content-Location: /teams/{teamId}
{
}

    L’équipe créée a le même ID de groupe.

  5. Une fois ce processus terminé, tous les propriétaires et membres devraient pouvoir voir l'équipe nouvellement créée dans leur client Teams.

Ajouter ou gérer des membres

Pour ajouter des membres après qu’une équipe ait été créée, vous devez utiliser l’opération Ajouter un membre. Nous vous recommandons d’ajouter un délai d'1 seconde entre les opérations d’ajout. Notez les informations suivantes relatives aux modifications d’adhésion :

  1. Les modifications d'adhésion apportées aux groupes Microsoft 365 sont synchronisées avec Teams via un mécanisme de synchronisation en arrière-plan qui prend généralement 24 heures (voire plus dans certains cas).

  2. Le processus d’arrière-plan est déclenché uniquement si un ou plusieurs utilisateurs de l’équipe (propriétaire ou membre) sont actifs dans le client de bureau Teams. Le lancement de l'application Teams et/ou son exécution constituent une activité : un utilisateur n'a pas besoin de visiter l'équipe en cours de modification spécifique.

    Remarque

    Les clients mobiles Teams ne déclenchent pas la synchronisation des membres. Au moins un utilisateur doit se trouver sur le client de bureau pour garantir que ce processus en arrière-plan se déroule correctement.

Liste de contrôle pour la validation

Une fois que vous avez créé une équipe, vous pouvez utiliser la liste de contrôle suivante pour vérifier que l’équipe a été créée correctement.

Valider la création d’équipe

  1. Vérifiez que le groupe Microsoft 365 qui soutient l’équipe est créé via les centres d’administration Microsoft Entra ID ou Microsoft 365.

  2. Vérifiez que la création de l’équipe a réussi via le portail d’administration Teams.

  3. Vérifiez que les propriétaires et membres appropriés sont répertoriés via le portail d’administration Teams de l’équipe.

  4. Vérifiez que les propriétaires d’équipe peuvent voir l’équipe une fois que vous êtes connecté au bureau Teams ou au client web.

  5. Vérifiez que les membres peuvent voir l’équipe une fois que vous êtes connecté au bureau Teams ou au client web.

Valider l’ajout de membres

  1. Vérifiez que les nouveaux membres s’affichent dans le groupe via le Microsoft Entra ID ou Centre d'administration Microsoft 365.

  2. Vérifiez que les membres nouvellement ajoutés peuvent voir l’équipe une fois que vous êtes connecté au bureau Teams ou au client web.

Contenu connexe