Auflisten aller Teams einer Organisation in Microsoft Teams

  • Artikel

Wenn Sie die Microsoft Teams-API in Microsoft Graph verwenden möchten, um alle Teams in einer Organisation (Mandant) aufzulisten, suchen Sie alle Gruppen mit Teams, und rufen Sie dann Informationen für jedes Team ab.

Abrufen einer Liste von Gruppen

Beispiel 1: Abrufen einer Liste von Gruppen, die ein Team enthalten

Um eine Liste aller Gruppen in der Organisation abzurufen, die Teams enthalten, rufen Sie eine Liste aller Gruppen ab, und suchen Sie dann im Code diejenigen Gruppen, deren Eigenschaft resourceProvisioningOptions „Team“ enthält.

Verwenden Sie die API mit $filter, um nur die Gruppen zurückzugeben, die über Teams verfügen.

Anforderung

GET /groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team')

Hinweis

Für bestimmte nicht verwendete alte Teams ist resourceProvisioningOptions nicht festgelegt. Einzelheiten hierzu finden Sie unter Bekannte Probleme.

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das gezeigte Antwortobjekt wurde möglicherweise zur besseren Lesbarkeit gekürzt.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups",
    "value": [
        {
            "id": "02bd9fd6-8f93-4758-87c3-1fb73740a315",
            "description": "Welcome to the HR Taskforce team.",
            "displayName": "HR Taskforce",
            "groupTypes": [
                "Unified"
            ],
            "mailEnabled": true,
            "mailNickname": "HRTaskforce",
            "resourceBehaviorOptions": [],
            "resourceProvisioningOptions": [
                "Team"
            ],
            "securityEnabled": false,
            "visibility": "Private"
        },
        {
            "id": "8090c93e-ba7c-433e-9f39-08c7ba07c0b3",
            "description": "Welcome to the team that we've assembled to launch our product.",
            "displayName": "X1050 Launch Team",
            "groupTypes": [
                "Unified"
            ],
            "mailEnabled": true,
            "mailNickname": "X1050LaunchTeam",
            "resourceBehaviorOptions": [],
            "resourceProvisioningOptions": [
                "Team"
            ],
            "securityEnabled": false,
            "visibility": "Private"
        }
    ]
}

Beispiel 2: Abrufen einer Liste von Gruppen durch Auswählen nur erforderlicher Eigenschaften

Da Gruppen große Objekte sind, verwenden Sie $select, um nur die Eigenschaften der Gruppe abzurufen, die Ihnen wichtig ist.

Anforderung

GET /groups?$select=id,resourceProvisioningOptions

Hinweis

Für bestimmte nicht verwendete alte Teams ist resourceProvisioningOptions nicht festgelegt. Einzelheiten hierzu finden Sie unter Bekannte Probleme.

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups",
    "value": [
        {
            "id": "00e897b1-70ba-4cb9-9126-fd5f95c4bb78",
            "resourceProvisioningOptions": []
        },
        {
            "id": "00f6e045-f884-4359-a617-d459ee626862",
            "resourceProvisioningOptions": [
                "Team"
            ]
        }
    ]
}

Abrufen von Teaminformationen für eine Gruppe

Um Teaminformationen für das Team in einer bestimmten Gruppe abzurufen, rufen Sie die get team-API auf, und schließen Sie die Gruppen-ID ein.

Anforderung

GET /teams/{group-id}

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

{
  "isArchived" : false,
  "memberSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true,
    "allowAddRemoveApps": true,
    "allowCreateUpdateRemoveTabs": true,
    "allowCreateUpdateRemoveConnectors": true    
  },
  "guestSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true 
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true,
    "allowOwnerDeleteMessages": true,
    "allowTeamMentions": true,
    "allowChannelMentions": true    
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict",
    "allowStickersAndMemes": true,
    "allowCustomMemes": true
  }
}

Verwandte Inhalte