Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph.callRecords
Obtenha um registo de chamadas de encaminhamento direto como uma coleção de entradas directRoutingLogRow .
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) | Sem suporte. | Sem suporte. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | CallRecords.Read.All | Indisponível. |
Solicitação HTTP
GET /communications/callRecords/getDirectRoutingCalls(fromDateTime={fromDateTime},toDateTime={toDateTime})
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Parâmetros de função
Na URL da solicitação, forneça os seguintes parâmetros de consulta com valores. A tabela a seguir mostra os parâmetros que podem ser usados com esta função.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| fromDateTime | DateTimeOffset | Início do intervalo de tempo a consultar. UTC, inclusive. O intervalo de tempo baseia-se na hora de início da chamada. |
| toDateTime | DateTimeOffset | Intervalo de tempo de fim de consulta. UTC, exclusivo. |
Resposta
Se for bem-sucedida, esta função devolve um 200 OK código de resposta e uma coleção de entradas directRoutingLogRow no corpo da resposta.
Se existirem mais de 1000 entradas no intervalo de datas, o corpo também inclui um @odata.nextLink com um URL para consultar a página seguinte das entradas de chamada. A última página no intervalo de datas não tem @odata.nextLink. Para obter mais informações, veja Paginar dados do Microsoft Graph na sua aplicação.
Exemplo
O exemplo seguinte mostra a obtenção de uma coleção de registos para chamadas de encaminhamento direto que ocorreram no intervalo de datas especificado. A resposta inclui "@odata.count": 1000 enumerar o número de registos nesta primeira resposta e @odata.nextLink obter registos para além dos primeiros 1000. Para legibilidade, a resposta mostra apenas uma coleção de um registo. Suponha que existem mais de 1000 chamadas nesse intervalo de datas.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=2019-11-01,toDateTime=2019-12-01)
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
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.callRecords.directRoutingLogRow)",
"@odata.count": 1000,
"value": [
{
"id": "9e8bba57-dc14-533a-a7dd-f0da6575eed1",
"correlationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
"userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
"userPrincipalName": "richard.malk@contoso.com",
"userDisplayName": "Richard Malk",
"startDateTime": "2019-11-01T00:00:25.105Z",
"inviteDateTime": "2019-11-01T00:00:21.949Z",
"failureDateTime": "0001-01-01T00:00:00Z",
"endDateTime": "2019-11-01T00:00:30.105Z",
"duration": 5,
"callType": "ByotIn",
"successfulCall": true,
"callerNumber": "+12345678***",
"calleeNumber": "+01234567***",
"mediaPathLocation": "USWE",
"signalingLocation": "EUNO",
"finalSipCode": 0,
"callEndSubReason": 540000,
"finalSipCodePhrase": "BYE",
"trunkFullyQualifiedDomainName": "tll-audiocodes01.adatum.biz",
"mediaBypassEnabled": false
}
],
"@odata.nextLink": "https://graph.microsoft.com/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=2019-11-01,toDateTime=2019-12-01)?$skip=1000"
}
Conteúdo relacionado
- Relatório de utilização do encaminhamento direto do Microsoft Teams no centro de administração do Microsoft Teams.
- Dashboard do Estado de Funcionamento para encaminhamento direto no centro de administração do Microsoft Teams.
- Relatório de chamada RTPC no Microsoft Graph.