Get callRecord
Namespace: microsoft.graph.callRecords
Ruft die Eigenschaften und Beziehungen eines callRecord-Objekts ab.
Sie können die ID eines CallRecord auf zwei Arten abrufen:
- Abonnieren Sie Änderungsbenachrichtigungen für den
/communications/callRecords
Endpunkt. - Verwenden Sie die callChainId-Eigenschaft eines Aufrufs. Der Anrufdatensatz ist erst verfügbar, nachdem der zugeordnete Anruf abgeschlossen wurde.
Warnung
Ein Anrufdatensatz wird nach Ablauf eines Anrufs oder einer Besprechung erstellt und bleibt 30 Tage lang verfügbar. Diese API gibt keine Aufrufdatensätze zurück, die älter als 30 Tage sind, und Anforderungen für solche Datensätze führen zu einem 404 Not Found
Antwortcode.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Nicht unterstützt | Nicht unterstützt |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | CallRecords.Read.All | Nicht verfügbar. |
HTTP-Anforderung
GET /communications/callRecords/{id}
Achtung
- Diese API gibt derzeit keinen Datensatz von Teilnehmern zurück, die ein Liveereignis streamen.
Optionale Abfrageparameter
Diese Methode unterstützt die folgenden OData-Abfrageparameter, um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Name | Beschreibung |
---|---|
$select | Verwenden Sie den $select -Abfrageparameter, um eine Reihe von Eigenschaften zurückzugeben, die sich von den Standardeigenschaften für eine einzelne Ressource oder eine Sammlung von Ressourcen unterscheidet. Wird nur für CallRecord - und Sitzungsressourcen unterstützt. |
$expand | Verwenden Sie den $expand Abfrageparameter, um die erweiterte Ressource oder Sammlung, auf die durch eine einzelne Beziehung (participants_v2 oder Sitzungen und Segmente) verwiesen wird, in ihre Ergebnisse einzuschließen. Ein Beispiel finden Sie unter Abrufen von Sitzungs- und Segmentdetails. |
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Bevorzugen: odata.maxpagesize={x} | Gibt eine bevorzugte ganzzahlige {x}-Seitengröße für paginierte Ergebnisse an. Optional. Dieser Wert muss gleich oder kleiner als die maximal zulässige Seitengröße sein. |
Bevorzugen: include-unknown-enum-members | Aktiviert verwertbare Enumerationswerte, die über den Sentinelwert hinausgehen. Weitere Informationen finden Sie unter Bewährte Methoden für die Arbeit mit Microsoft Graph. Optional. |
Prefer: omit-values=nulls | Entfernt NULL- oder leere Werte aus der Antwort. Optional. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK
Antwortcode und ein microsoft.graph.callRecords.callRecords-Objekt im Antworttext zurück. Eine Anforderung für einen Anrufdatensatz, der älter als 30 Tage ist, gibt einen 404 Not Found
Antwortcode zurück.
Wenn sich ein Resultset über mehrere Seiten erstreckt, gibt Microsoft Graph diese Seite mit einer @odata.nextLink-Eigenschaft in der Antwort zurück, die eine URL zur nächsten Ergebnisseite enthält. Wenn diese Eigenschaft vorhanden ist, fahren Sie mit der @odata.nextLink-URL in jeder Antwort fort, bis alle Ergebnisse zurückgegeben werden. Weitere Informationen finden Sie unter Paging der Microsoft Graph-Daten in Ihrer App. Maximale Seitengröße: 130 Einträge für Teilnehmer und 60 Einträge für Sitzungen.
Beispiele
Beispiel 1: Abrufen grundlegender Details
Das folgende Beispiel zeigt, wie Sie die grundlegenden Details aus einem CallRecord abrufen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/communications/callRecords/e523d2ed-2966-4b6b-925b-754a88034cc5
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords/$entity",
"version": 1,
"type": "peerToPeer",
"modalities": [
"audio"
],
"lastModifiedDateTime": "2020-02-25T19:00:24.582757Z",
"startDateTime": "2020-02-25T18:52:21.2169889Z",
"endDateTime": "2020-02-25T18:52:46.7640013Z",
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5",
"organizer_v2@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/organizer_v2/$entity",
"organizer_v2": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"identity": {
"user": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f"
}
}
},
"participants_v2@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/participants_v2/$entity"
}
Beispiel 2: Abrufen von Sitzungs- und Segmentdetails
Das folgende Beispiel zeigt, wie Sie die vollständigen Sitzungs- und Segmentdetails aus einem CallRecord abrufen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/communications/callRecords/e523d2ed-2966-4b6b-925b-754a88034cc5?$expand=sessions($expand=segments)
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords(sessions(segments()))/$entity",
"version": 1,
"type": "peerToPeer",
"modalities": [
"audio"
],
"lastModifiedDateTime": "2020-02-25T19:00:24.582757Z",
"startDateTime": "2020-02-25T18:52:21.2169889Z",
"endDateTime": "2020-02-25T18:52:46.7640013Z",
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5",
"organizer_v2@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/organizer_v2/$entity",
"organizer_v2": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"identity": {
"user": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f"
}
}
},
"participants_v2@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/participants_v2/$entity",
"sessions": [
{
"modalities": [
"audio"
],
"startDateTime": "2020-02-25T18:52:21.2169889Z",
"endDateTime": "2020-02-25T18:52:46.7640013Z",
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5",
"isTest": false,
"caller": {
"@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
"name": "machineName_2",
"userAgent": {
"@odata.type": "#microsoft.graph.callRecords.clientUserAgent",
"headerValue": "RTCC/7.0.0.0 UCWA/7.0.0.0 AndroidLync/6.25.0.27 (SM-G930U Android 8.0.0)",
"platform": "android",
"productFamily": "skypeForBusiness"
},
"associatedIdentity": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f",
"userPrincipalName": "abbie.wilkins@contoso.com"
}
},
"callee": {
"@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
"name": "machineName_4",
"userAgent": {
"@odata.type": "#microsoft.graph.callRecords.clientUserAgent",
"headerValue": "UCCAPI/16.0.12527.20122 OC/16.0.12527.20194 (Skype for Business)",
"platform": "windows",
"productFamily": "skypeForBusiness"
},
"associatedIdentity": {
"id": "f69e2c00-0000-0000-0000-185e5f5f5d8a",
"displayName": "Owen Franklin",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f",
"userPrincipalName": "owen.franklin@contoso.com"
},
"feedback": {
"rating": "poor"
}
},
"segments": [
{
"startDateTime": "2020-02-25T18:52:21.2169889Z",
"endDateTime": "2020-02-25T18:52:46.7640013Z",
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5",
"media": [
{
"label": "main-audio",
"callerNetwork": {
"ipAddress": "10.150.0.2",
"subnet": "10.150.0.0",
"linkSpeed": 54000000
},
"callerDevice": {
"captureDeviceName": "Default input device",
"renderDeviceName": "Default output device",
"receivedSignalLevel": -10
},
"streams": [
{
"streamId": "1504545584",
"streamDirection": "callerToCallee",
"averageAudioDegradation": null,
"averageJitter": "PT0.016S"
}
]
}
]
}
]
}
],
"sessions@odata.nextLink": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/sessions?$expand=segments&$skiptoken=abc"
}
Beispiel 3: Abrufen von Teilnehmerdetails
Im folgenden Beispiel wird gezeigt, wie Sie die vollständige paginierte Teilnehmerliste für einen callRecord erweitern.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/communications/callRecords/e523d2ed-2966-4b6b-925b-754a88034cc5?$expand=participants_v2
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords(participants_v2())/$entity",
"version": 1,
"type": "peerToPeer",
"modalities": [
"audio"
],
"lastModifiedDateTime": "2020-02-25T19:00:24.582757Z",
"startDateTime": "2020-02-25T18:52:21.2169889Z",
"endDateTime": "2020-02-25T18:52:46.7640013Z",
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5",
"organizer_v2@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/organizer_v2/$entity",
"organizer_v2": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"identity": {
"user": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f"
}
}
},
"participants_v2@odata.context": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/participants_v2/$entity",
"participants_v2@odata.nextLink": "https://graph.microsoft.com/v1.0/$metadata#communications/callRecords('e523d2ed-2966-4b6b-925b-754a88034cc5')/participants_v2?$skiptoken=abc",
"participants_v2": [
{
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"identity": {
"user": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f",
"userPrincipalName": "abbie.wilkins@contoso.com"
}
}
},
{
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"identity": {
"user": {
"id": "f69e2c00-0000-0000-0000-185e5f5f5d8a",
"displayName": "Owen Franklin",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f",
"userPrincipalName": "owen.franklin@contoso.com"
}
}
}
]
}