Listar todas as equipes do Microsoft Teams para uma organizaçãoList all teams in Microsoft Teams for an organization

Para listar todas as equipes em uma organização (locatário), você deve localizar todos os grupos que possuem equipes e, em seguida, obter informações de cada equipe.To list all teams in an organization (tenant), you find all groups that have teams, and then get information for each team.

Obter uma lista de gruposGet a list of groups

Para obter uma lista de todos os grupos da organização que possuem equipes, obtenha uma lista de todos os grupos e depois, em código, localize os que têm a propriedade resourceProvisioningOptions que contém “Equipe”.To get a list of all groups in the organization that have teams, get a list of all groups and then in code find the ones that have a resourceProvisioningOptions property that contains "Team". Como os grupos são objetos grandes, use $select para obter as propriedades apenas do grupo que importa para você.Since groups are large objects, use $select to only get the properties of the group you care about.

GET /groups?$select=id,resourceProvisioningOptions

Observação: certas equipes antigas não utilizadas não terão a configuração resourceProvisioningOptions.Note: Certain unused old teams will not have resourceProvisioningOptions set. Para saber mais, confira problemas conhecidos.For details, see known issues.

Este é um exemplo de resposta.The following is an example of the response.

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

{
    "@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"
            ]
        }
    ]
}

Obter uma lista de grupos usando as APIs betaGet a list of groups using beta APIs

Usando as APIs beta, você pode usar $filter para retornar apenas os grupos que possuem equipes.Using the beta APIs, you can use $filter to return only the groups that have teams.

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

Observação: a filtragem de grupos por resourceProvisioningOptions só está disponível por meio do ponto de extremidade beta.Note: Filtering groups by resourceProvisioningOptions is only available through the beta endpoint. resourceProvisioningOptions está disponível na versão 1.0 e beta.resourceProvisioningOptions is available in v1.0 and beta.

Observação: certas equipes antigas não utilizadas não serão listadas.Note: Certain unused old teams will not be listed. Para saber mais, confira problemas conhecidos.For details, see known issues.

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto de resposta mostrado aqui pode ser encurtado com fins de legibilidade.Note: The response object shown might be shortened for readability. Todas as propriedades serão retornadas de uma chamada real.All the properties will be returned from an actual call.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$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"
        }
    ]
}

Obter informações de equipe para um grupoGet team information for a group

Para obter informações de equipe para a equipe de um grupo específico, chame a API get team e incluam a ID do grupo.To get team information for the team in a particular group, call the get team API and include the group ID.

GET /teams/{group-id}

O exemplo a seguir mostra a resposta.The following example shows the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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

{
  "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
  }
}

Confira tambémSee also