Abrufen der letzten Benutzeraktivitäten

  • Artikel

Namespace: microsoft.graph

Ruft aktuelle Aktivitäten für einen bestimmten Benutzer ab. Diese OData-Funktion verfügt über einige Standardverhaltensweisen, damit sie wie eine "zuletzt verwendete" API funktioniert. Der Dienst fragt die neuesten historyItems ab und ruft dann diese zugehörigen Aktivitäten ab. Aktivitäten werden nach der letzten lastModified-Eigenschaft im historyItem sortiert. Dies bedeutet, dass Aktivitäten ohne historyItems nicht in die Antwort einbezogen werden. Die Berechtigung UserActivity.ReadWrite.CreatedByApp wendet auch zusätzliche Filterung auf die Antwort an, sodass nur aktivitäten zurückgegeben werden, die von Ihrer Anwendung erstellt wurden. Diese serverseitige Filterung kann zu leeren Seiten führen, wenn der Benutzer aktiv ist und andere Anwendungen neuere Aktivitäten erstellt haben. Um die Aktivitäten Ihrer Anwendung abzurufen, verwenden Sie die nextLink-Eigenschaft zum Paginieren.

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) UserActivity.ReadWrite.CreatedByApp Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) UserActivity.ReadWrite.CreatedByApp Nicht verfügbar.
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

GET /me/activities/recent

Optionale Abfrageparameter

Diese Methode unterstützt einige OData-Abfrageparameter , um die Antwort anzupassen. Die folgenden Abfrageparameter werden unterstützt:

  • $expand für die navigationseigenschaft historyItems .
  • $top, um die maximale Anzahl von Elementen auf seitenübergreifender Seite zu begrenzen.
  • $filter für die lastModifiedDateTime-Eigenschaft entweder für activities oder historyItems, sofern erweitert.

Im Folgenden sind einige Beispiele für unterstützte Abfragen mit URL-Codierung aufgeführt.

/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

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie keinen Anforderungstext an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode mit den letzten Aktivitäten des Benutzers für Ihre Anwendung zurück.

Beispiel

Anforderung

Hier sehen Sie ein Beispiel für die Anforderung.

GET https://graph.microsoft.com/v1.0/me/activities/recent

Antwort

Hier ist ein Beispiel für die Antwort.

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"
      }
   ]
}