callRecord: getSmsLog

Namespace: microsoft.graph.callRecords

Rufen Sie das Protokoll einer gesendeten/empfangenen SMS als Sammlung von smsLogRow-Einträgen ab.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

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.

HTTP-Anforderung

GET /communications/callRecords/getSmsLog(fromDateTime={fromDateTime},toDateTime={toDateTime})

Funktionsparameter

Stellen Sie in der URL der Anforderung die folgenden Abfrageparameter mit Werten bereit.

Anforderungsheader

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt diese Funktion einen 200 OK Antwortcode und eine Sammlung von microsoft.graph.callRecords.smsLogRow-Einträgen im Antworttext zurück.

Wenn die Funktion mehr als 1.000 Einträge für den angegebenen Datumsbereich zurückgibt, enthält der Text auch eine @odata.nextLink mit einer URL zum Abfragen der nächsten Seite von Einträgen. Die letzte Seite im Datumsbereich weist keine auf @odata.nextLink. Weitere Informationen finden Sie unter Paging von Microsoft Graph-Daten in Ihrer App.

Beispiel

Das folgende Beispiel zeigt, wie Sie das Protokoll der gesendeten/empfangenen SMS abrufen, die im angegebenen Datumsbereich aufgetreten sind. Die Antwort enthält "@odata.count": 1000 das Aufzählen der Anzahl von Datensätzen in dieser ersten Antwort und ein @odata.nextLink , um Datensätze über die ersten 1.000 zu erhalten. Aus Gründen der Lesbarkeit enthält das Antwortobjekt nur eine Auflistung eines Datensatzes.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/communications/callRecords/getSmsLog(fromDateTime=2022-11-01,toDateTime=2022-12-01)

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://v4.hkg1.meaqua.org/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Communications.CallRecords.MicrosoftGraphCallRecordsGetSmsLogWithFromDateTimeWithToDateTime(DateTimeOffset.Parse("{fromDateTime}"),DateTimeOffset.Parse("{toDateTime}")).GetAsGetSmsLogWithFromDateTimeWithToDateTimeGetResponseAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://v4.hkg1.meaqua.org/en-us/graph/sdks/create-client?from=snippets&tabs=go
fromDateTime , err := time.Parse(time.RFC3339, "{fromDateTime}")
toDateTime , err := time.Parse(time.RFC3339, "{toDateTime}")
microsoftGraphCallRecordsGetSmsLog, err := graphClient.Communications().CallRecords().MicrosoftGraphCallRecordsGetSmsLogWithFromDateTimeWithToDateTime(&fromDateTime, &toDateTime).GetAsGetSmsLogWithFromDateTimeWithToDateTimeGetResponse(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

var result = graphClient.communications().callRecords().microsoftGraphCallRecordsGetSmsLogWithFromDateTimeWithToDateTime(OffsetDateTime.parse("{fromDateTime}"), OffsetDateTime.parse("{toDateTime}")).get();

const options = {
	authProvider,
};

const client = Client.init(options);

let getSmsLog = await client.api('/communications/callRecords/getSmsLog(fromDateTime=2022-11-01,toDateTime=2022-12-01)')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->communications()->callRecords()->microsoftGraphCallRecordsGetSmsLogWithFromDateTimeWithToDateTime(new \DateTime('{fromDateTime}'),new \DateTime('{toDateTime}'))->get()->wait();

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://v4.hkg1.meaqua.org/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.communications.call_records.microsoft_graph_call_records_get_sms_log_with_from_date_time_with_to_date_time("{fromDateTime}","{toDateTime}").get()

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/beta/$metadata#Collection(microsoft.graph.callRecords.smsLogRow)",
    "@odata.count": 1000,
    "@odata.nextLink": "https://graph.microsoft.com/beta/communications/callRecords/getSmsLog(fromDateTime=2022-11-01,toDateTime=2022-12-01)?$skip=1000",
    "value": [
        {
            "smsId": "ef36b3e8-9922-4763-90e2-f4345c04a5d6",
            "userId": "19b900af-fe99-48d6-a9a4-b79c995afc33",
            "userPrincipalName": "ruwini.perera@contoso.com",
            "userDisplayName": "Ruwini Perera",
            "userCountryCode": "US",
            "tenantCountryCode": "US",
            "sourceNumber": "+12818602122",
            "destinationNumber": "+12673173004",
            "sentDateTime": "2022-10-06T11:15:48.6113555Z",
            "callCharge": 0.00,
            "currency": "USD",
            "smsType": "sms_in",
            "destinationContext": "Domestic",
            "destinationName": "United States",
            "otherPartyCountryCode": "US",
            "licenseCapability": "MCOSMS1",
            "smsUnits": 1,
            "administrativeUnitInfos": [
               {
                  "id": "639b616c-f164-4a6f-a933-24936b8eb210"
               },
               {
                  "id": "cc6ea167-4e92-4c2d-9391-85791e978006"
               }
            ]            
        }
    ]
}

Verwandte Inhalte

• Abrufen des Protokolls von PSTN-Anrufen
• Abrufen des Protokolls von Direct Routing-Anrufen
• Abrufen eines aggregierten Berichts über die Audiokonferenz-DFÜ
• Microsoft Teams – PSTN-Nutzungsbericht