callRecord : getDirectRoutingCalls
Espace de noms : Microsoft.graph.callRecords
Obtenez un journal des appels de routage direct en tant que collection d’entrées directRoutingLogRow .
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | Non prise en charge. | Non prise en charge. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | CallRecords.Read.All | Non disponible. |
Requête HTTP
GET /communications/callRecords/getDirectRoutingCalls(fromDateTime={fromDateTime},toDateTime={toDateTime})
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Paramètres de fonction
Dans l’URL de la demande, indiquez les paramètres de requête suivants avec leurs valeurs. Le tableau suivant indique les paramètres qui peuvent être utilisés avec cette fonction.
Paramètre | Type | Description |
---|---|---|
fromDateTime | DateTimeOffset | Début de l’intervalle de temps à interroger. UTC, inclus. L’intervalle de temps est basé sur l’heure de début de l’appel. |
toDateTime | DateTimeOffset | Fin de l’intervalle de temps à interroger. UTC, exclusif. |
Réponse
Si elle réussit, cette fonction renvoie un 200 OK
code de réponse et une collection d’entrées directRoutingLogRow dans le corps de la réponse.
S’il y a plus de 1 000 entrées dans la plage de dates, le corps inclut également un @odata.nextLink
avec une URL pour interroger la page suivante des entrées d’appel. La dernière page de la plage de dates n’a @odata.nextLink
pas . Pour plus d’informations, consultez Pagination des données Microsoft Graph dans votre application.
Exemple
L’exemple suivant montre comment obtenir une collection d’enregistrements pour les appels de routage direct qui se sont produits dans la plage de dates spécifiée. La réponse inclut "@odata.count": 1000
d’énumérer le nombre d’enregistrements dans cette première réponse et @odata.nextLink
d’obtenir des enregistrements au-delà des 1 000 premiers. Pour plus de lisibilité, la réponse n’affiche qu’une collection d’un enregistrement. Supposons qu’il y ait plus de 1 000 appels dans cette plage de dates.
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=2019-11-01,toDateTime=2019-12-01)
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
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"
}
Contenu connexe
- Rapport d’utilisation du routage direct microsoft Teams dans le Centre d’administration Microsoft Teams.
- Tableau de bord d’intégrité pour le routage direct dans le Centre d’administration Microsoft Teams.
- Rapport d’appel RTC dans Microsoft Graph.