Criar equipes e gerenciar membros usando o Microsoft GraphCreating teams and managing members using Microsoft Graph

Você pode usar a API do Microsoft Teams no Microsoft Graph para criar equipes de várias maneiras.You can use the Microsoft Teams API in Microsoft Graph to create teams in multiple ways. Este artigo descreve a abordagem que recomendamos para obter os melhores resultados.This article describes the approach that we recommend for the best results.

Criação da equipe inicialInitial team creation

Todas as equipes têm o respaldo de grupos do Microsoft 365.All teams are backed by Microsoft 365 groups. A maneira mais rápida de configurar e utilizar sua equipe ao criar novas equipes através do Microsoft Graph é configurar um novo grupo do Microsoft 365, todos os proprietários e membros e convertê-los em uma equipe.The quickest way to get your team up and running when you create new teams via Microsoft Graph is to set up a new Microsoft 365 group, all owners and members, and convert that into a team.

  1. Criar um grupo do Microsoft 365 usando a operação criar grupo.Create an Microsoft 365 group using the create group operation. Você pode especificar os proprietários e os membros.You can specify owners and members. Certifique-se de que tenha os proprietários certos do grupo recém-criado, conforme descrito na Etapa 2.Make sure that you have the right owners for the newly created group, as described in Step 2.

    Para criar uma equipe para esse grupo, é necessário definir os seguintes valores de propriedade, conforme mostrado:In order to create a team for this group, you need to set the following property values, as shown:

    • groupTypes = { "Unified" }groupTypes = { "Unified" }
    • mailEnabled = truemailEnabled = true
    • securityEnabled = falsesecurityEnabled = false
    POST /groups
    {
        "displayName":"Flight 157",
        "mailNickname":"flight157",
        "description":"Everything about flight 157",
        "visibility":"Private",
        "groupTypes":["Unified"],
        "mailEnabled":true,
        "securityEnabled":false,
        "members@odata.bind":[
            "https://graph.microsoft.com/v1.0/users/bec05f3d-a818-4b58-8c2e-2b4e74b0246d",
            "https://graph.microsoft.com/v1.0/users/ae67a4f4-2308-4522-9021-9f402ff0fba8",
            "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783",
            "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133"
        ],
        "owners@odata.bind":[
            "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133",
            "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783"
        ]
    }
    

    O exemplo a seguir mostra a resposta.The following example shows 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/v1.0/$metadata#groups/$entity",
        "id":"b7f968af-ca51-42f6-a77e-82c7147bc8f2"
    }
    
  2. Certifique-se de que o grupo tenha dois ou mais proprietários.Ensure the group has two or more owners. É possível fazer isso por meio da operação adicionar proprietário.You can do so via the add owner operation. Elas devem ser contas de usuários reais e não contas de serviço.These should be real user accounts and not service accounts. Ter dois proprietários ajuda a lidar com casos em que um proprietário sai da empresa ou não está disponível para realizar operações de gerenciamento de equipe.Having two owners helps handle cases where one owner leaves the company or is unavailable to perform team management operations.

  3. Adicione todos os membros (e convidados, se necessário) ao grupo usando a operação adicionar membro, caso não tenha feito isso na Etapa 1.Add all members (and guests if necessary) to the group using the add member operation, if you did not do so in Step 1. Se você estiver adicionando vários membros, adicione um atraso de 1 segundo após cada operação de adição.If you're adding multiple members, add a 1 second delay after each add operation.

  4. Depois que o grupo for criado com sucesso, o que pode levar até 15 minutos após a conclusão da Etapa 1, crie uma equipe do Microsoft Teams usando a operação criar equipe a partir de grupo.After the group is successfully created, which can take up to 15 minutes after completing Step 1, create a Microsoft Teams team using the create team from group operation. Se houver um erro, o processo de criação de grupo pode não ser concluído, tente esperar alguns minutos.If you run into an error, the group creation process might not be completed; try waiting a few more minutes.

    POST https://graph.microsoft.com/beta/teams
    Content-Type: application/json
    {
      "template@odata.bind": "https://graph.microsoft.com/beta/teamsTemplates('standard')",
      "group@odata.bind": "https://graph.microsoft.com/v1.0/groups('groupId')"
    }
    

    O exemplo a seguir mostra a resposta.The following example shows 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 202 Accepted
    Content-Type: application/json
    Location: /teams/{teamId}/operations/{operationId}
    Content-Location: /teams/{teamId}
    {
    }
    

    A equipe criada tem a mesma ID do que o grupo.The created team has the same ID as the group.

  5. Após concluir o processo, todos os proprietários e membros poderão ver a equipe recém-criada no cliente do Teams.After this process finishes, all owners and members should be able to see the newly created team in their Teams client.

Adicionar ou gerenciar membrosAdding or managing members

Para adicionar membros depois de criar uma equipe, use a operação adicionar membro.To add members after a team is created, you use the add member operation. É recomendável adicionar um atraso de 1 segundo entre as operações adicionar.We recommend adding a 1 second delay between add operations. Observe o seguinte em relação às alterações de associação:Note the following with respect to membership changes:

  1. As alterações de associação feitas nos grupos do Microsoft 365 são sincronizadas com o Teams por meio de um mecanismo de sincronização de tela de fundo que geralmente demora 24 horas ou mais, em alguns casos.Membership changes made to Microsoft 365 groups sync to Teams via a background sync mechanism that typically takes 24 hours (or more in some cases).

  2. O processo em segundo plano será acionado somente se um ou mais usuários na equipe (proprietário ou membro) estiverem ativos no cliente da área de trabalho do Teams.The background process is triggered only if one or more users in the team (owner or member) is active in the Teams desktop client. A inicialização do aplicativo Teams e/ou sua execução constitui atividade. Um usuário não precisa visitar especificamente a equipe que está sendo modificada.Launching the Teams application and/or having it running constitutes activity — a user does not need to visit the team that is being modified specifically.

    Observação: os clientes móveis do Teams não acionam a sincronização de associações. Pelo menos um usuário deve estar no cliente da área de trabalho para garantir que o processo em segundo plano corra bem.Note: The Teams mobile clients do not trigger the membership sync. At least one user should be on the desktop client to that ensure this background process goes smoothly.

Lista de verificação para validaçãoChecklist for validation

Depois de criar uma equipe, você pode usar a lista de verificação a seguir para verificar se a equipe foi criada com êxito.After you create a team, you can use the following checklist to verify that the team was created successfully.

Validar a criação de equipeValidate team creation

  1. Verifique se o grupo do Microsoft 365 que reforça a equipe foi criado por meio do Azure AD ou do centro de administração do Microsoft 365.Verify that the Microsoft 365 group backing the team is created via the Azure AD or Microsoft 365 admin centers.

  2. Verifique se a criação da equipe foi bem-sucedida por meio do portal de administração do Teams.Verify that the team creation succeeded via the Teams admin portal.

  3. Verifique se a equipe possui os proprietários e membros corretos listados por meio do portal de administração do Teams.Verify that the team has the correct owners and members listed via the Teams admin portal.

  4. Verifique se os proprietários da equipe conseguem ver a equipe após entrar no cliente da Web ou da área de trabalho do Teams.Verify that the team owners can see the team after signing into the Teams desktop or web client.

  5. Verifique se os membros conseguem ver a equipe após entrar no cliente da Web ou da área de trabalho do Teams.Verify that members can see the team after signing into the Teams desktop or web client.

Validar a adição de membrosValidate addition of members

  1. Verifique se os novos membros aparecem no grupo por meio do Azure AD ou do centro de administração do Microsoft 365.Verify that newly members show up in the group via the Azure AD or Microsoft 365 admin center.

  2. Verifique se os membros recém-adicionados conseguem ver a equipe após entrar no cliente da Web ou da área de trabalho do Teams.Verify that newly added members can see the team after signing into the Teams desktop or web client.