Partilhar via

Listar todosMembers

  • Artigo

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Obtenha uma lista de [conversationMember](.. Objetos /resources/conversation member.md) de um canal de equipa. Suporta todos os tipos de canais. No caso dos canais partilhados, inclui todos os membros entre inquilinos e entre equipas num canal.

Observação

As IDs de associação retornadas pelo servidor devem ser tratadas como cadeias de caracteres opacas. O cliente não deve tentar analisar ou fazer suposições sobre essas IDs do recursos. No futuro, os resultados da associação podem ser mapeados para utilizadores de diferentes inquilinos, conforme indicado na resposta. O cliente não deve assumir que todos os membros são do inquilino atual.

Observação

Atualmente, a paginação não é suportada, pode ser devolvido um máximo de 999 membros na resposta. Se existirem mais de 999 membros num canal, a API só obtém os primeiros 999 membros.

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Group.Read.All ChannelMember.ReadWrite.All, ChannelMember.Read.AllChannelMember.Read.All
Delegado (conta pessoal da Microsoft) Sem suporte Sem suporte
Aplicativo ChannelMember.Read.All ChannelMember.ReadWrite.All

Solicitação HTTP

Parâmetros de consulta opcionais

Este método oferece suporte aos $filter e $selectparâmetros de consulta OData para ajudar a personalizar a resposta.

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem sucedido, este método retorna um código de resposta 200 OK e uma lista de objetos conversationMember no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/teams/2ab9c796-2902-45f8-b712-7c5a63cf41c4/channels/19%3A20bc1df46b1148e9b22539b83bc66809%40thread.skype/allMembers

Resposta

O exemplo a seguir mostra a resposta.

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

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

{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('2ab9c796-2902-45f8-b712-7c5a63cf41c4')/channels('19%3A20bc1df46b1148e9b22539b83bc66809%40thread.skype')/allMembers",
"@odata.count": 2,
    "value": [
        {
        "@odata.type": "#microsoft.graph.aadUserConversationMember",
        "id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNlZWY5Y2IzNi0wNmRlLTQ2OWItODdjZC03MGY0Y2JlMzJkMTQ=",
        "roles": [
            "Member"
        ],
        "displayName": "Caleb Foster",
        "userId": "eef9cb36-06de-469b-87cd-70f4cbe32d14",
        "email": "calfos@contoso.com",
        "tenantId": "ar8133445-c7e2-418a-8803-0e68d4b88607"
        },
        {
        "@odata.type": "#microsoft.graph.aadUserConversationMember",
        "id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNiMzI0NmY0NC1jMDkxLTQ2MjctOTZjNi0yNWIxOGZhMmM5MTA=",
        "roles": [
            "Owner"
        ],
        "displayName": "Eric Solomon",
        "userId": "b3246f44-c091-4627-96c6-25b18fa2c910",
        "email": "ericsol@contoso.com",
        "tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
        }
    ]
}