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:
- Beständiger Chat steht nur für Microsoft Teams zur Verfügung. Dieses Feature wird von den Ressourcen channel und chatMessage hierarchisch dargestellt.
- Gruppenunterhaltungen sind nur für Microsoft 365-Gruppen verfügbar. Dieses Feature wird von den Ressourcen conversation, conversationThread und post hierarchisch dargestellt.
- Die Liste joined teams-Methode gilt nur für Microsoft Teams.
- Anruf- und Onlinebesprechungs-APIs gelten nur für Microsoft Teams.
- Weitere Informationen finden Sie im Abschnitt Bekannte Probleme für diese APIs.
Ä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.