Freigeben über


Verwenden der Microsoft Graph-API zum Arbeiten mit Microsoft Teams

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Microsoft Teams ist ein Chat-basierter Arbeitsbereich in Microsoft 365, der integrierten Zugriff auf Team-spezifische Kalender, Dateien, OneNote-Notizen, Planner-Pläne, Schichtpläne und vieles mehr bietet. Sie können die Microsoft Graph-API für die Integration in Microsoft Teams-Features verwenden.

Allgemeine Anwendungsfälle

In der folgenden Tabelle sind häufige Anwendungsfälle für Microsoft Teams-APIs in Microsoft Graph aufgeführt.

Anwendungsfälle REST-Ressourcen Siehe auch
Erstellen und Verwalten von Teams, Gruppen und Kanälen Team, Kanal, Gruppe Team erstellen, Teams auflisten, Kanal erstellen
Hinzufügen von Registerkarten, Verwalten oder Installieren von Apps im Microsoft Teams-App-Katalog teamsTab, teamsAppInstallation Teams erstellenTab, TeamsTab auflisten, installierte Apps auflisten
Erstellen von Kanälen und Chats zum Senden und Empfangen von Chatnachrichten Kanal, Chat, chatMessage Kanal erstellen, Kanal auflisten, chatMessage in einem Kanal senden
Verwenden von Tags zum Klassifizieren von Benutzern oder Gruppen basierend auf allgemeinen Attributen innerhalb eines Teams teamworkTag, teamworkTagMember list teamworkTag, erstellen TeamworkTag
Erstellen und Empfangen von Anrufen, Anrufaufzeichnungen oder Abrufen von Besprechungskoordinaten call, callRecords Antworten, Teilnehmer einladen
Verbinden von Bots mit Anrufen und Implementieren der interaktiven Sprachantwort (Interactive Voice Response, IVR) call ISA-Szenario
Erstellen und Abrufen von Onlinebesprechungen oder Überprüfen der Anwesenheit und Aktivität von Benutzern onlineMeeting, Anwesenheit onlineMeeting, meetingAttendanceReport erstellen
Erstellen und Verwalten der Mitarbeiterintegration mit Schichten, Zeitplänen, Zeitkarten oder Freizeitzeiten in Ihrem organization workforceIntegration, schedule, shift, timeOff, timeOffReason create workforceIntegration, create schedule, create shift, create timeOff
Verwenden der Mitarbeiterlern-API für die Integration in Viva Learning Mitarbeiterlernen, learningProvider, learningContent learningProviders auflisten, learningContents auflisten

ISA-Szenario

Im Folgenden werden die IvR-Szenarien (Interactive Voice Response) aufgeführt, die von den aufrufenden APIs in Microsoft Graph unterstützt werden:

  • Wiedergeben einer Audioeingabeaufforderung , z. B. wenn ein Anruf in der Warteschlange eines Kundendienstmitarbeiters platziert wird.
  • Zeichnen Sie eine Antwort auf, z. B. um die Audiodaten des Anrufers aufzuzeichnen, in der Regel, nachdem er eine Eingabeaufforderung mit Optionen gehört hat.
  • Abonnieren Sie Töne , z. B. wenn Sie wissen möchten, welche DTMF-Töne der Anrufer ausgewählt hat, in der Regel nach dem Hören der Audioaufforderung.
  • Abbrechen der Medienverarbeitung , z. B. wenn Sie playPrompt - oder recordResponse-Vorgänge abbrechen möchten, die gerade ausgeführt werden können.

Microsoft Teams-Limits

Die getesteten Leistungs- und Kapazitätslimits von Microsoft Teams sind in Limits und Spezifikationen für Microsoft Teams dokumentiert. Diese Limits gelten unabhängig davon, ob Sie Microsoft Teams direkt oder Microsoft Graph-APIs verwenden. Da jedes Team über eine ihm entsprechende Gruppe verfügt und jede Gruppe ein Verzeichnisobjekt ist, können Beschränkungen der Anzahl der Gruppen und der Anzahl von Verzeichnisobjekten („Ressourcen“) ebenfalls eine Rolle spielen.

Dateien innerhalb von Kanälen werden in SharePoint gespeichert, womit also SharePoint Online-Limits gelten.

Siehe auch Einschränkungslimits für Microsoft Teams-Dienste.

Teams und Gruppen

In Microsoft Graph wird Microsoft Teams durch eine group-Ressource dargestellt. Sowohl Microsoft Teams- als auch Microsoft 365-Gruppen erfüllen die unterschiedlichen Anforderungen der Zusammenarbeit in Gruppen. Fast alle gruppenbasierten Funktionen gelten sowohl für Microsoft Teams- als auch für Microsoft 365-Gruppen, wie z. B. Gruppenkalender, Dateien, Notizen, Fotos, Pläne usw. Der Hauptunterschied zwischen einer Team- und Microsoft 365-Gruppe ist der Kommunikationsmodus zwischen den Mitgliedern. Teammitglieder kommunizieren innerhalb eines ständigen Chats im Kontext eines bestimmten Teams. Microsoft 365-Gruppenmitglieder kommunizieren in Gruppenunterhaltungen, also E-Mail-Unterhaltungen, die im Kontext einer Gruppe in Outlook stattfinden.

Jede Gruppe, die über ein Team verfügt, besitzt die ResourceProvisioningOptions-Eigenschaft, die "Team" enthält.

Hinweis: Die Group.resourceProvisioningOptions-Eigenschaft kann geändert werden. "Team" sollte nicht zu dieser Sammlung hinzugefügt oder aus ihr entfernt werden; andernfalls erhalten Sie bei der Auflistung aller Teams falsche Ergebnisse.

Im folgenden werden die Unterschiede zwischen Teams und Gruppen auf der API-Ebene aufgelistet:

Ändern der Mitgliedschaft in Microsoft Teams

Anwendungsfall Verb URL
Mitglied hinzufügen POST /teams/{team-id}/members
Mitglied entfernen LÖSCHEN /teams/{team-id}/members/{membership-id}
Rolle des Mitglieds aktualisieren PATCH /teams/{team-id}/members/{membership-id}
Team aktualisieren PATCH /teams/{team-id}

Anforderungen für das Abrufen

Wenn Ihre App Abrufe durchführt, um festzustellen, ob sich eine Ressource geändert hat, können Sie dies nur einmal pro Tag tun. (teamsAsyncOperation- ist dahingehend eine Ausnahme, dass es für häufiges Abrufen gedacht ist.) Wenn Sie häufiger Informationen über Änderungen benötigen, sollten Sie ein Abonnement dieser Ressource erstellen und Änderungsbenachrichtigungen empfangen (webhooks). Wenn Sie keinen Support für die Art des Abonnements finden, das Sie benötigen, empfehlen wir Ihnen, Feedback über das Ideenforum der Microsoft 365 Developer Platform bereitzustellen.

Beim Abrufen neuer Nachrichten müssen Sie einen Datumsbereich angeben, falls dies unterstützt wird. Weitere Informationen finden Sie unter Abrufen von Delta-Chatnachrichten für einen Benutzer.

Beim Abrufen wird immer wieder ein GET-Vorgang an einer Ressource ausgeführt, um festzustellen, ob sich die Ressource geändert hat. Sie dürfen mehrmals am Tag GET-Aufrufe an dieselbe Ressource ausführen, solange es sich dabei nicht um Abrufe handelt. Beispielsweise ist es in Ordnung, "/me/joinedTeams" bei jedem Besuch/Aktualisierung ihrer Webseite zu get /me/joinedTeams zu erhalten, aber es ist nicht in Ordnung, alle 30 Sekunden "/me/joinTeams" in einer Schleife zu erhalten, um diese Webseite zu aktualisieren.

Apps, die diese Anforderungen für das Abrufen nicht erfüllen, verletzen die Nutzungsbedingungen für Microsoft-APIs. Dies kann zu zusätzlichen Einschränkungen oder der Aussetzung oder Beendigung Ihrer Verwendung der Microsoft-APIs führen.