Criar equipe a partir do grupoCreate team from group

Namespace: microsoft.graphNamespace: microsoft.graph

Criar uma nova equipe em um grupo.Create a new team under a group.

Para criar uma equipe, o grupo deve ter pelo menos um proprietário.In order to create a team, the group must have a least one owner.

Se o grupo foi criado há menos de 15 minutos, é possível que a chamada Criar equipe falhe com um código de erro 404 devido a atrasos na replicação.If the group was created less than 15 minutes ago, it's possible for the Create team call to fail with a 404 error code due to replication delays. O padrão recomendado é repetir a chamada Criar equipe três vezes, com um atraso de 10 segundos entre as chamadas.The recommended pattern is to retry the Create team call three times, with a 10 second delay between calls.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All

Observação: esta API oferece transporte a permissões de administrador.Note: This API supports admin permissions. Os administradores globais e administradores do serviço do Microsoft Teams podem acessar grupos dos quais eles não são membros.Global admins and Microsoft Teams service admins can access groups that they are not a member of.

Solicitação HTTPHTTP request

PUT /groups/{id}/team

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON de um objeto team.In the request body, supply a JSON representation of a team object.

RespostaResponse

Se bem-sucedido, este método retorna um código de resposta 201 Created e um objeto team no corpo da resposta.If successful, this method should return a 201 Created response code and a team object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

PUT https://graph.microsoft.com/v1.0/groups/{id}/team
Content-type: application/json

{  
  "memberSettings": {
    "allowCreatePrivateChannels": true,
    "allowCreateUpdateChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict"
  }
}

RespostaResponse

Este é um exemplo de resposta.The following is an example of 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 201 Created
Content-type: application/json
Content-length: 401

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