team-Ressourcentyp
Namespace: microsoft.graph
Ein Team in Microsoft Teams ist eine Sammlung von Kanal-Objekten. Ein Kanal stellt ein Thema und somit eine logische Trennung einer Unterhaltung in einem Team dar.
Jedes Team ist einer Microsoft 365-Gruppe zugeordnet.
Die Gruppe hat die gleiche ID wie das Team – /groups/{id}/team ist z. B. identisch mit /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.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Team erstellen | teamsAsyncOperation | Erstellen eines von Grund auf neuen Teams. |
| Team aus Gruppe erstellen | team | Erstellen eines neuen Teams oder Hinzufügen eines Teams zu einer vorhandenen Microsoft 365-Gruppe. |
| Team abrufen | team | Abrufen der Eigenschaften und Beziehungen des angegebenen Teams. |
| Team aktualisieren | team | Aktualisieren der Eigenschaften des angegebenen Teams. |
| Team löschen | Keine | Löschen des Teams und der zugehörigen Gruppe. |
| Mitglieder auflisten | conversationMember-Sammlung | Mitgliederliste des Teams abrufen. |
| Add member | conversationMember | Neues Mitglied zum Team hinzufügen. |
| Massenhinzufügen von Mitgliedern | actionResultPart-Sammlung | Hinzufügen von mehreren Mitgliedern zu dem Team im Rahmen einer einzigen Anforderung. |
| Mitglied abrufen | conversationMember-Sammlung | Mitglied des Teams abrufen. |
| Rolle eines Mitglieds aktualisieren | conversationMember | Ändern einer Rolle zu „Besitzer“ oder zurück zu „reguläres Mitglied“. |
| Mitglied entfernen | Keine | Vorhandenes Mitglied aus dem Team entfernen. |
| Team archivieren | teamsAsyncOperation | Versetzen des Teams in einen schreibgeschützten Zustand. |
| Archivierung von Team aufheben | teamsAsyncOperation | Zurückversetzen des Teams in den Zustand Lesen/Schreiben. |
| Team klonen | teamsAsyncOperation | Kopieren des Teams und der zugehörigen Gruppe. |
| Ihre Teams auflisten | team-Sammlung | Auflisten der Teams, in denen Sie Mitglied sind. |
| Migration abschließen | team | Der Migrationsmodus wird vom Team entfernt, und das Team wird den Benutzern zur Verfügung gestellt, um Nachrichten bereitzustellen und zu lesen. |
| Im Team installierte Apps auflisten | teamsAppInstallation-Sammlung | In einem Team installierte Apps auflisten. |
| App zu Team hinzufügen | Keine | Fügen Sie eine App (durch Installation) zu einem Team hinzu. |
| Im Team installierte App abrufen | teamsAppInstallation | Rufen Sie die angegebene in einem Team installierte App auf. |
| Im Team installierte App aktualisieren | Keine | Aktualisieren Sie die in einem Team installierte App auf die neueste Version. |
| App aus Team entfernen | Keine | Entfernen Sie eine App (durch Deinstallation) aus einem Team. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| displayName | string | Der Name des Teams. |
| description | string | Eine optionale Beschreibung für das Team. Maximale Länge: 1024 Zeichen. |
| classification | string | Eine optionale Bezeichnung. Beschreibt in der Regel die Daten- oder Geschäftssensitivität des Teams. Muss mit einem der im Verzeichnis des Mandanten vorkonfigurierten Sätze übereinstimmen. |
| specialization | teamSpecialization | Optional. Gibt an, ob das Team für einen bestimmten Anwendungsfall vorgesehen ist. Jede Teamspezialisierung hat Zugriff auf eindeutige Verhaltensweisen und Oberflächen, die auf den Anwendungsfall zugeschnitten sind. |
| visibility | teamVisibilityType | Die Sichtbarkeit der Gruppe und des Teams. Standardwert: „Öffentlich“. |
| funSettings | teamFunSettings | Einstellungen zum Konfigurieren der Verwendung von Giphy, Memen und Aufklebern im Team. |
| guestSettings | teamGuestSettings | Einstellungen zum Konfigurieren, ob Gäste Kanäle im Team erstellen, aktualisieren oder löschen können. |
| internalId | Zeichenfolge | Eine eindeutige ID für das Team, das an einigen Stellen verwendet wurde, zum Beispiel Überwachungsprotokoll/Office 365-Verwaltungsaktivitäts-API. |
| isArchived | Boolesch | Gibt an, ob sich das Team im schreibgeschützten Modus befindet. |
| memberSettings | teamMemberSettings | Einstellungen zum Konfigurieren, ob Mitglieder bestimmte Aktionen, z. B. Kanäle erstellen und Bots hinzufügen, im Team ausführen können. |
| messagingSettings | teamMessagingSettings | Einstellungen zum Konfigurieren von Messaging und Erwähnungen im Team. |
| webUrl | string (schreibgeschützt) | Ein Link, der im Microsoft Teams-Client zu dem Team führt. 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. Diese URL sollte als nicht transparenter Blob behandelt und nicht analysiert werden. |
| createdDateTime | dateTimeOffset | Zeitstempel für den Zeitpunkt, an dem das Team erstellt wurde. |
Instanzenattribute
Instanzenattribute sind Eigenschaften mit speziellem Verhalten. Diese Eigenschaften sind temporär. Sie definieren entweder, wie sich der Dienst verhalten soll, oder geben kurzfristige Eigenschaftswerte an, beispielsweise URLs zum Elementdownload, die ablaufen.
| Eigenschaftenname | Typ | Beschreibung |
|---|---|---|
| @microsoft.graph.teamCreationMode | Zeichenfolge | Gibt an, dass sich das Team im Migrationszustand befindet und zurzeit für Migrationszwecke verwendet wird. Akzeptiert einen Wert: migration. Hinweis: Microsoft kann in Zukunft von Ihnen oder Ihren Kunden fordern, basierend auf der Menge der importierten Daten, zusätzliche Gebühren zu zahlen. |
Ein Beispiel für eine POST-Anforderung finden Sie unter Anforderung (Team im Migrationszustand erstellen).
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| channels | channel-Sammlung | Die Sammlung von Kanälen und Nachrichten, die dem Team zugeordnet sind. |
| installedApps | teamsAppInstallation-Sammlung | Die in diesem Team installierten Apps. |
| members | conversationMember-Sammlung | Mitglieder und Besitzer des Teams. |
| operations | teamsAsyncOperation-Auflistung | Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden. |
| primaryChannel | channel | Der allgemeine Kanal für das Team. |
| Zeitplan | Zeitplan | Der Schichtzeitplan für dieses Team. |
| photo | profilePhoto | Das Profilfoto für das Team. |
| template | teamsTemplate | Die Vorlage, von der dieses Team erstellt wurde. Weitere Informationen unter verfügbaren Vorlagen. |
JSON-Darstellung
Es folgt eine JSON-Darstellung der Ressource.
Hinweis: wenn das Team den Typ „Klasse“ hat, wird eine classSettings-Eigenschaft auf das Team angewendet.
{
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"internalId": "string",
"isArchived": false,
"webUrl": "string (URL)",
"classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
"createdDateTime": "dateTimeOffset"
}
Weitere Informationen:
Feedback
Feedback senden und anzeigen für