Benutzeraktivitäten abrufenGet user activities

Namespace: Microsoft. GraphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Abrufen von Aktivitäten für einen bestimmten Benutzer.Get activities for a given user. Im Gegensatz zur letzten OData-Funktion werden Aktivitäten ohne Historie zurückgegeben.Unlike the recent OData function, activities without histories will be returned. Die Berechtigung Useraktivität. ReadWrite. CreatedByApp wendet eine zusätzliche Filterung auf die Antwort an, sodass nur von Ihrer Anwendung erstellte Aktivitäten zurückgegeben werden.The permission UserActivity.ReadWrite.CreatedByApp will apply extra filtering to the response, so that only activities created by your application are returned. Diese serverseitige Filterung kann zu leeren Seiten führen, wenn der Benutzer besonders aktiv ist und andere Anwendungen neuere Aktivitäten erstellt haben.This server-side filtering might result in empty pages if the user is particularly active and other applications have created more recent activities. Um die Aktivitäten Ihrer Anwendung abzurufen, verwenden Sie die nextLink -Eigenschaft zum paginieren.To get your application's activities, use the nextLink property to paginate.

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) UserActivity.ReadWrite.CreatedByAppUserActivity.ReadWrite.CreatedByApp
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) UserActivity.ReadWrite.CreatedByAppUserActivity.ReadWrite.CreatedByApp
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

GET /me/activities

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt einige OData-Abfrageparameter , die zur Anpassung der Antwort beitragen.This method supports some OData Query Parameters to help customize the response. Die folgenden Abfrageparameter werden unterstützt:The following query parameters are supported:

  • $Expand für die historyItems -Navigationseigenschaft.$expand for the historyItems navigation property.
  • $Top, um die maximale Anzahl von Elementen auf mehreren Seiten zu begrenzen.$top to limit the maximum number of items across pages.
  • $Filter für die lastModifiedDateTime -Eigenschaft für Activities oder historyItems, falls erweitert.$filter on the lastModifiedDateTime property for either activities or historyItems, if expanded.

Im folgenden sind einige Beispiele für unterstützte Abfragen mit URL-Codierung aufgeführt:The following are some examples of supported queries with URL encoding:

/me/activities?$expand=historyItems($filter=lastModifiedDateTime%20gt%202018-01-22T21:45:00.347Z%20and%20lastModifiedDateTime%20lt%202018-01-22T22:00:00.347Z)

/me/activities?$filter=lastModifiedDateTime%20lt%202018-01-16T01:03:21.347Z%20and%20lastModifiedDateTime%20gt%202018-01-03T01:03:21.347Z

/me/activities?$top=5

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Kein Anforderungstext.No request body.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK wird der Antwortcode mit den Aktivitäten des Benutzers für die Anwendung zurückgegeben.If successful, this method returns the 200 OK response code with the user's activities for your application.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.The following is an example of the request.

GET https://graph.microsoft.com/beta/me/activities
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(userActivity)",
    "@odata.nextLink": "https://graph.microsoft.com/beta/me/activities?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
    "value": [{
        "@odata.type": "#microsoft.graph.activity",
        "activitySourceHost": "https://www.contoso.com",
        "createdDateTime": "2018-02-26T18:34:29.592Z",
        "lastModifiedDateTime": "2018-02-26T18:34:29.607Z",
        "id": "5347642601316252694",
        "appActivityId": "/article?12345",
        "visualElements": {
            "attribution": {
              "iconUrl": "https://www.contoso.com/icon",
              "alternateText": "Contoso, Ltd.",
              "addImageQuery": "false",
              },
            "displayText": "Contoso How-To: How to Tie a Reef Knot",
            "description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
            "backgroundColor": "#ff0000",
            "content": {
              "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
              "type": "AdaptiveCard",
              "body":
              [{
                  "type": "TextBlock",
                  "text": "Contoso MainPage"
              }]
            }
        },
        "activationUrl": "https://www.contoso.com/article?id=12345",
        "appDisplayName": "Contoso, Ltd.",
        "userTimezone": "Africa/Casablanca",
        "fallbackUrl": "https://www.contoso.com/article?id=12345",
        "contentUrl": "https://www.contoso.com/article?id=12345",
        "contentInfo": {
            "@context": "https://schema.org",
            "@type": "Article",
            "author": "John Doe",
            "name": "How to Tie a Reef Knot"
        },
        "expirationDateTime": "2018-03-28T18:34:29.607Z",
        "status": "updated"
    }]
}