Verwenden der Microsoft Graph-API zum Arbeiten mit Microsoft TeamsUse the Microsoft Graph API to work with Microsoft Teams

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Microsoft Teams ist ein Chat-basierter Arbeitsbereich in Office 365, der integrierten Zugriff auf Team-spezifische Kalender, Dateien, OneNote-Notizen, Planner-Pläne, Schichtpläne und vieles mehr bietet.Microsoft Teams is a chat-based workspace in Office 365 that provides built-in access to team-specific calendars, files, OneNote notes, Planner plans, Shifts schedules, and more.

Wichtige Ressourcen in Microsoft TeamsKey resources in Microsoft Teams

RessourceResource MethodenMethods
teamteam List your teams, list all teams, create, read, update, delete, clone, archive, unarchiveList your teams, list all teams, create, read, update, delete, clone, archive, unarchive
groupgroup Add member, remove member, add owner, remove owner, get files, get notebook, get plans, get calendarAdd member, remove member, add owner, remove owner, get files, get notebook, get plans, get calendar
channelchannel List, create, read, update, deleteList, create, read, update, delete
teamsTabteamsTab List, create, read, update, deleteList, create, read, update, delete
teamsAppteamsApp List, publish, update, removeList, publish, update, remove
teamsAppInstallationteamsAppInstallation List, install, upgrade, removeList, install, upgrade, remove
chatMessage (Vorschau)chatMessage (preview) List, send, readList, send, read
call (Vorschau)call (preview) Answer, reject, redirect, mute, unmute, update metadata, change screen sharing role, list participants, invite participants, mute all participantsAnswer, reject, redirect, mute, unmute, update metadata, change screen sharing role, list participants, invite participants, mute all participants
Zeitplan (Vorschau)schedule (preview) Erstellen oder ersetzen, abrufen, freigebenCreate or replace, get, share
schedulingGroup (Vorschau)schedulingGroup (preview) Erstellen, Auflisten, Abrufen, Ersetzen, LöschenCreate, List, Get, Replace, Delete
shift (Vorschau)shift (preview) Erstellen, Auflisten, Abrufen, Ersetzen, LöschenCreate, List, Get, Replace, Delete
timeOff (Vorschau)timeOff (preview) Erstellen, Auflisten, Abrufen, Ersetzen, LöschenCreate, List, Get, Replace, Delete
timeOffReason (Vorschau)timeOffReason (preview) Erstellen, Auflisten, Abrufen, Ersetzen, LöschenCreate, List, Get, Replace, Delete

Teams und GruppenTeams and groups

In Microsoft Graph wird Microsoft Teams durch eine group-Ressource dargestellt.In Microsoft Graph, Microsoft Teams is represented by a group resource. Sowohl Microsoft Teams- als auch Office 365-Gruppen erfüllen die unterschiedlichen Anforderungen der Zusammenarbeit in Gruppen.Both Microsoft Teams and Office 365 groups address the various needs of group collaboration. Fast alle gruppenbasierten Funktionen gelten sowohl für Microsoft Teams- als auch für Office 365-Gruppen, wie z. B. Gruppenkalender, Dateien, Notizen, Fotos, Pläne usw.Almost all the group-based features apply to Microsoft Teams and Office 365 groups, such as group calendar, files, notes, photo, plans, and so on. Der Hauptunterschied zwischen einer Team- und Office 365-Gruppe ist der Kommunikationsmodus zwischen den Mitgliedern.The main difference between a team and an Office 365 group is the mode of communication between members. Team-Mitglieder kommunizieren innerhalb eines beständigen Chats im Kontext eines bestimmten Teams.Team members communicate by persistent chat in the context of a specific team. Office 365-Gruppenmitglieder kommunizieren in Gruppenunterhaltungen, wobei es sich um E-Mail-Kommunikationen handelt, die im Kontext einer Gruppe in Outlook ausgeführt werden.Office 365 group members communicate by group conversations, which are email conversations that occur in the context of a group in Outlook.

Jede Gruppe, die über ein Team verfügt, besitzt die ResourceProvisioningOptions-Eigenschaft, die "Team" enthält.Any group that has a team has a resourceProvisioningOptions property that contains "Team".

Hinweis: Die Group.resourceProvisioningOptions-Eigenschaft kann geändert werden.Note: The Group.resourceProvisioningOptions property can be changed. "Team" sollte nicht zu dieser Sammlung hinzugefügt oder aus ihr entfernt werden; andernfalls erhalten Sie bei der Auflistung aller Teams falsche Ergebnisse.Do not add or remove "Team" from that collection; otherwise, you'll get incorrect results when you list all teams.

Im folgenden werden die Unterschiede zwischen Teams und Gruppen auf der API-Ebene aufgelistet:The following are the differences at the API level between teams and groups:

Hinweis: Wenn Sie die Gruppen-APIs in einer Microsoft Teams-App und nicht in einer eigenständigen App verwenden, z. B. als Teil einer Registerkarte oder eines Bots, der in Microsoft Teams ausgeführt wird, folgen Sie den Anweisungen im Artikel Verwenden von Microsoft Graph in Ihren Microsoft Teams-Seiten.Note: If you use the groups API in a Microsoft Teams app rather than in a standalone app - for example as part of a tab or bot running in Microsoft Teams - follow the guidance in the article Using Microsoft Graph in your Microsoft Teams pages.

Ändern der Mitgliedschaft in Microsoft TeamsMembership changes in Microsoft Teams

Wenn Sie Mitglieder und Besitzer zu einem Team hinzufügen möchten, ändern Sie die Mitgliedschaft der Gruppe mit der gleichen ID.To add members and owners to a team, change the membership of the group with the same ID.

AnwendungsfallUse case VerbVerb URLURL
Mitglied hinzufügenAdd member POSTPOST /groups/{id}/members/$ref/groups/{id}/members/$ref
Mitglied entfernenRemove member LÖSCHENDELETE /groups/{id}/members/{userId}/$ref/groups/{id}/members/{userId}/$ref
Besitzer hinzufügenAdd owner POSTPOST /groups/{id}/owners/$ref/groups/{id}/owners/$ref
Besitzer entfernenRemove owner LÖSCHENDELETE /groups/{id}/owners/{userId}/$ref/groups/{id}/owners/{userId}/$ref
Team aktualisierenUpdate team PATCHPATCH /teams/{id}/teams/{id}

Wenn Sie einen Besitzer hinzufügen, sollten Sie diesen auch als Mitglied hinzufügen.We recommend that when you add an owner, you also add that user as a member. Wenn ein Team über einen Besitzer verfügt, der kein Mitglied ist, werden Besitzer- und Mitgliedschaftsänderungen möglicherweise nicht sofort in Microsoft Teams angezeigt.If a team has an owner who is not also a member, ownership and membership changes might not show up immediately in Microsoft Teams. Darüber hinaus wird dies je nach App oder API unterschiedlich behandelt.In addition, different apps and APIs will handle that differently. In Microsoft Teams werden z. B. Teams, in denen der Benutzer entweder Mitglied oder Besitzer ist, angezeigt, während die Microsoft Teams PowerShell-Cmdlets und die me/joinedTeams-API nur Teams anzeigt, in denen der Benutzer Mitglied ist.For example, Microsoft Teams will show teams that the user is either a member or an owner of, while the Microsoft Teams PowerShell cmdlets and the /me/joinedTeams API will only show teams the user is a member of. Um Verwirrung zu vermeiden, fügen Sie alle Besitzer auch zur Mitgliederliste hinzu.To avoid confusion, add all owners to the members list as well.

Bekanntes Problem: Wenn /groups/{Id}/owners LÖSCHEN aufgerufen wird, wird der Besitzer auch von der /groups/{Id}/members-Liste entfernt.Known issue: when DELETE /groups/{id}/owners is called, the user is also removed from the /groups/{id}/members list. Um dieses Problem zu umgehen, sollten Sie den Benutzer sowohl aus der Besitzer- als auch aus der Mitgliederliste entfernen, 10 Sekunden warten, und ihn dann wieder zur Liste der Mitglieder hinzufügen.To work around this, we recommend that you remove the user from both owners and members, then wait 10 seconds, then add them back to members.

Fassen Sie die ID beim Hinzufügen und Entfernen von Mitgliedern und Besitzern nicht in geschweifte Klammern {} ein.When adding and removing members and owners, don't put braces { } around the ID.

GeschwindigkeitSpeed SyntaxSyntax
SchnellFast https://graph.microsoft.com/beta/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/members/48d31887-5fad-4d73-a9f5-3c356e68a038/$refhttps://graph.microsoft.com/beta/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/members/48d31887-5fad-4d73-a9f5-3c356e68a038/$ref
LangsamSlow https://graph.microsoft.com/beta/groups/{02bd9fd6-8f93-4758-87c3-1fb73740a315}/members/{48d31887-5fad-4d73-a9f5-3c356e68a038}/$refhttps://graph.microsoft.com/beta/groups/{02bd9fd6-8f93-4758-87c3-1fb73740a315}/members/{48d31887-5fad-4d73-a9f5-3c356e68a038}/$ref

Wenn userId in der URL oder Nutzlast als UPN und nicht als GUID ausgedrückt wird, ist die Leistung geringer.Similarly, if the userId in the URL or payload is expressed as a UPN rather than as a GUID, the performance will be slower.

GeschwindigkeitSpeed SyntaxSyntax
SchnellFast 48d31887-5fad-4d73-a9f5-3c356e68a03848d31887-5fad-4d73-a9f5-3c356e68a038
LangsamSlow john@example.comjohn@example.com

Wenn der langsamere Pfad ausgewählt wird und ein aktuelles Teammitglied oder ein Besitzer bei der Microsoft Teams-Anwendung/Website angemeldet ist, wird die Änderung innerhalb einer Stunde angezeigt.When the slower path is taken, if a current team member or owner is signed in to the Microsoft Teams application/website, the change will be reflected within an hour. Wenn keiner dieser Benutzer bei der Microsoft Teams- Anwendung/Website angemeldet ist, wird die Änderung erst eine Stunde nachdem sich einer dieser Benutzer angemeldet hat sichtbar.If none of those users are signed in to the Microsoft Teams application/website, the change will not be reflected until an hour after one of them signs in.

Siehe auchSee also

Übersicht über Microsoft Teams-APIsMicrosoft Teams API overview