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 |
|---|---|---|
| Create | 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. |
| Get | team | Abrufen der Eigenschaften und Beziehungen des angegebenen Teams. |
| Update | team | Aktualisieren der Eigenschaften des angegebenen Teams. |
| 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. |
| Abrufen des primären Kanals | channel | Der allgemeine Kanal für das Team. |
| Update member | conversationMember | Ändern einer Rolle zu „Besitzer“ oder zurück zu „reguläres Mitglied“. |
| Mitglied entfernen | Keine | Vorhandenes Mitglied aus dem Team entfernen. |
| Mehrere Mitglieder gleichzeitig entfernen | actionResultPart-Sammlung | Entfernen mehrerer Mitglieder aus einem Team in einer einzigen Anforderung. |
| 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 | Listen Sie die Teams auf, in der Sie Mitglied sind. |
| Zugeordnete Teams auflisten | associatedTeamInfoAuflistung | Rufen Sie die Liste der Teams in Microsoft Teams ab, denen ein Benutzer zugeordnet ist. |
| Auflisten aller Teams in einer Organisation | team-Sammlung | Listet alle Teams in einer Organisation auf. |
| Migration für ein Team 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. |
| Auflisten aller Kanäle | channel-Sammlung | Rufen Sie die Liste der Kanäle ab, die entweder in diesem Team sind oder mit diesem Team geteilt werden (eingehende Kanäle). |
| List channels | channel-Auflistung | Abrufen der Liste der Kanäle in einem Team. |
| Eingehende Kanäle auflisten | channel-Sammlung | Rufen Sie die Liste der eingehenden Kanäle ab (Kanäle, die mit einem Team geteilt werden). |
| Entfernen eines eingehenden Kanals | Keines | Entfernen eines eingehenden Kanals (eines Kanals, der für ein Team freigegeben wurde) aus einem Team. |
| Apps im Team 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. |
| Berechtigungserteilungen auflisten | resourceSpecificPermissionGrant-Sammlung | Listen Sie Berechtigungen auf, die Apps für den Zugriff auf das Team gewährt wurden. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | string | Der eindeutige Bezeichner des Teams. Die Gruppe hat dieselbe ID wie das Team. Diese Eigenschaft ist schreibgeschützt und wird vom Basisentitätstyp geerbt. |
| classification | string | Eine optionale Bezeichnung. Beschreibt in der Regel die Daten- oder Geschäftssensitivität des Teams. Muss mit einem vorkonfigurierten Satz im Verzeichnis des Mandanten übereinstimmen. |
| classSettings | teamClassSettings | Konfigurieren von Einstellungen einer Klasse. Nur verfügbar, wenn das Team eine Klasse darstellt. |
| createdDateTime | dateTimeOffset | Zeitstempel für den Zeitpunkt, an dem das Team erstellt wurde. |
| description | string | Eine optionale Beschreibung für das Team. Maximale Länge: 1.024 Zeichen. |
| displayName | string | Der Name des Teams. |
| 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, die an einigen Stellen verwendet wurde, z. B. im Ü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. |
| 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. |
| Zusammenfassung | teamSummary | Enthält zusammenfassende Informationen über das Team, einschließlich der Anzahl der Besitzer, Mitglieder und Gäste. |
| tenantId | string | Die ID des Microsoft Entra Mandanten. |
| visibility | teamVisibilityType | Die Sichtbarkeit der Gruppe und des Teams. Der Standardwert ist „öffentlich“. |
| webUrl | string (schreibgeschützt) | Ein Link, der an das Team im Microsoft Teams-Client geht. Sie erhalten diese URL, 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. |
Instanzenattribute
Instanzattribute sind Eigenschaften mit besonderem Verhalten. Diese Eigenschaften sind temporär. Sie definieren entweder das Verhalten, das der Dienst ausführen soll, oder stellen kurzfristige Eigenschaftswerte bereit, z. B. eine Download-URL für ein element, das abläuft.
| 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: In Zukunft kann Microsoft verlangen, dass Sie oder Ihre Kunden zusätzliche Gebühren basierend auf der Menge der importierten Daten zahlen. |
Ein Beispiel für eine POST-Anforderung finden Sie unter Anforderung (Team im Migrationszustand erstellen).
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| allChannels | channel-Sammlung | Liste der Kanäle, die entweder im Team gehostet oder für das Team freigegeben wurden (eingehende Kanäle). |
| channels | channel-Sammlung | Die Sammlung von Kanälen und Nachrichten, die dem Team zugeordnet sind. |
| incomingChannels | channel-Sammlung | Liste der Kanäle, die für das Team freigegeben 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. |
| Foto | profilePhoto | Das Profilfoto für das Team. |
| primaryChannel | channel | Der allgemeine Kanal für das Team. |
| Zeitplan | Zeitplan | Der Schichtzeitplan für dieses Team. |
| tags | teamworkTag-Sammlung | Die Tags, die dem Team zugeordnet sind. |
| template | teamsTemplate | Die Vorlage, von der dieses Team erstellt wurde. Siehe Verfügbare Vorlagen. |
| permissionGrants | resourceSpecificPermissionGrant-Sammlung | Eine Sammlung von Berechtigungen, die Apps erteilt wurden, um auf das Team zuzugreifen. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
Hinweis: wenn das Team den Typ „Klasse“ hat, wird eine classSettings-Eigenschaft auf das Team angewendet.
{
"classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
"classification": "String",
"createdDateTime": "DateTimeOffset",
"description": "String",
"displayName": "String",
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"internalId": "String",
"isArchived": "Boolean",
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"specialization": "String",
"tenantId": "String",
"visibility": "String",
"webUrl": "String (URL)"
}