Listar participantes
Namespace: microsoft.graph
Recupere uma lista de objetos participantes na chamada.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Sem suporte. | Sem suporte. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | Calls.Initiate.All | Calls.AccessMedia.All |
Nota: As permissões são verificadas quando a chamada é criada; nenhuma marcar de permissão adicional é feita ao chamar essa API. Calls.AccessMedia.All só é necessário para chamadas que usam mídia hospedada por aplicativo.
Solicitação HTTP
GET /communications/calls/{id}/participants
Nota: Essa solicitação não dá suporte a chamadas ponto a ponto.
Parâmetros de consulta opcionais
Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
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 for bem-sucedido, esse método retornará um código de resposta e uma 200 OK
coleção de objetos participantes no corpo da resposta.
Exemplo
Solicitação
GET https://graph.microsoft.com/v1.0/communications/calls/7531d31f-d10d-44de-802f-c569dbca451c/participants
Resposta
HTTP/1.1 200 OK
Content-Type: application/json
{
"value":[
{
"@odata.type":"#microsoft.graph.participant",
"info":{
"@odata.type":"#microsoft.graph.participantInfo",
"identity":{
"@odata.type":"#microsoft.graph.identitySet",
"application":{
"@odata.type":"#microsoft.graph.identity",
"id":"f2fa86af-3c51-4bc2-8fc0-475452d9764f",
"displayName":null
},
"user":null,
"device":null,
"phone":null
},
"id":"eec3812a-fdc3-4fb4-825c-a06c9f35414e"
},
"mediaStreams":[
{
"@odata.type":"#microsoft.graph.mediaStream",
"mediaType":"audio",
"sourceId":"3",
"direction":"sendReceive",
"serverMuted":false,
"label":null
}
],
"isMuted":false,
"isInLobby":false,
"id":"a7ebfb2d-871e-419c-87af-27290b22e8db",
"metadata":null
},
{
"@odata.type":"#microsoft.graph.participant",
"info":{
"@odata.type":"#microsoft.graph.participantInfo",
"identity":{
"@odata.type":"#microsoft.graph.identitySet",
"application":{
"@odata.type":"#microsoft.graph.identity",
"displayName":"Test Participant",
"id":"ef43e42b-4c05-4594-9756-1edb3ccbc989"
},
"user":null,
"device":null,
"phone":null
},
"id":"278405a3-f568-4b3e-b684-009193463064"
},
"mediaStreams":[
{
"@odata.type":"#microsoft.graph.mediaStream",
"mediaType":"audio",
"sourceId":"1",
"direction":"sendReceive",
"serverMuted":false,
"label":null
}
],
"isMuted":false,
"isInLobby":false,
"id":"1e126418-44a0-4a94-a6f8-0efe1ad71acb",
"metadata":null
}
],
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#communications/calls('7531d31f-d10d-44de-802f-c569dbca451c')/participants"
}