Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Rufen Sie die Liste der Teams in Microsoft Teams ab, denen ein Benutzer zugeordnet ist. Derzeit kann ein Benutzer einem Team auf zwei verschiedene Arten zugeordnet werden:
- Ein Benutzer kann ein direktes Mitglied eines Teams sein.
- Ein Benutzer kann Mitglied eines freigegebenen Kanals sein, der in einem Team gehostet wird.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Team.ReadBasic.All | TeamSettings.Read.All, TeamSettings.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Anwendung | Team.ReadBasic.All | TeamSettings.Read.All, TeamSettings.ReadWrite.All |
Hinweis: Derzeit funktioniert dieser Vorgang mit delegierten Benutzerberechtigungen nur für den Benutzer
me. Mit Anwendungsberechtigungen funktioniert der Vorgang für alle Benutzer, indem die ID des bestimmten Benutzers angegeben wird (Aliasmewird mit Anwendungsberechtigungen nicht unterstützt).
HTTP-Anforderung
GET /users/{user-id}/teamwork/associatedTeams
Optionale Abfrageparameter
Diese Methode unterstützt derzeit nicht die OData-Abfrageparameter zum Anpassen der Antwort.
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von associatedTeamInfo-Objekten im Antworttext zurückgegeben.
Hinweis: Diese API gibt auch das Host-Team des freigegebener Kanals zurück, in dem der Benutzer ein direktes Mitglied ist.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/me/teamwork/associatedTeams
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.associatedTeamInfo",
"id": "b695c5a5-c5a5-b695-a5c5-95b6a5c595b6",
"tenantId": "172b0cce-e65d-7hd4-9a49-91d9f2e8493a",
"displayName": "Contoso Team"
},
{
"@odata.type": "#microsoft.graph.associatedTeamInfo",
"id": "b695c5a5-8934-b695-a5c5-95b6a5c595b6",
"tenantId": "172b0cce-8961-7hd4-9a49-91d9f2e8493a",
"displayName": "Fabrikam Team"
}
]
}