Verwenden der Microsoft Graph-API zum Arbeiten mit Microsoft Teams

  • Artikel

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.

Allgemeine Anwendungsfälle

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) 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 Integration von Mitarbeitern 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

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. Ausführliche Informationen finden Sie unter Abrufen des Kanalnachrichtendeltas.

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. So ist es beispielsweise in Ordnung, jedes Mal, wenn der Benutzer Ihre Webseite besucht/aktualisiert, ein GET an „/me/joinedTeams“ zu senden, aber es ist nicht in Ordnung, wenn Sie alle 30 Sekunden in einer Schleife ein GET an „/me/joinedTeams“ senden, 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.

Verwandte Inhalte