team-Ressourcentyp
Namespace: microsoft.graph
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.
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. |
| Entfernen von Mitgliedern in einem Massenvorgang | 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 | Abrufen der Liste derassociatedTeamInfoObjekte in Microsoft Teams, denen einBenutzerzugeordnet ist. |
| Auflisten aller Teams in einer Organisation | team-Sammlung | Listet alle Teams in einer Organisation auf. |
| Get Team-Foto abrufen | Binärdaten | Abrufen des Fotos (Bildes) für ein Team. |
| 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 Kanäle ab, die mit diesem 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. |
| Offene Schichten für alle beigetretenen Teams abrufen | openShift-Sammlung | Abrufen aller openShift-Objekte in allen Teams, in der ein Benutzer ein direktes Mitglied ist. |
| Schichten aller beigetretenen Teams abrufen | Shift-Sammlung | Abrufen aller Schichtobjekte in allen Teams, in der ein Benutzer ein direktes Mitglied ist. |
| Arbeitsfreie Zeiten für alle beigetretenen Teams abrufen | timeOff-Sammlung | Abrufen aller timeOff-Objekte in allen Teams, in der ein Benutzer ein direktes Mitglied ist. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| classSettings | teamClassSettings | Konfigurieren von Einstellungen einer Klasse. Nur verfügbar, wenn das Team eine Klasse darstellt. |
| 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. |
| 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. |
| discoverySettings | teamDiscoverySettings | Einstellungen zum Konfigurieren der Team-Auffindbarkeit durch andere Personen. |
| displayName | string | Der Name des Teams. |
| funSettings | teamFunSettings | Einstellungen zum Konfigurieren der Verwendung von Giphy, Memes und Aufklebern im Team. |
| guestSettings | teamGuestSettings | Einstellungen zum Konfigurieren, ob Gäste Kanäle im Team erstellen, aktualisieren oder löschen können. |
| 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. |
| internalId | Zeichenfolge | Eine eindeutige ID für das Team, die an einigen Stellen verwendet wird, z. B. in der Überwachungsprotokoll-/Office 365-Verwaltungsaktivitäts-API. |
| isArchived | Boolesch | Gibt an, ob sich das Team im schreibgeschützten Modus befindet. |
| isMembershipLimitedToOwners | Boolescher Wert | Wenn diese Einstellung auf truefestgelegt ist, befindet sich das Team derzeit im Status "Nur-Besitzer"- Teammitgliedschaft und kann von anderen Teammitgliedern, z. B. Kursteilnehmern, nicht zugegriffen werden. |
| 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 Zusammenfassungsinformationen zum Team, einschließlich der Anzahl von Besitzern, Mitgliedern und Gästen. |
| 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. 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. |
Instanzenattribute
Instanzattribute sind Eigenschaften mit besonderem Verhalten. Diese Eigenschaften sind temporär und definieren entweder a) das Verhalten, das der Dienst ausführen soll, oder b) 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 in einem Migrationszustand befindet und derzeit 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 |
|---|---|---|
| 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. |
| owners | user | Die Liste der Besitzer des Teams. Derzeit muss beim Erstellen eines Teams mit Anwendungsberechtigungen genau ein Besitzer angegeben werden. Bei Verwendung von vom Benutzer delegierten Berechtigungen kann kein Besitzer angegeben werden (der aktuelle Benutzer ist der Besitzer). Der Besitzer muss als Objekt-ID (GUID) und nicht als UPN angegeben werden. |
| operations | teamsAsyncOperation-Auflistung | Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden. |
| Foto | profilePhoto | Das Team-Foto. |
| primaryChannel | channel | Der allgemeine Kanal für das Team. |
| Zeitplan | Zeitplan | Der Schichtzeitplan für dieses Team. |
| template | teamsTemplate | Die Vorlage, von der dieses Team erstellt wurde. Siehe Verfügbare Vorlagen. |
| templateDefinition | teamtemplatedefinition | Generische Darstellung einer Teamvorlagendefinition für ein Team mit einer bestimmten Struktur und Konfiguration. |
| permissionGrants | resourceSpecificPermissionGrant-Sammlung | Eine Sammlung von Berechtigungen, die Apps erteilt wurden, um auf das Team zuzugreifen. |
| tags | teamworkTag-Sammlung | Die Tags, die dem Team zugeordnet sind. |
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",
"discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
"displayName": "String",
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"id": "String (identifier)",
"internalId": "String",
"isArchived": "Boolean",
"isMembershipLimitedToOwners": "Boolean",
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"specialization": "String",
"summary": {"@odata.type": "microsoft.graph.teamSummary"},
"tenantId": "String",
"visibility": "String",
"webUrl": "String (URL)"
}