callRecord: getDirectRoutingCalls

Espacios de nombres: microsoft.graph.callRecords

Obtener un registro de llamadas de enrutamiento directo como una colección de entradas de directRoutingLogRow.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) No admitida.
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación CallRecord-PstnCalls.Read.All, CallRecords.Read.All

Solicitud HTTP

GET /communications/callRecords/getDirectRoutingCalls

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio.

Parámetros de función

En la dirección URL de la solicitud, proporcione los siguientes parámetros de consulta con valores. La siguiente tabla muestra los parámetros que se pueden usar con esta función.

Parámetro Tipo Descripción
fromDateTime DateTimeOffset Inicio del intervalo de tiempo que se va a consultar. UTC, ambos incluidos.
El intervalo de tiempo se basa en la hora de inicio de la llamada.
toDateTime DateTimeOffset Fin del intervalo de tiempo que se va a consultar. UTC, ambos incluidos.

Respuesta

Si se realiza correctamente, esta función devuelve un código de respuesta y una colección de 200 OK entradas directRoutingLogRow en el cuerpo de la respuesta.

Si hay más de 1000 entradas en el intervalo de fechas, el cuerpo también incluye una dirección URL con la que consultar la siguiente página de entradas @odata.NextLink de llamada. La última página del intervalo de fechas no tiene @odata.NextLink . Para obtener más información, consulta paginación de microsoft Graph datos en la aplicación.

Ejemplo

En el ejemplo siguiente se muestra cómo obtener una colección de registros para llamadas de enrutamiento directo que se produjeron en el intervalo de fechas especificado. La respuesta incluye enumerar el número de registros de esta primera respuesta y obtener registros más allá de "@odata.count": 1000 @odata.NextLink los 1000 primeros. Para obtener legibilidad, la respuesta muestra solo una colección de 1 registro. Supongamos que hay más de 1000 llamadas en ese intervalo de fechas.

Solicitud

GET https://graph.microsoft.com/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=2019-11-01,toDateTime=2019-12-01)

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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"
}

Consulte también