Modèles de paiement et conditions de licence pour les API Microsoft Teams
Cet article décrit les modèles de paiement et les conditions de licence pour les API Microsoft Teams dans Microsoft Graph. Pour obtenir une description générale des API et services à l’usage dans Microsoft Graph, consultez Vue d’ensemble des API et services à l’usage dans Microsoft Graph.
Certaines API offrent la possibilité de choisir un modèle de licence et de paiement via le model paramètre de requête ; d’autres ne prennent en charge qu’un seul modèle ou ne prennent pas en charge un modèle de licence et de paiement.
Le tableau suivant répertorie les API et les notificationsresources de modification qui prennent actuellement en charge les modèles de paiement.
API ou notification de modificationresources |
Modes de paiement |
|---|---|
Notification de modificationresources :
|
A, B |
Notification de modificationresources :
|
B |
| API d’exportation : | A, B |
API PATCH, lors de la mise à jour de la policyViolation propriété : |
A |
| API de réunion Teams : | Aucun paramètre de modèle |
Remarque
Pour configurer un abonnement Azure actif pour votre application à des fins de facturation, consultez Activer les API et services Microsoft 365 à l’usage. Pour plus d’informations, consultez Mises à jour de paiement et de facturation.
Modes de paiement
Les modèles de paiement suivants sont disponibles :
model=Aest limité aux applications exécutant une fonction de conformité ou de sécurité et nécessite une licence prise en charge.model=Best limité aux applications qui n’exécutent pas de fonction de sécurité ou de conformité. Il n’existe aucune exigence de licence pourmodel=B.Lemode d’évaluation (par défaut) permet d’accéder aux API avec une utilisation limitée par application demandant à des fins d’évaluation. Les notifications de modification ne sont pas envoyées si la limite est dépassée.
Remarque
Pour ajouter ou modifier un modèle de paiement pour une ressource abonnée d’une notification de modification, vous devez créer un abonnement aux notifications de modification avec le nouveau modèle de paiement . La mise à jour d’une notification de modification existante ne fonctionne pas.
Conditions requises pour model=A
model=A est limité aux applications effectuant une fonction de sécurité ou de conformité. Pour plus d’informations, consultez la section des conditions de l’API pour les applications de conformité et de sécurité des Conditions relatives au produit pour les Services Microsoft Azure.
Les API suivantes prennent en charge le model=A paramètre .
API ou notification de modificationresources |
Qui a besoin d’une licence | Capacité amorçage | Prix pour une utilisation supplémentaire | Remarques |
|---|---|---|---|---|
Notification de modificationresources :
|
Expéditeur de message | (800 messages × licences prises en charge avec DLP activée) par mois et par application | 0,00075 $ par message | La capacité d’amorçage est partagée avec les notifications de modification conversationMember |
Notification de modificationresources :
|
Tout utilisateur dans le locataire | (800 notifications × licences prises en charge avec DLP activée) par mois et par application | 0,00075 $ par notification | La capacité d’amorçage est partagée avec les notifications de modification chatMessage |
| Apis: | Utilisateur nommé | (1 600 messages × licences prises en charge avec DLP activée) par mois et par application | 0,00075 $ par message | L’utilisateur nommé est l’utilisateur identifié dans l’URL de requête GET. Les demandes qui retournent une liste vide sont facturées comme un seul message. La capacité amorçage est partagée avec l’exportation de canal. |
| Apis: | Tout membre d’équipe | (1 600 messages × licences prises en charge avec DLP activée) par mois et par application | 0,00075 $ par message | Les demandes qui retournent une liste vide sont facturées comme un seul message. La capacité d’amorçage est partagée avec l’exportation de conversation. |
API, lors de la mise à jour de la policyViolation propriété : |
Expéditeur de message | (800 messages × licences prises en charge avec DLP activée) par mois et par application | 0,00075 $ par message |
Licences requises pour model=A
L’utilisateur a besoin d’une licence qui prend en charge le plan de service DLP Microsoft Communications, comme l’une de ces licences prises en charge.
L’utilisateur qui a besoin de la licence varie selon l’API ; pour plus d’informations, consultez conditions requises pour model=A.
Les utilisateurs invités sont exemptés de ces conditions requises de licence. De même, les messages envoyés en dehors du client (conversation fédérée) sont exemptés. Les compteurs de consommation s’appliquent toujours.
Il incombe au propriétaire du locataire (et non au propriétaire de l’application) de s’assurer que les utilisateurs disposent d’une licence appropriée. Les administrateurs peuvent utiliser le rapport de licence Information Protection dans le Centre d’administration Teams pour voir quels utilisateurs n’ont pas de licence prise en charge.
De nombreuses licences prises en charge offrent des essais gratuits. Office 365 E5 pour instance a un lien Essai gratuit sous le bouton Acheter.
Vous pouvez être éligible pour un par le biais du Programme pour les développeurs Microsoft 365 ; Pour plus d’informations, consultez la FAQ. Vous pouvez également vous inscrire à un essai gratuit de 1 mois ou acheter un plan Microsoft 365.
Remarque
Le plan de service DLP Microsoft Communications doit être activé avant de pouvoir être concédé sous licence. Vous pouvez gérer les licences dans le centre d’administration Microsoft Entra ou le Centre d’administration Microsoft 365. Vous pouvez également attribuer des licences à un compte de groupe à l’aide de l’API REST Graph Microsoft Graph et du Kit de développement logiciel (SDK) PowerShell.
Conditions requises pour model=B
model=B est limité aux applications qui n’exécutent pas de fonction de sécurité ou de conformité. Pour plus d’informations, consultez la section Conditions de l’API pour les applications Security & Compliance des termes du produit pour Microsoft Azure Services.
Les API suivantes prennent en charge le model=B paramètre .
API ou notification de modificationresources |
Capacité amorçage | Prix d’utilisation | Notes |
|---|---|---|---|
Notification de modificationresources :
|
Aucune | 0,00075 $ par message | |
Notification de modificationresources :
|
Aucun | 0,00075 $ par notification | |
Notification de modificationresources :
|
Aucune | 0,00075 $ par message | |
| Apis: | Aucune | 0,00075 $ par message | Les demandes qui retournent une liste vide sont facturées comme un seul message. |
| Apis: | Aucune | 0,00075 $ par message | Les demandes qui retournent une liste vide sont facturées comme un seul message. |
Conditions requises pour le mode d’évaluation (par défaut)
Les API suivantes prennent en charge le mode d’évaluation. Le quota d’évaluation est appliqué par application, par locataire et par mois. Le quota est réinitialisé au début de chaque mois calendaire, et tout montant inutilisé n’est pas reporté au mois suivant.
API ou notification de modificationresources |
Quota d’évaluation | Prix pour une utilisation supplémentaire | Remarques |
|---|---|---|---|
Notification de modificationresources :
|
500 messages par mois par locataire et par application | S/O | |
Notification de modificationresources :
|
500 messages par mois par locataire et par application | S/O | |
Notification de modificationresources :
|
500 messages par mois et par application | S/O | |
| Apis: | 500 messages par mois par locataire et par application | S/O | Les demandes qui retournent une liste vide sont facturées comme un seul message. |
| Apis: | 500 messages par mois par locataire et par application | S/O | Les demandes qui retournent une liste vide sont facturées comme un seul message. |
API, lors de la mise à jour de la policyViolation propriété : |
500 messages par mois par locataire et par application | S/O | |
| API de transcription de réunion Teams : | 600 minutes par mois par locataire et par application | S/O | |
| API d’enregistrement de réunion Teams : | 600 minutes par mois par locataire et par application | S/O |
Capacité amorçage
La capacité d’amorçage est la quantité de capacité qu’une application peut utiliser avant qu’un compteur de consommation ne soit facturé. La capacité est mise en pool au niveau du locataire : la capacité amorcée pour tous les utilisateurs du locataire est comparée à l’utilisation de l’application dans le locataire. La capacité amorçage est par application et par locataire : une application ne sera pas à court de capacité amorçage si une autre application s’exécute. La capacité amorçage est réinitialisée au début de chaque mois calendaire, et tout montant inutilisé n’est pas reporté au mois suivant.
| Mode de paiement | Cas d'utilisation | Capacité amorçage | Licence requise | Abonnement Azure requis |
|---|---|---|---|---|
model=A |
Sécurité et conformité | Voir lamodel=A configuration requise |
Oui (Microsoft 365 E5 licence éligible) | Oui |
model=B |
Sauvegarde et restauration, migration, analyse des sentiments, analytique et insights | Aucune | Non | Oui |
La capacité amorçage n’est pas applicable aux API de réunion Teams. Pour plus d’informations, consultez Exigences de paiement pour les API de réunion.
Exigences de paiement pour la réunion des API
Cette section décrit les exigences de paiement pour les API d’enregistrement et de transcription de réunion Teams. Ces API ne prennent pas en charge les modèles de paiement A et B et peuvent être utilisées par n’importe quelle application, quel que soit le cas d’usage.
Ces API prennent en charge un mode d’évaluation que les applications peuvent utiliser sans configurer la facturation Azure. Le tableau suivant récapitule le comportement du mode d’évaluation.
| Configuration de la facturation Azure | Résultat |
|---|---|
| Non configuré | La capacité du mode d’évaluation est disponible en téléchargement. En outre, l’API échoue avec le code 402 d’erreur (Paiement requis). |
| Configuré | Le contenu de réunion illimité est disponible en téléchargement et facturé en fonction de la minute de contenu, comme décrit dans le tableau suivant. Les limites RPS d’ingénierie s’appliquent toujours. |
Le tableau suivant répertorie les prix d’utilisation des API de réunion Teams, applicables aux points de terminaison bêta et v1.0.
| API | Capacité amorçage | Prix d’utilisation | Notes |
|---|---|---|---|
| API d’enregistrement de réunion Teams : | Aucune | 0,003 $ par minute | La durée est arrondie à la minute la plus proche. |
| API de transcription de réunion Teams : | Aucune | 0,0022 $ par minute | La durée est arrondie à la minute la plus proche. |
Paiement et facturation
Si vos applications utilisent ou utiliseront l’une des API ou notifications de modificationresources mentionnées ci-dessus, vous devez suivre les étapes décrites dans Activer les API et services Microsoft 365 à l’usage pour configurer un abonnement Azure actif à des fins de facturation.
Le organization propriétaire de l’inscription de l’application est responsable du paiement. L’abonnement Azure doit également être actif dans le même locataire. Pour les applications multilocataires, la organization qui a inscrit l’application peut être différente de la organization qui exécute l’application.
Erreurs liées au paiement
Si une licence incorrecte est détectée, l’appel d’API échoue et les données ne sont pas retournées.
Plus précisément, pour la plupart des API, une tentative d’obtention de messages pour un utilisateur sans licence génère un 402 code d’erreur.
Pour les notifications de modification, les messages envoyés par des utilisateurs sans licence ne génèrent pas de notification de modification.
Les appels d’API et les notifications de modification utilisés en mode d’évaluation au-delà du quota d’évaluation échouent.
| Code d’erreur | Scénario | Exemple de message d’erreur |
|---|---|---|
| 402 (paiement requis) | Abonnement de facturation Azure actif manquant | ...To call this API, the app must be associated with an Azure subscription, see https://aka.ms/teams-api-payment-requirements for details.... |
| 402 (paiement requis) | Passage model=A sans licence Microsoft E5 ou sans DLP activé |
...needs a valid license to access this API..., ...tenant needs a valid license to access this API... |
| 402 (paiement requis) | Appel de la transmission de l’API Patch model=B |
...query parameter 'model' does not support value 'B' for this API. Use billing model 'A'... |
| 402 (paiement requis) |
Evaluation mode capacité dépassée |
...evaluation capacity for the month has exceeded. To continue beyond the evalution limits complete billing onboarding... |
Remarque
Un appel d’API réussi ne signifie pas que la licence requise est en place. De même, la réussite de l’API dans le modèle d’évaluation ne garantit pas que l’appel est dans la capacité d’amorçage.
Afficher les coûts facturés pour les API Microsoft Teams limitées
Cette section explique comment surveiller les coûts facturés pour les API Microsoft Teams à l’utilisation.
Un propriétaire d’abonnement, ou toute personne disposant des autorisations RBAC (Roles Based Access Control) appropriées, peut utiliser l’analyse des coûts pour suivre la consommation d’API limitée, comme suit :
- Connectez-vous au portail Azure à l'adresse https://portal.azure.com.
- Accédez à Cost Management + Billing > Cost Management > Analyse des coûts.
- Pour le filtre en haut, sélectionnez Nom du service : Services Microsoft Graph.
- Pour le menu déroulant Regrouper par près de la droite, sélectionnez Compteur.
Cette vue offre un moyen pratique d’observer la consommation d’API par jour sur une période donnée.
Vous pouvez également utiliser les graphiques en secteurs situés en bas pour décomposer davantage les coûts d’analyse, à l’aide des filtres Ressource et Compteur .
Pour plus d’informations sur la gestion des coûts, consultez la documentation Cost Management + Billing.
Surveiller le nombre de messages facturés pour les API Teams limitées
Cette section explique comment surveiller le nombre de messages facturés pour les API Teams limitées. Contrairement à l’analyse des coûts, cela vous permet d’analyser l’utilisation des messages au sein de la capacité amorçage, et pas seulement ceux qui dépassent la capacité amorçage pour la facturation, le cas échéant pour les modèles de licence sélectionnés.
Un propriétaire d’abonnement, ou toute personne disposant des autorisations RBAC (Roles Based Access Control) requises, peut configurer un rapport, au format CSV, avec les détails de facturation de l’abonnement entier. Vous pouvez exporter le rapport régulièrement (quotidienne, hebdomadaire, mensuelle). Pour plus d’informations, consultez Tutoriel : Créer et gérer des données exportées.
Estimer le nombre de messages dans vos équipes
Cette section explique comment rechercher le nombre de messages dans votre locataire Teams. Cela peut vous aider à estimer le coût d’utilisation des API à l’usage. Si un message est récupéré via des API limitées plusieurs fois, il est facturé plusieurs fois. Gardez cela à l’esprit lorsque vous estimez le coût en fonction du nombre de messages dans votre locataire Teams. Par exemple, si vous avez appelé getAllMessages (sans filtre) hier, puis que vous l’appelez à nouveau (sans aucun filtre) aujourd’hui, tous les messages d’avant aujourd’hui seront facturés deux fois. Pour cette raison, lorsque vous utilisez des API limitées, nous vous recommandons d’utiliser des filtres (par exemple, $top=10, $filter=lastModifiedDateTime gt 2019-03-17T07:13:28.000z) ou des notifications de modification pour éviter de récupérer le même message plusieurs fois.
Vous pouvez également appeler l’API getTeamsUserActivityUserDetail ou utiliser le Centre Administration Microsoft Teams comme suit :
Note: Vous devez être lecteur général ou administrateur de service Teams pour afficher le rapport dans le Centre Administration Microsoft Teams. Pour plus d’informations, consultez Utiliser des rôles d’administrateur Teams pour gérer Teams.
- Dans le volet gauche, choisissez Analytics & rapports>Rapports d’utilisation.
- Sous l’onglet Afficher les rapports , sous Rapport, choisissez Activité utilisateur Teams.
- Sous Plage de dates, sélectionnez une plage.
- Choisissez Exécuter le rapport.
Foire aux questions
| Scénario | Détails |
|---|---|
| Pourquoi le nombre de messages a-t-il été facturé plus élevé que le nombre de messages dans mes équipes ? | Si votre application récupère le même message plusieurs fois, il est facturé plusieurs fois. Une façon d’éviter cela consiste à utiliser des notifications de modification au lieu d’API d’exportation. Si vous devez utiliser des API d’exportation, veillez à utiliser des filtres (par exemple, $filter=lastModifiedDateTime, $filter=from). |
| La facturation a-t-elle réellement commencé le 5 juillet ? | Oui, nous intégrons des partenaires par phases. Pour un accès continu, suivez les instructions sur Activer les API et services Microsoft 365 à l’usage pour configurer un abonnement Azure actif à des fins de facturation. |
| À quoi dois-je m’attendre après la configuration d’un abonnement Azure ? | La facturation est effective immédiatement. Vous pouvez surveiller les coûts comme décrit dans la section Afficher les coûts facturés pour les API Microsoft Teams à l’utilisation ci-dessus. |
| Dois-je fournir un abonnement Azure si mon application n’appelle pas d’API limitées ? | Nous vous recommandons de fournir un abonnement Azure, car la plupart des scénarios utilisent des API limitées. |
| Que se passe-t-il si aucun abonnement Azure n’est fourni ? | * Aucune erreur liée au paiement ne se produit si l’application n’appelle pas d’API limitées. * Si aucun paramètre de modèle n’est passé, la evaluation model valeur est utilisée par défaut. * Si vous appelez une API limitée en passant model=A, fournissez une Microsoft 365 E5 licence éligible et un abonnement Azure. * Si vous passez model=B lors de l’appel d’API limitées, fournissez un abonnement Azure actif. |
| Comment faire créer un abonnement Azure ? | L’abonnement Azure doit être disponible dans le même locataire que celui où l’application est inscrite. Les clients disposant d’un contrat MCA ou EA peuvent obtenir un abonnement à partir de leur compte existant. Il est également possible de créer un abonnement PAYG à l’aide d’un crédit carte ou de payer par case activée ou par virement bancaire. Pour plus d’informations, consultez Activer les API et services Microsoft 365 mesurés et gestion des coûts et facturation. |
| Qui est responsable du paiement dans le cas des applications multilocataires ? | Organization propriétaire de l’inscription de l’application. |
| Est-il possible de différencier la facturation de l’application multilocataire ou monolocataire ? | Oui, ces informations doivent être fournies dans le cadre des détails de facturation Azure. |
| Existe-t-il des frais lorsqu’aucun message n’est retourné à l’aide d’un modèle ? | Pour décourager les interrogations fréquentes, les demandes d’API qui retournent une liste vide de messages seront facturées d’un message. Dans le cas de evaluation model, l’appel compte pour les 500 messages par mois et par application autorisés. |
| Où puis-je surveiller le coût et la facturation ? | Un propriétaire d’abonnement ou toute personne disposant d’un RBAC (Roles Based Access Control) approprié peut utiliser l’outil Azure Cost Analysis pour suivre la consommation par jour ou filtrer par compteur, nom de service, ID de ressource, entre autres paramètres. Pour plus d’informations, consultez Afficher les coûts facturés pour les API Microsoft Teams mesurées ci-dessus. |
| Y a-t-il une remise de volume ? | Des tarifs forfaitaires s’appliquent. |
| Ces API sont-elles inscrites dans le programme Microsoft Azure Consumption Commitment (MACC) ? | Non, ce n’est actuellement pas possible. |