Partilhar via


Adicionar membro à equipe.

Namespace: microsoft.graph

Adicione um novo conversationMember à uma equipe.

Observação

  • A propriedade funções está vazia por predefinição para todos os membros. Esta propriedade contém apenas qualificadores adicionais quando relevante; por exemplo, se o membro tiver owner privilégios, a propriedade funções contém owner como um dos valores. Da mesma forma, se o membro for um convidado, a propriedade funções conterá guest como um dos valores. Um membro básico não deve ter quaisquer valores especificados na propriedade funções .
  • Depois de adicionar um novo membro de conversação a uma equipa, poderá demorar algum tempo até que a adição seja refletida. Os utilizadores podem utilizar notificações de alteração para subscrever notificações de alterações de associação numa determinada equipa.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) TeamMember.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo TeamMember.ReadWrite.All Indisponível.

Observação

Não há suporte para usar permissões de aplicativo para adicionar membros convidados a uma equipe.

Solicitação HTTP

POST /teams/{team-id}/members

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto conversationMember.

Resposta

Se bem-sucedido, este método retornará um código de resposta 201 Created e um objeto conversationMember no corpo da resposta.

Para obter os melhores resultados, escalone as chamadas com uma memória intermédia de 2 segundos.

Observação

O código 404 Not Found de resposta é devolvido quando tenta adicionar um utilizador desativado/bloqueado.

Exemplos

Exemplo 1: adicionar um membro a um grupo

Solicitação

POST https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"],
    "user@odata.bind": "https://graph.microsoft.com/v1.0/users('8b081ef6-4792-4def-b2c9-c363a1bf41d5')"
}

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
    "roles": [
        "owner"
    ],
    "userId": "50dffbae-ad0f-428e-a86f-f53b0acfc641",
    "displayName": "Cameron White",
    "email": "CameronW@contoso.com"
}

Exemplo 2: Adicionar um membro a uma equipe usando o nome de usuário principal

Solicitação

POST https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"],
    "user@odata.bind": "https://graph.microsoft.com/v1.0/users('jacob@contoso.com')"
}

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
    "roles": [
        "owner"
    ],
    "userId": "50dffbae-ad0f-428e-a86f-f53b0acfc641",
    "displayName": "Jacob Hancock",
    "email": "jacob@contoso.com"
}