Usar a API REST do feed de atividades

  • Artigo

Namespace: microsoft.graph

Você pode usar a API de feed de atividades no Microsoft Graph para retomar a atividade de um usuário entre dispositivos e plataformas. As solicitações de API do feed de atividades são executadas em nome de um usuário por meio de permissões delegadas e da permissão de atividade do usuário, que pode ser usada com contas pessoais ou de trabalho e de estudante.

As atividades do usuário são representadas pelo recurso de atividade e são organizadas em um feed baseado em tempo representado pela coleção me/activities.

O que faz uma grande atividade de usuário?

As atividades do usuário não são apenas aplicativos de inicialização – são links profundos para conteúdo específico em seu aplicativo. As atividades de usuário que você cria não só podem ser usadas em seu próprio aplicativo, mas também serão exibidas na Cortana e na Linha do Tempo do Windows – gerando mais reengajamento de aplicativos e facilitando que seus usuários continuem usando seu aplicativo em vários dispositivos.

O que deve se tornar uma atividade?

Como cada aplicativo é diferente, cabe a cada desenvolvedor de aplicativos entender a melhor maneira de mapear ações em seu aplicativo para as atividades do usuário. Por exemplo, os jogos podem criar uma atividade para cada campanha, aplicativos de criação de documentos podem criar uma atividade para cada documento exclusivo e aplicativos de linha de negócios podem criar uma atividade para cada fluxo de trabalho.

Aplique as seguintes diretrizes conforme você define as atividades em seu aplicativo:

FAZER: Registre uma única atividade para um grupo de ações de usuário relacionadas. Se seu aplicativo for usado para uma sequência de conteúdo relacionado, provavelmente fará sentido gravar uma única atividade para toda a sessão de engajamento.

Cenários de lista de reprodução: Isso é especialmente relevante para listas de reprodução de música ou programas de TV – uma única atividade do usuário pode ser atualizada para mostrar seu progresso. Nesse caso, você tem uma única atividade de usuário com vários itens de histórico que representam períodos de engajamento em vários dias ou semanas.

FAZER: Armazene dados do usuário na nuvem. Se você quiser dar suporte a atividades entre dispositivos, precisará garantir que o conteúdo necessário para reengajar essa atividade seja armazenado em um local de nuvem. Por exemplo, se você publicar uma atividade sempre que um usuário editar um documento, o documento deverá ser armazenado na nuvem em vez de localmente no dispositivo do usuário, a fim de habilitar o reengajamento entre dispositivos.

NÃO: Crie uma atividade de usuário para ações que os usuários não precisam retomar no futuro. Se seu aplicativo for usado para concluir operações simples e pontuais que não persistem status para você acompanhar no futuro, provavelmente não será necessário gravar uma atividade de usuário.

Para ficar claro, embora as atividades do usuário apareçam na Linha do Tempo do Windows, isso não é projetado como uma ferramenta de versão – escolher uma atividade baseada em documento deve sempre mostrar a versão mais recente desse documento (incluindo alterações feitas por outro usuário).

NÃO: Crie uma atividade de usuário para ações concluídas por outros usuários. Se alguém enviar uma mensagem ao usuário ou @mentions o usuário em seu aplicativo, você não deverá escrever uma nova atividade. Essas interações são melhor atendidas por meio de notificações de exibição.

Cenários de colaboração: Se várias pessoas estiverem trabalhando na mesma atividade (como um documento Word), haverá casos em que outro usuário fez alterações no documento após a última edição. Nesse caso, os desenvolvedores de aplicativos podem querer atualizar os elementos visuais na atividade para refletir as alterações feitas no documento. Para fazer isso, o aplicativo pode atualizar a atividade existente sem criar um novo item de histórico.

Nota: Se você estiver publicando atividades para um aplicativo Web, é importante incluir um activationURL e um para cada uma fallbackURL de suas atividades. As atividades iniciarão o usuário de volta ao seu aplicativo, conforme esperado de experiências da Microsoft, como o Windows Timeline.

Padrões de interação de aplicativo e atividades do usuário

As atividades do usuário que você criar variam de acordo com o padrão de interação do seu aplicativo. Embora cada aplicativo seja diferente, a maioria se enquadra em um dos seguintes padrões de interação:

  • Aplicativos baseados em documentos – crie uma atividade por documento com um ou mais registros históricos refletindo períodos de uso. É importante atualizar sua atividade cartão à medida que as alterações são feitas no documento.
  • Aplicativos de reprodução de mídia – crie uma atividade por agrupamento lógico de conteúdo, como uma playlist, um programa ou um conteúdo autônomo.
  • Jogos – Criar uma atividade para cada jogo ou mundo salvo. Se o jogo der suporte a apenas uma única sequência de níveis, você poderá escrever a mesma atividade ao longo do tempo, embora você queira atualizar sua cartão para mostrar seu progresso ou conquistas mais recentes.
  • Aplicativos utilitários – se não houver nada no aplicativo que os usuários queiram retomar, você não deve publicar atividades. Um bom exemplo é um aplicativo simples de uso único, como calculadora.
  • Aplicativos de linha de negócios – existem muitos aplicativos para gerenciar tarefas simples ou fluxos de trabalho. Crie uma atividade para cada fluxo de trabalho separado acessado por meio de seu aplicativo. Por exemplo, cada relatório de despesas seria uma atividade separada, pois talvez você queira selecionar essa atividade para ver se ela foi aprovada.

Alguns aplicativos complexos incluem vários padrões de interação. Talvez você queira seguir diferentes padrões de criação de atividades do usuário para diferentes cenários tratados pelo seu aplicativo.

Próximas etapas

Procurando mais ideias?