Zahlungsmodelle und Lizenzierungsanforderungen für Microsoft Teams-APIs

In diesem Artikel werden die Zahlungsmodelle und Lizenzierungsanforderungen für Microsoft Teams-APIs in Microsoft Graph beschrieben. Eine allgemeine Beschreibung der getakteten APIs und Dienste in Microsoft Graph finden Sie unter Übersicht über getaktete APIs und Dienste in Microsoft Graph.

Einige APIs bieten die Möglichkeit, ein Lizenzierungs- und Zahlungsmodell über den model Abfrageparameter auszuwählen. Andere unterstützen nur ein Modell oder unterstützen kein Lizenzierungs- und Zahlungsmodell.

In der folgenden Tabelle sind die APIs und Änderungsbenachrichtigungenresources aufgeführt, die derzeit Zahlungsmodelle unterstützen.

APIs oder Änderungsbenachrichtigungresources Zahlungsmodelle
Änderungsbenachrichtigungresources:
  • /chats/getAllMessges
  • /teams/getAllMessages
  • /chats/getAllMembers
  • /teams/getAllMembers
A, B
Änderungsbenachrichtigungresources:
  • /users/{user-id}/chats/getAllMessages
  • /me/chats/getAllMessages
  • /appCatalogs/teamsApps/{app-id}/installedToChats
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers
B
Exportieren von APIs: A, B
PATCH-APIs beim Aktualisieren der policyViolation Eigenschaft: A
Teams-Besprechungs-APIs: Kein Modellparameter

Hinweis

Informationen zum Einrichten eines aktiven Azure-Abonnements für Ihre Anwendung zu Abrechnungszwecken finden Sie unter Aktivieren getakteter Microsoft 365-APIs und -Dienste. Weitere Informationen finden Sie unter Zahlungs- und Abrechnungsupdates.

Zahlungsmodelle

Die folgenden Zahlungsmodelle sind verfügbar:

Hinweis

Um ein Zahlungsmodell für eine abonnierte Ressource einer Änderungsbenachrichtigung hinzuzufügen oder zu ändern, müssen Sie ein neues Abonnement für Änderungsbenachrichtigungen mit dem neuen Zahlungsmodell erstellen. Das Aktualisieren einer vorhandenen Änderungsbenachrichtigung funktioniert nicht.

model=A-Anforderungen

model=A ist auf Anwendungen beschränkt, die eine Sicherheit- oder Compliance-Funktion ausführen. Weitere Informationen finden Sie im Abschnitt API-Bedingungen für Sicherheit und Compliance-Anwendungen der Produktbedingungen für Microsoft Azure-Dienste.

Die folgenden APIs unterstützen den model=A Parameter.

APIs oder Änderungsbenachrichtigungresources Wer benötigt eine Lizenz Seeding-Kapazität Preis für zusätzliche Nutzung Anmerkungen
Änderungsbenachrichtigungresources:
  • /chats/getAllMessges
  • /teams/getAllMessages
Absender der Nachricht (800 Nachrichten × unterstützten Lizenzen mit aktivierter DLP) pro Monat und App 0,00075 USD pro Nachricht Die Seedingkapazität wird für conversationMember-Änderungsbenachrichtigungen freigegeben
Änderungsbenachrichtigungresources:
  • /chats/getAllMembers
  • /teams/getAllMembers
Ein beliebiger Benutzer im Mandanten (800 Benachrichtigungen × unterstützten Lizenzen mit aktiviertem DLP) pro Monat und App 0,00075 USD pro Benachrichtigung Die Seeding-Kapazität wird mit den Änderungsbenachrichtigungen von chatMessage geteilt.
Apis: Benannter Benutzer (1600 Nachrichten × unterstützten Lizenzen mit aktivierter DLP) pro Monat und App 0,00075 USD pro Nachricht Der benannte Benutzer ist der, der in der GET-Anforderung-URL identifiziert wurde. Anforderungen, die eine leere Liste zurückgeben, werden als eine Nachricht berechnet. Die Seeding-Kapazität wird für den Kanalexport freigegeben.
Apis: Jedes Teammitglied (1600 Nachrichten × unterstützten Lizenzen mit aktivierter DLP) pro Monat und App 0,00075 USD pro Nachricht Anforderungen, die eine leere Liste zurückgeben, werden als eine Nachricht berechnet. Die Seeding-Kapazität wird für den Chatexport freigegeben.
APIs beim Aktualisieren der policyViolation Eigenschaft: Absender der Nachricht (800 Nachrichten × unterstützten Lizenzen mit aktivierter DLP) pro Monat und App 0,00075 USD pro Nachricht

Erforderliche Lizenzen für model=A

Der Benutzer benötigt eine Lizenz, die den Microsoft Communications DLP-Dienstplan unterstützt, z. B. eine dieser unterstützten Lizenzen. Welcher Benutzer die Lizenz benötigt, variiert je nach API. Weitere Informationen finden Sie unter model=A Anforderungen.

Gastbenutzer sind von diesen Lizenzierungsanforderungen ausgenommen. Ebenso sind Nachrichten, die von außerhalb des Mandanten gesendet werden (verbundener Chat), ausgenommen. Verbrauchszähler gelten weiterhin.

Es liegt in der Verantwortung des Mandantenbesitzers (nicht des App-Besitzers), sicherzustellen, dass Die Benutzer ordnungsgemäß lizenziert sind. Administratoren können den Information Protection-Lizenzbericht im Teams Admin Center verwenden, um zu sehen, welche Benutzer nicht über eine unterstützte Lizenz verfügen.

Viele unterstützte Lizenzen bieten kostenlose Testversionen. Office 365 E5 für instance verfügt über einen Kostenlosen Testlink unter der Schaltfläche Kaufen.

Sie können sich über das Microsoft 365-Entwicklerprogramm für eins qualifizieren. Weitere Informationen finden Sie in den häufig gestellten Fragen. Alternativ können Sie sich für eine kostenlose 1-monatige Testversion registrieren oder einen Microsoft 365-Plan erwerben.

Hinweis

Der Microsoft Communications DLP-Dienstplan muss aktiviert sein, bevor er lizenziert werden kann. Sie können Lizenzen im Microsoft Entra Admin Center oder im Microsoft 365 Admin Center verwalten. Sie können einem Gruppenkonto auch Lizenzen zuweisen, indem Sie die Microsoft Graph Graph-REST-API und das PowerShell SDK verwenden.

model=B-Anforderungen

model=B ist auf Anwendungen beschränkt, die keine Sicherheits- oder Compliancefunktion ausführen. Weitere Informationen finden Sie im Abschnitt API-Bedingungen für Sicherheit und Compliance-Anwendungen der Produktbedingungen für Microsoft Azure-Dienste.

Die folgenden APIs unterstützen den model=B Parameter.

APIs oder Änderungsbenachrichtigungresources Seeding-Kapazität Nutzungspreis Hinweise
Änderungsbenachrichtigungresources:
  • /chats/getAllMessages
  • /teams/getAllMessages
  • /users/{user-id}/chats/getAllMessages
  • /me/chats/getAllMessages
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages
Keine 0,00075 USD pro Nachricht
Änderungsbenachrichtigungresources:
  • /chats/getAllMembers
  • /teams/getAllMembers
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers
Keine 0,00075 USD pro Benachrichtigung
Änderungsbenachrichtigungresources:
  • /appCatalogs/teamsApps/{app-id}/installedToChats
Keine 0,00075 USD pro Nachricht
Apis: Keine 0,00075 USD pro Nachricht Anforderungen, die eine leere Liste zurückgeben, werden als eine Nachricht berechnet.
Apis: Keine 0,00075 USD pro Nachricht Anforderungen, die eine leere Liste zurückgeben, werden als eine Nachricht berechnet.

Anforderungen für den Evaluierungsmodus (Standard)

Die folgenden APIs unterstützen den Auswertungsmodus. Das Auswertungskontingent wird pro App, pro Mandant und Monat erzwungen. Das Kontingent wird zu Beginn jedes Kalendermonats zurückgesetzt, und ein nicht verwendeter Betrag wird nicht auf den nächsten Monat übertragen.

APIs oder Änderungsbenachrichtigungresources Auswertungskontingent Preis für zusätzliche Nutzung Anmerkungen
Änderungsbenachrichtigungresources:
  • /chats/getAllMessges
  • /teams/getAllMessages
  • /users/{user-id}/chats/getAllMessages
  • /me/chats/getAllMessages
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages
500 Nachrichten pro Monat und Mandant und App Nicht zutreffend
Änderungsbenachrichtigungresources:
  • /chats/getAllMembers
  • /teams/getAllMembers
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers
500 Nachrichten pro Monat und Mandant und App Nicht zutreffend
Änderungsbenachrichtigungresources:
  • /appCatalogs/teamsApps/{app-id}/installedToChats
500 Nachrichten pro Monat und App Nicht zutreffend
Apis: 500 Nachrichten pro Monat und Mandant und App Nicht zutreffend Anforderungen, die eine leere Liste zurückgeben, werden als eine Nachricht berechnet.
Apis: 500 Nachrichten pro Monat und Mandant und App Nicht zutreffend Anforderungen, die eine leere Liste zurückgeben, werden als eine Nachricht berechnet.
APIs beim Aktualisieren der policyViolation Eigenschaft: 500 Nachrichten pro Monat und Mandant und App Nicht zutreffend
Teams-Besprechungstranskript-APIs: 600 Minuten pro Monat und Mandant und App Nicht zutreffend
Teams-Besprechungsaufzeichnungs-APIs: 600 Minuten pro Monat und Mandant und App Nicht zutreffend

Seeding-Kapazität

Die Seeding-Kapazität ist die Kapazität, die eine App verwenden kann, bevor ein Verbrauchszähler in Rechnung gestellt wird. Die Kapazität wird auf Mandantenebene zusammengefasst. Die Seedingkapazität für alle Benutzer im Mandanten wird mit der Nutzung der App im Mandanten verglichen. Die Seedingkapazität wird pro App und Mandant verwendet. Bei einer App wird die Seedingkapazität nicht auslaufen, wenn eine andere App ausläuft. Seedingkapazität wird zu Beginn jedes Kalendermonats zurückgesetzt, und nicht genutzte Beträge werden nicht auf den nächsten Monat übertragen.

Zahlungsmodell Anwendungsfälle Seeding-Kapazität Lizenz erforderlich Azure-Abonnement erforderlich
model=A Sicherheit und Compliance Siehe model=A Anforderungen Ja (Microsoft 365 E5 berechtigte Lizenz) Ja
model=B Sicherung und Wiederherstellung, Migration, Stimmungsanalyse, Analysen und Erkenntnisse Keine Nein Ja

Seedingkapazität gilt nicht für Teams-Besprechungs-APIs. Weitere Informationen finden Sie unter Zahlungsanforderungen für Besprechungs-APIs.

Zahlungsanforderungen für Besprechungs-APIs

In diesem Abschnitt werden die Zahlungsanforderungen für Die Transkript- und Aufzeichnungs-APIs für Teams-Besprechungen beschrieben. Diese APIs unterstützen die Zahlungsmodelle von Modell A und Modell B nicht und können unabhängig vom Anwendungsfall von jeder Anwendung verwendet werden.

Diese APIs unterstützen einen Auswertungsmodus , den Apps ohne Konfiguration der Azure-Abrechnung verwenden können. In der folgenden Tabelle wird das Verhalten des Auswertungsmodus zusammengefasst.

Einrichten der Azure-Abrechnung Ergebnis
Nicht konfiguriert Die Kapazität des Auswertungsmodus steht zum Download zur Verfügung. Darüber hinaus schlägt die API mit dem Fehlercode 402 (Zahlung erforderlich) fehl.
Konfigurierte Unbegrenzte Besprechungsinhalte können heruntergeladen und basierend auf den Inhalten pro Minute berechnet werden, wie in der folgenden Tabelle beschrieben. Technische RPS-Grenzwerte gelten weiterhin.

In der folgenden Tabelle sind die Preise für die Verwendung von Teams-Besprechungs-APIs aufgeführt, die sowohl für Beta- als auch für v1.0-Endpunkte gelten.

APIs Seeding-Kapazität Nutzungspreis Hinweise
Teams-Besprechungsaufzeichnungs-APIs: Keine 0,003 USD pro Minute Die Dauer wird auf die nächste Minute gerundet.
Teams-Besprechungstranskript-APIs: Keine 0,0022 USD pro Minute Die Dauer wird auf die nächste Minute gerundet.

Zahlung und Abrechnung

Wenn Ihre Anwendungen eine der oben genannten APIs oder Änderungsbenachrichtigungenresources verwenden, müssen Sie die unter Aktivieren von getakteten Microsoft 365-APIs und -Diensten beschriebenen Schritte ausführen, um ein aktives Azure-Abonnement zu Abrechnungszwecken einzurichten.

Der organization, dem die App-Registrierung gehört, ist für die Zahlung verantwortlich. Das Azure-Abonnement sollte auch im selben Mandanten aktiv sein. Bei mehrinstanzenfähigen Apps kann sich die organization, die die App registriert hat, von der organization unterscheiden, die die App ausführt.

Wenn eine falsche Lizenzierung erkannt wird, schlägt der API-Aufruf fehl, und es werden keine Daten zurückgegeben. Insbesondere führt der Versuch, Nachrichten für einen nicht lizenzierten Benutzer abzurufen, bei den meisten APIs zu einem 402 Fehlercode. Bei Änderungsbenachrichtigungen generieren Nachrichten, die von nicht lizenzierten Benutzern gesendet werden, keine Änderungsbenachrichtigung. API-Aufrufe und Änderungsbenachrichtigungen, die im Auswertungsmodus verwendet werden, die das Auswertungskontingent überschreiten, schlagen fehl.

Fehlercode Szenario Beispielfehlermeldung
402 (Zahlung erforderlich) Fehlendes aktives Azure-Abrechnungsabonnement ...To call this API, the app must be associated with an Azure subscription, see https://aka.ms/teams-api-payment-requirements for details....
402 (Zahlung erforderlich) Übergeben model=A ohne Microsoft E5-Lizenz oder ohne aktiviertes DLP ...needs a valid license to access this API..., ...tenant needs a valid license to access this API...
402 (Zahlung erforderlich) Aufrufen der Patch-API-Übergabe model=B ...query parameter 'model' does not support value 'B' for this API. Use billing model 'A'...
402 (Zahlung erforderlich) Evaluation mode Kapazität überschritten ...evaluation capacity for the month has exceeded. To continue beyond the evalution limits complete billing onboarding...

Hinweis

Ein erfolgreicher API-Aufruf bedeutet nicht, dass die erforderliche Lizenzierung vorhanden ist. Ebenso garantiert der API-Erfolg im Auswertungsmodell nicht, dass sich der Aufruf innerhalb der Seedingkapazität befindet.

Anzeigen der abgerechneten Kosten für die getakteten Microsoft Teams-APIs

In diesem Abschnitt wird beschrieben, wie Sie die Kosten überwachen, die für die getakteten Microsoft Teams-APIs abgerechnet werden.

Ein Abonnementbesitzer oder jede Person mit entsprechenden RBAC-Berechtigungen (Rollenbasiertes Access Control) kann die Kostenanalyse verwenden, um die getaktete API-Nutzung wie folgt nachzuverfolgen:

  1. Melden Sie sich bei dem Azure-Portal unter https://portal.azure.com an.
  2. Wechseln Sie zu Kostenverwaltung + Abrechnung > Kostenverwaltung > Kostenanalyse.
  3. Wählen Sie für den Filter am oberen Rand Dienstname: Microsoft Graph-Dienste aus.
  4. Wählen Sie rechts im Dropdownmenü Gruppieren nach die Option Verbrauchseinheit aus.

Diese Ansicht bietet eine bequeme Möglichkeit, den API-Verbrauch pro Tag über einen bestimmten Zeitraum zu beobachten.

Sie können auch die Kreisdiagramme am unteren Rand verwenden, um die Kosten für die Analyse mithilfe der Filter Ressource und Verbrauchseinheit weiter aufzuschlüsseln.

Screenshot der Seite

Weitere Informationen zur Kostenverwaltung finden Sie in der Dokumentation zu Kostenverwaltung und Abrechnung.

Überwachen der Anzahl von Nachrichten, die für die getakteten Teams-APIs in Rechnung gestellt werden

In diesem Abschnitt wird beschrieben, wie Sie die Anzahl der Nachrichten überwachen, die für die getakteten Teams-APIs in Rechnung gestellt werden. Im Gegensatz zur Kostenanalyse können Sie auf diese Weise die Nutzung von Nachrichten innerhalb der Seedingkapazität analysieren, nicht nur die Nachrichten, die über der Seedingkapazität für die Abrechnung liegen, sofern dies für die ausgewählten Lizenzierungsmodelle relevant ist.

Ein Abonnementbesitzer oder jede Person mit den erforderlichen RBAC-Berechtigungen (Rollenbasiertes Access Control) kann einen Bericht im CSV-Format mit den Abrechnungsdetails für das gesamte Abonnement einrichten. Sie können den Bericht in regelmäßigen Abständen exportieren (täglich, wöchentlich, monatlich). Weitere Informationen finden Sie unter Tutorial: Erstellen und Verwalten exportierter Daten.

Screenshot einer exportierten CSV-Datei

Schätzen der Anzahl von Nachrichten in Ihren Teams

In diesem Abschnitt wird beschrieben, wie Sie die Anzahl der Nachrichten in Ihrem Teams-Mandanten nachschlagen. Dies kann Ihnen helfen, die Kosten für die Verwendung der getakteten APIs zu schätzen. Wenn eine Nachricht mehrmals über getaktete APIs abgerufen wird, wird sie mehrmals in Rechnung gestellt. Beachten Sie dies, wenn Sie die Kosten basierend auf der Anzahl der Nachrichten in Ihrem Teams-Mandanten schätzen. Wenn Sie z. B. gestern (ohne Filter) aufgerufen getAllMessages und dann heute (ohne Filter) erneut aufrufen, werden alle Nachrichten von früher als heute zweimal in Rechnung gestellt. Aus diesem Grund wird empfohlen, bei verwendung von getakteten APIs Filter (z. B. , $filter=lastModifiedDateTime gt 2019-03-17T07:13:28.000z) oder Änderungsbenachrichtigungen zu verwenden, um zu vermeiden, $top=10dass dieselbe Nachricht mehrmals abgerufen wird.

Sie können auch die getTeamsUserActivityUserDetail-API aufrufen oder microsoft Teams Admin Center wie folgt verwenden:

Anmerkung: Sie müssen entweder ein globaler Leser oder Ein Teams-Dienstadministrator sein, um den Bericht im Microsoft Teams Admin Center anzeigen zu können. Weitere Informationen finden Sie unter Verwenden von Teams-Administratorrollen zum Verwalten von Teams.

  1. Wählen Sie im linken Bereich Analysen & Berichte>Nutzungsberichte aus.
  2. Wählen Sie auf der Registerkarte Berichte anzeigen unter Bericht die Option Teams-Benutzeraktivität aus.
  3. Wählen Sie unter Datumsbereich einen Bereich aus.
  4. Wählen Sie Bericht ausführen aus.

Screenshot des Teams-Benutzeraktivitätsberichts

Häufig gestellte Fragen

Szenario Details
Warum wurde die Anzahl der In Rechnung gestellten Nachrichten höher als die Anzahl der Nachrichten in meinen Teams? Wenn Ihre App dieselbe Nachricht mehrmals abruft, wird sie mehrmals in Rechnung gestellt. Eine Möglichkeit, dies zu vermeiden, ist die Verwendung von Änderungsbenachrichtigungen anstelle von Export-APIs. Wenn Sie Export-APIs verwenden müssen, stellen Sie sicher, $filter=lastModifiedDateTimedass Sie Filter verwenden (z. B. , $filter=from).
Hat die Abrechnung tatsächlich am 5. Juli begonnen? Ja, wir integrieren Partner phasenweise. Befolgen Sie für den fortgesetzten Zugriff die Anweisungen unter Aktivieren von getakteten Microsoft 365-APIs und -Diensten , um ein aktives Azure-Abonnement zu Abrechnungszwecken einzurichten.
Was sollte ich nach dem Einrichten eines Azure-Abonnements erwarten? Die Abrechnung erfolgt sofort. Sie können die Kosten wie im Abschnitt Anzeigen der kosten in Rechnung gestellten Kosten für die getakteten Microsoft Teams-APIs oben beschrieben überwachen.
Muss ich ein Azure-Abonnement bereitstellen, wenn meine Anwendung keine getakteten APIs aufruft? Es wird empfohlen, ein Azure-Abonnement bereitzustellen, da in den meisten Szenarien getaktete APIs verwendet werden.
Was geschieht, wenn kein Azure-Abonnement bereitgestellt wird? * Es treten keine zahlungsbezogenen Fehler auf, wenn die Anwendung keine getakteten APIs aufruft.
* Wenn kein Modellparameter übergeben wird, wird der evaluation model Wert standardmäßig verwendet.
* Wenn sie eine getaktete API über aufrufenmodel=A, geben Sie eine Microsoft 365 E5 berechtigte Lizenz und ein Azure-Abonnement an.
* Wenn sie beim Aufrufen von getakteten APIs übergeben model=B wird, geben Sie ein aktives Azure-Abonnement an.
Gewusst wie ein Azure-Abonnement erstellen? Das Azure-Abonnement muss im selben Mandanten verfügbar sein, in dem die App registriert ist. Kunden mit MCA- oder EA-Vereinbarungen können ein Abonnement von ihrem vorhandenen Konto erhalten. Es ist auch möglich, ein PAYG-Abonnement mit einer Gutschrift Karte oder per Scheck oder Überweisung zu erstellen. Weitere Informationen finden Sie unter Aktivieren von getakteten Microsoft 365-APIs und -Diensten undKostenverwaltung und Abrechnung.
Wer ist bei mehrinstanzenfähigen Apps für die Zahlung verantwortlich? Der organization, der besitzer der App-Registrierung ist.
Ist es möglich, die Abrechnung von einer Mehrinstanzen- oder einzelinstanzenfähigen App zu unterscheiden? Ja, diese Informationen müssen als Teil der Azure-Abrechnungsdetails angegeben werden.
Gibt es eine Gebühr, wenn keine Nachricht mit einem Modell zurückgegeben wird? Um häufige Abrufe zu vermeiden, wird API-Anforderungen, die eine leere Liste von Nachrichten zurückgeben, eine Nachricht in Rechnung gestellt. Im Fall von evaluation modelzählt der Aufruf auf die zulässigen 500 Nachrichten pro Monat und App.
Wo kann ich die Kosten und die Abrechnung überwachen? Ein Abonnementbesitzer oder jede Person mit geeigneter rollenbasierter Access Control (RBAC) kann das Azure-Kostenanalysetool verwenden, um den Verbrauch pro Tag nachzuverfolgen oder nach Verbrauchseinheit, Dienstname, Ressourcen-ID und anderen Parametern zu filtern. Weitere Informationen finden Sie unter Anzeigen der Kosten, die für die getakteten Microsoft Teams-APIs oben in Rechnung gestellt werden .
Gibt es einen Mengenrabatt? Es gelten Pauschalpreise.
Sind diese APIs im MacC-Programm (Microsoft Azure Consumption Commitment) registriert? Dies ist derzeit nicht möglich.