Partilhar via

Obter atividades de utilizador recentes

  • Artigo

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

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.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ❌ ❌ ❌

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.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) UserActivity.ReadWrite.CreatedByApp Indisponível.
Delegado (conta pessoal da Microsoft) UserActivity.ReadWrite.CreatedByApp Indisponível.
Aplicativo Sem suporte. Sem suporte.

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 historyItems, 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

Nome Tipo Descrição
Autorização string {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorizaçã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/beta/me/activities/recent

Resposta

Veja um exemplo de resposta.

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