conversationMember: adicionarconversationMember: add

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs sob /beta a versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível na versão 1.0, use o seletor de versão.To determine whether an API is available in v1.0, use the Version selector.

Adicione vários membros em uma única solicitação a uma equipe.Add multiple members in a single request to a team. A resposta fornece detalhes sobre quais associações podem e não podem ser criadas.The response provides details about which memberships could and could not be created.

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) TeamMember.ReadWrite.AllTeamMember.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporteNot supported
AplicativoApplication TeamMember.ReadWrite.AllTeamMember.ReadWrite.All

Solicitação HTTPHTTP Request

Esta é uma ação vinculada para adicionar vários elementos a uma coleção chatMember em uma única solicitação.This is a bound action for adding multiple elements to a conversationMember collection in a single request.

POST /teams/{team-id}/members/add

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça a representação JSON da lista de conversationMember derivados que precisam ser adicionados à equipe.In the request body, supply the JSON representation of the list of conversationMember derivatives that need to be added to the team.

A tabela a seguir mostra os parâmetros que podem ser usados com esta ação.The following table shows the parameters that can be used with this action.

ParâmetroParameter TipoType DescriçãoDescription
valuesvalues coleção conversationMemberconversationMember collection Lista de membros da conversa que devem ser adicionados.List of conversation members that should be added.

RespostaResponse

Se bem-sucedida, esta ação retorna um código de resposta 200 OKe uma coleção de derivados de actionResultPart no corpo da resposta.If successful, this action returns a 200 OK response code and a collection of derivatives of actionResultPart in the response body.

Esta API retorna uma resposta 200 indicando que todos os membros fornecidos foram adicionados à equipe ou uma resposta 207 indicando que apenas alguns dos membros fornecidos foram adicionados à equipe.This API returns a 200 response indicating all members supplied were added to the team or a 207 response indicating that only some of the supplied members were added to the team. O chamador deve inspecionar a carga útil de resposta para determinar quais adições de membro falharam.The caller should inspect the response payload to determine which member additions failed. O corpo da resposta é uma coleção de derivados do recurso actionResultPart.The response body is a collection of derivatives of the actionResultPart resource.

ExemplosExamples

Exemplo 1: adicionar membros em massa a uma equipeExample 1: Add members in bulk to a team

SolicitaçãoRequest

O exemplo a seguir mostra uma solicitação para adicionar vários membros a uma equipe.The following example shows a request to add multiple members to a team.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/add
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":[],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('18a80140-b0fb-4489-b360-2f6efaf225a0')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":["owner"],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
        }
    ]
}

RespostaResponse

Esta é a resposta.The following is the response.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.Note: The response object shown here might be shortened for readability.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "18a80140-b0fb-4489-b360-2f6efaf225a0",
            "error": null
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}

Exemplo 2: adicionar membros em massa e encontrar falha parcialExample 2: Add members in bulk and encounter partial failure

SolicitaçãoRequest

O exemplo a seguir mostra uma solicitação para adicionar vários membros a uma equipe que resulta em uma falha parcial.The following example shows a request to add multiple members to a team that results in a partial failure.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/add
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":[],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('18a80140-b0fb-4489-b360-2f6efaf225a0')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":["owner"],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
        }
    ]
}

RespostaResponse

Esta é a resposta.The following is the response.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.Note: The response object shown here might be shortened for readability.

HTTP/1.1 207 MULTI-STATUS
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.addConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "18a80140-b0fb-4489-b360-2f6efaf225a0",
            "error": {
                "code": "NotFound",
                "message": ""
            }
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}

Confira tambémSee also