Abrufen der letzten Benutzeraktivitäten

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Abrufen der letzten Aktivitäten für einen bestimmten Benutzer. Diese OData-Funktion enthält einige Standardverhalten, damit sie wie eine "zuletzt verwendete" API funktioniert. Der Dienst fragt die neuesten activityHistoryItems ab und ruft dann diese zugehörigen Aktivitäten ab. Aktivitäten werden nach der letzten letzten Änderung auf dem activityHistoryItem sortiert. Dies bedeutet, dass Aktivitäten ohne activityHistoryItems nicht in die Antwort eingeschlossen werden. Die Berechtigung UserActivity.ReadWrite.CreatedByApp wendet auch zusätzliche Filter auf die Antwort an, sodass nur von Ihrer Anwendung erstellte Aktivitäten zurückgegeben werden. Diese serverseitige Filterung kann zu leeren Seiten führen, wenn der Benutzer aktiv ist und andere Anwendungen die letzten 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.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

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.

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.
Application 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 seitenübergreifend zu begrenzen.
  • $filter für die lastModifiedDateTime-Eigenschaft für activities oder historyItems, falls diese erweitert ist.

Im Folgenden finden Sie einige Beispiele für unterstützte Abfragen mit URL-Codierung.

/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. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext an.

Antwort

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

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

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/recent?$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"
      }
   ]
}
  • Zuletzt aktualisiert um