Listar conversationMembersList conversationMembers

Namespace: microsoft.graphNamespace: microsoft.graph

Listar todos os membros da conversa de um chat ou canal.List all conversation members in a chat or channel.

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) Chat.ReadBasic, Chat.Read, Chat.ReadWriteChat.ReadBasic, Chat.Read, Chat.ReadWrite
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Observação

É necessário solicitar acesso antes de chamar essa API com permissões de aplicativo.Before calling this API with application permissions, you must request access. Para obter detalhes, confira APIs protegidas no Microsoft Teams.For details, see Protected APIs in Microsoft Teams.

Solicitação HTTPHTTP request

GET /chats/{id}/members
GET /users/{id}/chats/{id}/members

Parâmetros de consulta opcionaisOptional query parameters

Esta operação não é compatível com os parâmetros de consulta OData para personalizar a resposta.This operation does not support the OData query parameters to customize the response.

Cabeçalhos de solicitaçãoRequest headers

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

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se bem sucedido, este método retorna um código de resposta 200 OK e uma lista de objetos conversationMember no corpo da resposta.If successful, this method returns a 200 OK response code and a list of conversationMember objects in the response body.

ExemploExample

SolicitaçãoRequest

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

GET https://graph.microsoft.com/v1.0/me/chats/{id}/members

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 200 OK
Content-type: application/json
Content-length: 201

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('8b081ef6-4792-4def-b2c9-c363a1bf41d5')/chats('19%3A8b081ef6-4792-4def-b2c9-c363a1bf41d5_5031bb31-22c0-4f6f-9f73-91d34ab2b32d%40unq.gbl.spaces')/members",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
            "roles": [],
            "displayName": "John Doe",
            "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
            "email": null
        }
    ]
}