Utiliser l’API Microsoft Graph à utiliser avec Microsoft Teams
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 .
Microsoft Teams est une plateforme qui facilite le travail en équipe via la messagerie instantanée dans Office 365. Dans cet espace de travail, vous pouvez notamment accéder aux calendriers, fichiers, notes OneNote, plans du Planificateur et plannings Shifts d’une équipe. Vous pouvez utiliser microsoft API Graph pour intégrer les fonctionnalités de Microsoft Teams.
Cas d’utilisation courants
Le tableau suivant répertorie les cas d’usage courants pour les API Microsoft Teams dans Microsoft Graph.
| Cas d'utilisation | Ressources REST | Voir aussi |
|---|---|---|
| Créer et gérer des équipes, des groupes et des canaux | équipe, canal, groupe | créer une équipe, lister les équipes, créer un canal |
| Ajouter des onglets, gérer ou installer des applications dans le catalogue d’applications Microsoft Teams | teamsTab, teamsAppInstallation | créer teamsTab, lister teamsTab, répertorier les applications installées |
| Créer des canaux et des conversations pour envoyer et recevoir des messages de conversation | channel, chat,chatMessage | créer un canal, lister un canal, envoyer chatMessage dans un canal |
| Utiliser des étiquettes pour classifier des utilisateurs ou des groupes en fonction d’attributs communs au sein d’une équipe | teamworkTag, teamworkTagMember | list teamworkTag, create teamworkTag |
| Créer et recevoir des appels, appeler des enregistrements ou récupérer des coordonnées de réunion | call, callRecords | répondre, inviter des participants |
| Connecter des bots aux appels et implémenter une réponse vocale interactive (IVR) | Appel | Scénarios IVR |
| Créer et récupérer des réunions en ligne ou case activée la présence et l’activité des utilisateurs | onlineMeeting, présence | create onlineMeeting, meetingAttendanceReport |
| Créez et gérez l’intégration de la main-d’œuvre avec des équipes, des horaires, des cartes de temps ou des congés dans votre organization | workforceIntegration, schedule, shift, timeOffReason | create workforceIntegration, create schedule, create shift, create timeOff |
| Utiliser l’API d’apprentissage des employés pour s’intégrer à Viva Learning | employee learning, learningProvider, learningContent | list learningProviders, list learningContents |
Scénarios IVR
Voici les scénarios de réponse vocale interactive (IVR) pris en charge par les API appelantes dans Microsoft Graph :
- Lire une invite audio , par exemple lorsqu’un appel est placé dans la file d’attente d’un agent du service clientèle.
- Enregistrez une réponse : par exemple, pour enregistrer l’audio de l’appelant, généralement après avoir entendu une invite avec des options.
- Abonnez-vous aux tonalités , par exemple, lorsque vous souhaitez connaître les sons DTMF sélectionnés par l’appelant, généralement après avoir entendu l’invite audio.
- Annuler le traitement multimédia : par exemple, lorsque vous souhaitez annuler les opérations playPrompt ou recordResponse qui peuvent être en cours.
Limites de Microsoft Teams
Les limites Microsoft Teams de performances et de capacités testées sont décrites dans les Limites et spécifications de Microsoft Teams. Ces limites s’appliquent en utilisant directement Microsoft Teams ou à l'aide des API Microsoft Graph. Comme chaque équipe dispose d'un groupe correspondant et que chaque groupe est un objet d’annuaire, les limites du nombre de groupes et du nombre d'objets d'annuaire (« ressources ») peuvent également entrer en jeu.
Les fichiers dans les canaux sont stockés dans SharePoint. Les Limites de SharePoint Online s’appliquent.
Voir également les Seuils de limitation pour les services Microsoft Teams.
Équipes et groupes
Dans Microsoft Graph, Microsoft Teams est représenté par une ressource group. Les groupes Microsoft Teams et Office 365 facilitent la collaboration en groupe. Presque toutes les fonctionnalités de groupe s'appliquent aux groupes Microsoft Teams et Microsoft 365, telles que le calendrier de groupe, les fichiers, les notes, la photo, les plans, etc. La principale différence entre un groupe Teams et un groupe Microsoft 365 est le mode de communication entre les membres. Les membres de l’équipe communiquent via une conversation permanente dans le contexte d’une équipe spécifique. Les membres d’un groupe Microsoft 365 communiquent via des conversations de groupe, c’est-à-dire des conversations par e-mail sur Outlook.
Dans tous les groupes dotés d’une équipe, la propriété resourceProvisioningOptions contient une ressource « Team ».
Remarque : la propriété Group.resourceProvisioningOptions peut être modifiée. Nous vous déconseillons d’ajouter ou de supprimer « Team » dans cette collection. Sinon, vous obtiendrez des résultats incorrects quand vous répertorierez toutes les équipes.
Voici les différences entre les équipes et les groupes au niveau de l’API :
- La conversation permanente est disponible uniquement pour Microsoft Teams. Cette fonctionnalité est représentée hiérarchiquement par les ressources channel et chatMessage.
- Les conversations de groupe sont disponibles uniquement pour les groupes Microsoft Office 365. Cette fonctionnalité est représentée hiérarchiquement par les ressources conversation, conversationThread et post.
- La méthode Lister les équipes associées s’applique uniquement à Microsoft Teams.
- Les API d’appel et de réunion en ligne s’appliquent uniquement à Microsoft Teams.
- Consultez aussi les problèmes connus de ces API.
Modification des appartenances dans Microsoft Teams
| Cas d’utilisation | Verbe | URL |
|---|---|---|
| Ajouter un membre | POST | /teams/{team-id}/members |
| Supprimer un membre | SUPPRIMER | /teams/{team-id}/members/{membership-id} |
| Mettre à jour le rôle d’un membre | PATCH | /teams/{team-id}/members/{membership-id} |
| Mettre à jour une équipe | PATCH | /teams/{team-id} |
Conditions d'interrogation
Si votre application effectue des interrogations pour déterminer si une ressource a changé, vous ne pouvez le faire qu’une fois par jour. (teamsAsyncOperation est une exception car elle est conçue pour être interrogée fréquemment). Si vous devez prendre plus régulièrement connaissance des modifications, vous devez créer un abonnement à cette ressource et recevoir des notifications de modifications (webhooks). Si vous ne trouvez pas le support concernant le type d’abonnement dont vous avez besoin, nous vous invitons à nous envoyer des commentaires via Forum d'idées sur la plateforme pour développeurs Microsoft 365.
Lorsque vous effectuez une interrogation relatives à de nouveaux messages, vous devez indiquer une plage de dates en cas de prise en charge. Pour plus d’informations, consultez Obtenir des messages de conversation delta pour un utilisateur.
L’interrogation effectue plusieurs fois une opération GET (OBTENIR) sur une ressource pour déterminer si celle-ci a changé. Vous pouvez GET la même ressources plusieurs fois par jour, à condition qu'il ne s'agisse pas d'une interrogation. Par exemple, il est possible d’obtenir /me/joinedTeams chaque fois que l’utilisateur visite/actualise votre page web, mais il n’est pas possible d’obtenir /me/joinedTeams dans une boucle toutes les 30 secondes pour actualiser cette page web.
Les applications qui ne suivant pas ces exigences en matière d’interrogation sont considérées comme étant en violation avec les Conditions d’utilisation des API Microsoft. Cela peut entraîner une limitation supplémentaire ou la suspension ou l'arrêt de votre utilisation des API Microsoft.