Obter atividades recentes do usuário
Namespace: microsoft.graph
Obtenha atividades recentes para um determinado usuário. Essa função OData tem alguns comportamentos padrão incluídos para fazê-la operar como uma API "mais recentemente usada". As consultas de serviço para a atividade mais recenteHistoryItems e, em seguida, puxam essas atividades relacionadas. As atividades são classificadas de acordo com o últimoModificado mais recente na atividadeHistoryItem. Isso significa que as atividades sem atividadeHistoryItems não serão incluídas na resposta. A permissão UserActivity.ReadWrite.CreatedByApp também aplicará filtragem extra à resposta para que somente as atividades criadas pelo aplicativo sejam retornadas. Essa filtragem do lado do servidor pode resultar em páginas vazias se o usuário estiver ativo e outros aplicativos tiverem criado atividades mais recentes. Para obter as atividades do aplicativo, use a propriedade nextLink para paginar.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
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
Esse método dá suporte a alguns Parâmetros de Consulta OData para ajudar a personalizar a resposta. Há suporte para 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 atividadeHistoryItems, se expandida.
A seguir estão alguns exemplos de consultas com suporte 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. |
Corpo da solicitação
Não especifique um corpo de solicitação.
Resposta
Se for bem-sucedido, esse método retornará o 200 OK
código de resposta com as atividades recentes do usuário para seu aplicativo.
Exemplo
Solicitação
Aqui está um exemplo da solicitação.
GET https://graph.microsoft.com/v1.0/me/activities/recent
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"
}
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários