Obtención de actividades de usuario recientes

  • Artículo

Espacio de nombres: microsoft.graph

Obtenga actividades recientes para un usuario determinado. Esta función de OData tiene algunos comportamientos predeterminados incluidos para que funcione como una API "usada más recientemente". El servicio consulta los historyItems más recientes y, a continuación, extrae esas actividades relacionadas. Las actividades se ordenan según el lastModified más reciente en historyItem. Esto significa que las actividades sin historyItems no se incluirán en la respuesta. El permiso UserActivity.ReadWrite.CreatedByApp también aplicará un filtrado adicional a la respuesta, de modo que solo se devuelvan las actividades creadas por la aplicación. Este filtrado del lado servidor podría dar lugar a páginas vacías si el usuario está activo y otras aplicaciones han creado actividades más recientes. Para obtener las actividades de la aplicación, use la propiedad nextLink para paginar.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) UserActivity.ReadWrite.CreatedByApp No disponible.
Delegado (cuenta personal de Microsoft) UserActivity.ReadWrite.CreatedByApp No disponible.
Aplicación No admitida. No admitida.

Solicitud HTTP

GET /me/activities/recent

Parámetros de consulta opcionales

Este método admite algunos parámetros de consulta de OData para ayudar a personalizar la respuesta. Se admiten los siguientes parámetros de consulta:

  • $expand para la propiedad de navegación historyItems .
  • $top limitar el número máximo de elementos entre páginas.
  • $filter en la propiedad lastModifiedDateTime para actividades o historyItems, si se expande.

A continuación se muestran algunos ejemplos de consultas admitidas con codificación de direcciones 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

Encabezados de solicitud

Nombre Tipo Descripción
Authorization string {token} de portador. Obligatorio.

Cuerpo de la solicitud

No especifique un cuerpo de solicitud.

Respuesta

Si se ejecuta correctamente, este método devuelve el código de 200 OK respuesta con las actividades recientes del usuario para la aplicación.

Ejemplo

Solicitud

Este es un ejemplo de la solicitud.

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

Respuesta

Este es un ejemplo de la respuesta:

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