Obter atividades do usuário
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 para um determinado usuário. Ao contrário da função OData recente , atividades sem históricos serão retornadas. A permissão UserActivity.ReadWrite.CreatedByApp aplicará filtragem extra à resposta, de modo 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 particularmente 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
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 historyItems, se expandida.
Veja a seguir alguns exemplos de consultas com suporte com codificação de URL:
/me/activities?$expand=historyItems($filter=lastModifiedDateTime%20gt%202018-01-22T21:45:00.347Z%20and%20lastModifiedDateTime%20lt%202018-01-22T22:00:00.347Z)
/me/activities?$filter=lastModifiedDateTime%20lt%202018-01-16T01:03:21.347Z%20and%20lastModifiedDateTime%20gt%202018-01-03T01:03:21.347Z
/me/activities?$top=5
Cabeçalhos de solicitação
Nome | Tipo | Descrição |
---|---|---|
Autorização | string | {token} de portador. Obrigatório. |
Corpo da solicitação
Nenhum corpo de solicitação.
Resposta
Se for bem-sucedido, esse método retornará o 200 OK
código de resposta com as atividades do usuário para seu aplicativo.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/me/activities
Resposta
O exemplo a seguir mostra a 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?$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"
}]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de