获取最近的用户活动

项目
06/12/2022

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

获取给定用户的最近活动。此 OData 函数包含一些默认行为，使其像“最近使用的”API 一样运行。该服务将查询最新的 historyItems，然后拉取这些相关活动。活动将根据 historyItem 上的最新 上次修改 进行排序。这意味着不会在响应中包含没有 historyItems 的活动。 UserActivity.ReadWrite.CreatedByApp 权限还将对响应应用额外的筛选，以便仅返回应用程序创建的活动。如果用户特别活跃，并且其他应用程序已创建较新的活动，则此服务器端筛选可能会导致空页。若要获取应用程序的活动，请使用 nextLink 属性进行分页。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	UserActivity.ReadWrite.CreatedByApp
委派（个人 Microsoft 帐户）	UserActivity.ReadWrite.CreatedByApp
应用程序	不支持。

HTTP 请求

GET /me/activities/recent

可选的查询参数

此方法支持一些 OData 查询参数来帮助自定义响应。支持以下查询参数：

historyItems 导航属性的$expand。
$top限制跨页面的最大项数。
$filter 活动或 historyItems 的 lastModifiedDateTime 属性（如果已展开）。

下面是使用 URL 编码支持的查询的一些示例。

/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

请求头

名称	类型	说明
Authorization	string	Bearer {token}。必需。

请求正文

请勿指定请求正文。

响应

如果成功，此方法将返回 200 OK 响应代码，其中包含用户最近针对应用程序的活动。

示例

请求

下面展示了示例请求。

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

响应

下面展示了示例响应。

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

获取最近的用户活动

权限

HTTP 请求

可选的查询参数

请求头

请求正文

响应

示例

请求

响应

反馈