Element Aktivitätsstatistik nach Intervall abrufenGet item activity stats by interval

Namespace: microsoft.graphNamespace: microsoft.graph

Rufen Sie eine Sammlung von itemActivityStats -Ressourcen für die Aktivitäten ab, die innerhalb des angegebenen Zeitintervalls für diese Ressource durchgeführt wurden.Get a collection of itemActivityStats resources for the activities that took place on this resource within the specified time interval.

Hinweis: Die itemAnalytics -Ressource ist noch nicht in allen nationalen Bereitstellungenverfügbar.Note: The itemAnalytics resource is not yet available in all national deployments.

Analyse Aggregate stehen möglicherweise nicht für alle Aktionstypen zur Verfügung.Analytics aggregates might not be available for all action types.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP request

GET /drives/{drive-id}/items/{item-id}/getActivitiesByInterval(startDateTime='2017-01-01',endDateTime='2017-01-10',interval='day')
GET /sites/{site-id}/getActivitiesByInterval(startDateTime='2016-01-01',endDateTime='2017-05-20',interval='month')
GET /sites/{site-id}/lists/{list-id}/items/{item-id}/getActivitiesByInterval(startDateTime='2017-05-01',interval='week')

FunktionsparameterFunction parameters

ParameterParameter TypType BeschreibungDescription
startDateTimestartDateTime Zeichenfolge (Zeitstempel)string (timestamp) Die Startzeit, über die Aktivitäten aggregiert werden sollen.The start time over which to aggregate activities.
endDateTimeendDateTime Zeichenfolge (Zeitstempel)string (timestamp) Die Endzeit, über die Aktivitäten aggregiert werden sollen.The end time over which to aggregate activities.
Intervallinterval stringstring Das Aggregations Intervall.The aggregation interval.

Hinweis: Diese API unterstützt nur einen Zeitbereich von 90 Tagen für tägliche Zählungen.Note: This API only supports a time range of 90 days for daily counts. Der Wert der startDateTime Parameter und endDateTime muss einen Zeitbereich von weniger als 90 Tagen darstellen.The value of the startDateTime and endDateTime parameters must represent a time range of less than 90 days.

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData query parameters to help customize the response.

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {code}.Bearer {code}. Erforderlich.Required.

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und eine Sammlung von itemActivityStats -Objekten im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and a collection of itemActivityStats object in the response body.

BeispielExample

AnforderungRequest

GET /drives/{drive-id}/items/{item-id}/getActivitiesByInterval(startDateTime='2017-01-01',endDateTime='2017-01-3',interval='day')

AntwortResponse

HTTP/1.1 200 OK
Content-type: application/json

{
    "value": [
        {
            "startDateTime": "2017-01-01T00:00:00.000Z",
            "endDateTime": "2017-01-02T00:00:00.000Z",
            "delete": {
                "actionCount": 1,
                "actorCount": 1
            },
            "access": {
                "actionCount": 5,
                "actorCount": 3
            }
        },
        {
            "startDateTime": "2017-01-02T00:00:00.000Z",
            "endDateTime": "2017-01-03T00:00:00.000Z",
            "edit": {
                "actionCount": 3,
                "actorCount": 1
            },
            "access": {
                "actionCount": 7,
                "actorCount": 6
            }
        }
    ]
}