callRecord: getPstnCalls
Namespace: microsoft.graph.callRecords
Ruft das Protokoll von PSTN-Anrufen als Sammlung von pstnCallLogRow-Einträgen ab.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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/getPstnCalls(fromDateTime={fromDateTime},toDateTime={toDateTime})
Funktionsparameter
Stellen Sie in der URL der Anforderung die folgenden Abfrageparameter mit Werten bereit. In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Funktion verwendet werden können.
Parameter | Typ | Beschreibung |
---|---|---|
fromDateTime | DateTimeOffset | Beginn des abzufragenden Zeitbereichs. UTC, einschließlich. Der Zeitbereich basiert auf der Startzeit des Anrufs. |
Convert.todatetime | DateTimeOffset | Ende des Abfragezeitbereichs. UTC, einschließlich. |
Wichtig
Die fromDateTime - und toDateTime-Werte dürfen nicht mehr als ein Datumsbereich von 90 Tagen sein.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Antwort
Bei erfolgreicher Ausführung gibt diese Funktion einen 200 OK
Antwortcode und eine Sammlung von pstnCallLogRow-Einträgen im Antworttext zurück.
Wenn mehr als 1.000 Einträge im Datumsbereich vorhanden sind, enthält der Text auch eine @odata.nextLink
mit einer URL zum Abfragen der nächsten Seite von Anrufeinträgen. Auf der letzten Seite im Datumsbereich ist nicht vorhanden @odata.nextLink
. Weitere Informationen finden Sie unter Paging von Microsoft Graph-Daten in Ihrer App.
Beispiel
Das folgende Beispiel zeigt das Abrufen einer Auflistung von Datensätzen für PSTN-Anrufe, die im angegebenen Datumsbereich aufgetreten sind. Die Antwort umfasst "@odata.count": 1000
das Aufzählen der Anzahl von Datensätzen in dieser ersten Antwort und @odata.nextLink
das Abrufen von Datensätzen über die ersten 1.000. Aus Gründen der Lesbarkeit zeigt die Antwort nur eine Sammlung von 1 Datensatz an. Gehen Sie davon aus, dass in diesem Datumsbereich mehr als 1.000 Anrufe vorliegen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/communications/callRecords/getPstnCalls(fromDateTime=2019-11-01,toDateTime=2019-12-01)
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.callRecords.pstnCallLogRow)",
"@odata.count": 1000,
"value": [
{
"id": "9c4984c7-6c3c-427d-a30c-bd0b2eacee90",
"callId": "1835317186_112562680@61.221.3.176",
"userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
"userPrincipalName": "richard.malk@contoso.com",
"userDisplayName": "Richard Malk",
"startDateTime": "2019-11-01T00:00:08.2589935Z",
"endDateTime": "2019-11-01T00:03:47.2589935Z",
"duration": 219,
"charge": 0.00,
"callType": "user_in",
"currency": "USD",
"calleeNumber": "+1234567890",
"usageCountryCode": "US",
"tenantCountryCode": "US",
"connectionCharge": 0.00,
"callerNumber": "+0123456789",
"destinationContext": null,
"destinationName": "United States",
"conferenceId": null,
"licenseCapability": "MCOPSTNU",
"inventoryType": "Subscriber",
"operator": "Microsoft",
"callDurationSource": "microsoft"
}
],
"@odata.nextLink": "https://graph.microsoft.com/v1.0/communications/callRecords/getPstnCalls(from=2019-11-01,to=2019-12-01)?$skip=1000"
}
Verwandte Inhalte
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für