Obter atividades de utilizador recentes

Namespace: microsoft.graph

Obtenha atividades recentes para um determinado utilizador. Esta função OData tem alguns comportamentos predefinidos incluídos para que funcione como uma API "utilizada mais recentemente". O serviço consulta as atividades mais recentesHistoryItems e, em seguida, solicita essas atividades relacionadas. As atividades são ordenadas de acordo com o lastModified mais recente na activityHistoryItem. Isto significa que as atividades sem activityHistoryItems não serão incluídas na resposta. A permissão UserActivity.ReadWrite.CreatedByApp também aplicará filtragem adicional à resposta, para que sejam devolvidas apenas as atividades criadas pela sua aplicação. Esta filtragem do lado do servidor pode resultar em páginas vazias se o utilizador estiver ativo e outras aplicações tiverem criado atividades mais recentes. Para obter as atividades da sua aplicação, utilize a propriedade nextLink para paginar.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Solicitação HTTP

GET /me/activities/recent

Parâmetros de consulta opcionais

Este método suporta alguns Parâmetros de Consulta OData para ajudar a personalizar a resposta. São suportados os seguintes parâmetros de consulta:

• $expand para a propriedade de navegação historyItems .
• $top limitar o número máximo de itens entre páginas.
• $filter na propriedade lastModifiedDateTime para atividades ou activityHistoryItems, se expandido.

Seguem-se alguns exemplos de consultas suportadas com codificação de 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

Cabeçalhos de solicitação

Corpo da solicitação

Não especifique um corpo do pedido.

Resposta

Se for bem-sucedido, este método devolve o 200 OK código de resposta com as atividades recentes do utilizador para a sua aplicação.

Exemplo

Solicitação

Eis um exemplo do pedido.

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

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Activities.Recent.GetAsRecentGetResponseAsync();

mgc users activities recent get --user-id {user-id}

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
recent, err := graphClient.Me().Activities().Recent().GetAsRecentGetResponse(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

var result = graphClient.me().activities().recent().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let recent = await client.api('/me/activities/recent')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->me()->activities()->recent()->get()->wait();

Import-Module Microsoft.Graph.Users.Functions

# A UPN can also be used as -UserId.
Invoke-MgRecentUserActivity -UserId $userId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.me.activities.recent.get()

Resposta

Veja um exemplo de resposta.

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