Abrufen aktueller BenutzeraktivitätenGet recent user activities

Aktuelle Aktivitäten für einen bestimmten Benutzer abrufen.Get recent activities for a given user. Diese OData-Funktion verfügt über einige Standardverhalten, damit Sie wie eine "zuletzt verwendete" API funktioniert.This OData function has some default behaviors included to make it operate like a "most recently used" API. Der Dienst fragt nach dem letzten historyItemsund ruft dann die zugehörigen Aktivitäten ab.The service will query for the most recent historyItems, and then pull those related activities. Aktivitäten werden entsprechend der neuesten LastModified auf der historyItemsortiert.Activities will be sorted according to the most recent lastModified on the historyItem. Dies bedeutet, dass Aktivitäten ohne historyItems in der Antwort nicht berücksichtigt werden.This means that activities without historyItems will not be included in the response. Die Useraktivität. ReadWrite. CreatedByApp-Berechtigung wendet auch eine zusätzliche Filterung auf die Antwort an, sodass nur von Ihrer Anwendung erstellte Aktivitäten zurückgegeben werden.The UserActivity.ReadWrite.CreatedByApp permission will also 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/recent

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 finden Sie einige Beispiele für unterstützte Abfragen mit URL-Codierung.The following are some examples of supported queries with URL encoding.

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

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

/me/activities/recent?$top=5

AnforderungsheaderRequest headers

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

AnforderungstextRequest body

Geben Sie keinen Anforderungstext an.Do not specify a request body.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK wird der Antwortcode mit den letzten Aktivitäten des Benutzers für die Anwendung zurückgegeben.If successful, this method returns the 200 OK response code with the user's recent 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/v1.0/me/activities/recent
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/v1.0/$metadata#Collection(userActivity)",
    "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/activities/recent?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
    "value": [{
        "@odata.type": "#microsoft.graph.userActivity",
        "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"
    }]
}