team-Ressourcentypteam resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen 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.

Ein Team in Microsoft Teams ist eine Sammlung von Kanal-Objekten.A team in Microsoft Teams is a collection of channel objects. Ein Kanal stellt ein Thema und somit eine logische Trennung einer Unterhaltung in einem Team dar.A channel represents a topic, and therefore a logical isolation of discussion, within a team.

Jedes Team wird einer Gruppe zugeordnet.Every team is associated with a group. Die Gruppe hat die gleiche ID wie das Team – /groups/{id}/team ist z. B. identisch mit /teams/{id}.The group has the same ID as the team - for example, /groups/{id}/team is the same as /teams/{id}. Weitere Informationen zum Arbeiten mit Gruppen und Mitgliedern in Teams finden Sie unter Verwenden der Microsoft Graph REST-API zum Arbeiten mit Microsoft Teams.For more information about working with groups and members in teams, see Use the Microsoft Graph REST API to work with Microsoft Teams.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Team erstellenCreate team teamsAsyncOperationteamsAsyncOperation Erstellen eines von Grund auf neuen Teams.Create a team from scratch.
Team aus Gruppe erstellenCreate team from group teamteam Erstellen eines neuen Teams oder Hinzufügen eines Teams zu einer vorhandenen Gruppe.Create a new team, or add a team to an existing group.
Team abrufenGet team teamteam Abrufen der Eigenschaften und Beziehungen des angegebenen Teams.Retrieve the properties and relationships of the specified team.
Team aktualisierenUpdate team teamteam Aktualisieren der Eigenschaften des angegebenen Teams.Update the properties of the specified team.
Team löschenDelete team KeineNone Löschen des Teams und der zugehörigen Gruppe.Delete the team and its associated group.
Team klonenClone team teamsAsyncOperationteamsAsyncOperation Kopieren des Teams und der zugehörigen Gruppe.Copy the team and its associated group.
Team archivierenArchive team teamsAsyncOperationteamsAsyncOperation Versetzen des Teams in einen schreibgeschützten Zustand.Put the team in a read-only state.
Archivierung von Team aufhebenUnarchive team teamsAsyncOperationteamsAsyncOperation Zurückversetzen des Teams in den Zustand Lesen/Schreiben.Restore the team to a read-write state.
Ihre Teams auflistenList your teams team-Sammlungteam collection Auflisten der Teams, in denen Sie Mitglied sind.List the teams you are a member of.
Auflisten aller TeamsList all teams group-Sammlunggroup collection Auflisten aller Gruppen, die über Teams verfügen.List all groups that have teams.
Get Team-Foto abrufenGet team photo BinärdatenBinary data Abrufen des Fotos (Bildes) für ein Team.Get the photo (picture) for a team.
Team-Foto aktualisierenUpdate team photo KeineNone Abrufen des Fotos (Bildes) für ein Team.Update the photo (picture) for a team.
Apps in Ihrer Organisation veröffentlichenPublish apps to your organization teamsAppteamsApp Erstellen von Teams-Apps, die nur für Ihre Organisation sichtbar sind.Create Teams apps visible only to your organization.
App zu Team hinzufügenAdd app to team teamsAppInstallationteamsAppInstallation Hinzufügen (Installieren) einer App zu einem Team.Adds (installs) an app to a team.
Registerkarte zu Kanal hinzufügenAdd tab to channel teamsTabteamsTab Hinzufügen (Installieren) einer Registerkarte zum Kanal des Teams.Adds (installs) a tab to a team's channel.
Kanalnachrichten auflistenList channel messages chatMessagechatMessage Abrufen von Nachrichten in einem KanalGet messages in a channel
Eine chatMessage in einem Kanal erstellenCreate chatMessage in a channel chatMessagechatMessage Eine Nachricht an einen Kanal senden.Send a message to a channel.
Antwort auf chatMessage in einem Kanal erstellenCreate chatMessage reply in a channel chatMessagechatMessage Auf eine Nachricht in einem Kanal antworten.Reply to a message in a channel.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
displayNamedisplayName stringstring Der Name des Teams.The name of the team.
descriptiondescription stringstring Eine optionale Beschreibung für das Team.An optional description for the team.
classificationclassification stringstring Eine optionale Bezeichnung.An optional label. Beschreibt in der Regel die Daten- oder Geschäftssensitivität des Teams.Typically describes the data or business sensitivity of the team. Muss mit einem der im Verzeichnis des Mandanten vorkonfigurierten Sätze übereinstimmen.Must match one of a pre-configured set in the tenant's directory.
specializationspecialization teamSpecializationteamSpecialization Optional.Optional. Gibt an, ob das Team für einen bestimmten Anwendungsfall vorgesehen ist.Indicates whether the team is intended for a particular use case. Jede Teamspezialisierung hat Zugriff auf eindeutige Verhaltensweisen und Oberflächen, die auf den Anwendungsfall zugeschnitten sind.Each team specialization has access to unique behaviors and experiences targeted to its use case.
visibilityvisibility teamVisibilityTypeteamVisibilityType Die Sichtbarkeit einer Gruppe und eines Teams.The visibility of a the group and team. Der Standardwert ist „öffentlich“.Defaults to Public.
funSettingsfunSettings teamFunSettingsteamFunSettings Einstellungen zum Konfigurieren der Verwendung von Giphy, Memen und Aufklebern im Team.Settings to configure use of Giphy, memes, and stickers in the team.
guestSettingsguestSettings teamGuestSettingsteamGuestSettings Einstellungen zum Konfigurieren, ob Gäste Kanäle im Team erstellen, aktualisieren oder löschen können.Settings to configure whether guests can create, update, or delete channels in the team.
internalIdinternalId Zeichenfolgestring Eine eindeutige ID für das Team, das an einigen Stellen verwendet wurde, zum Beispiel Überwachungsprotokoll/Office 365-Verwaltungsaktivitäts-API.A unique ID for the team that has been used in a few places such as the audit log/Office 365 Management Activity API.
isArchivedisArchived BooleschBoolean Gibt an, ob sich das Team im schreibgeschützten Modus befindet.Whether this team is in read-only mode.
memberSettingsmemberSettings teamMemberSettingsteamMemberSettings Einstellungen zum Konfigurieren, ob Mitglieder bestimmte Aktionen, z. B. Kanäle erstellen und Bots hinzufügen, im Team ausführen können.Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
messagingSettingsmessagingSettings teamMessagingSettingsteamMessagingSettings Einstellungen zum Konfigurieren von Messaging und Erwähnungen im Team.Settings to configure messaging and mentions in the team.
discoverySettingsdiscoverySettings teamDiscoverySettingsteamDiscoverySettings Einstellungen zum Konfigurieren der Team-Auffindbarkeit durch andere Personen.Settings to configure team discoverability by others.
webUrlwebUrl string (schreibgeschützt)string (readonly) Ein Link, der im Microsoft Teams-Client zu dem Team führt.A hyperlink that will go to the team in the Microsoft Teams client. Dies ist die URL, die Sie erhalten, wenn Sie im Microsoft Teams-Client mit der rechten Maustaste auf ein Team klicken und Link zum Team abrufen auswählen.This is the URL that you get when you right-click a team in the Microsoft Teams client and select Get link to team. Diese URL sollte als nicht transparenter Blob behandelt und nicht analysiert werden.This URL should be treated as an opaque blob, and not parsed.
classSettingsclassSettings teamClassSettingsteamClassSettings Konfigurieren von Einstellungen einer Klasse.Configure settings of a class. Nur verfügbar, wenn das Team eine Klasse darstellt.Available only when the team represents a class.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
channelschannels channel-Sammlungchannel collection Die Sammlung von Kanälen und Nachrichten, die mit dem Team verknüpft ist.The collection of channels & messages associated with the team.
installedAppsinstalledApps teamsAppInstallation-SammlungteamsAppInstallation collection Die in diesem Team installierten Apps.The apps installed in this team.
ownersowners useruser Die Liste der Besitzer des Teams.The list of this team's owners. Derzeit muss beim Erstellen eines Teams mit Anwendungsberechtigungen genau ein Besitzer angegeben werden.Currently, when creating a team using application permissions, exactly one owner must be specified. Bei Verwendung von benutzerdelegierten Berechtigungen kann kein Besitzer angegeben werden (der aktuelle Benutzer ist der Besitzer).When using user delegated permissions, no owner can be specified (the current user is the owner). Der Besitzer muss als Objekt-ID (GUID) und nicht als UPN angegeben werden.Owner must be specified as an object ID (GUID), not a UPN.
operationsoperations teamsAsyncOperation-AuflistungteamsAsyncOperation collection Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden.The async operations that ran or are running on this team.
primaryChannelprimaryChannel channelchannel Der allgemeine Kanal für das Team.The general channel for the team.
Zeitplanschedule Zeitplanschedule Der Schichtzeitplan für dieses Team.The schedule of shifts for this team.
templatetemplate teamsTemplateteamsTemplate Die Vorlage, von der dieses Team erstellt wurde.The template this team was created from. Siehe Verfügbare Vorlagen.See available templates.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

Hinweis: wenn das Team den Typ „Klasse“ hat, wird eine classSettings-Eigenschaft auf das Team angewendet.Note: If the team is of type class, a classSettings property is applied on the team.

{
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "displayName": "string",
  "description": "string",
  "classification": "string",
  "specialization": "string",
  "visibility": "string",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"}
}

Siehe auchSee Also