Uso de la API REST de fuente de actividad

  • Artículo

Espacio de nombres: microsoft.graph

Puede usar la API de fuente de actividad en Microsoft Graph para reanudar la actividad de un usuario entre dispositivos y plataformas. Las solicitudes de API de fuente de actividad se realizan en nombre de un usuario a través de permisos delegados y el permiso de actividad de usuario, que se pueden usar con cuentas personales o profesionales y educativas.

Las actividades de usuario se representan mediante el recurso de actividad y se organizan en una fuente basada en el tiempo representada por la colección me/activities.

¿Qué hace una gran actividad de usuario?

Las actividades del usuario no solo inician aplicaciones, sino que son vínculos profundos al contenido específico de la aplicación. Las actividades de usuario que creas no solo se pueden usar en tu propia aplicación, sino que también aparecerán en Cortana y la escala de tiempo de Windows, lo que impulsará más la reaprovisionamiento de aplicaciones y facilitará a los usuarios seguir usando la aplicación en varios dispositivos.

¿Qué debe convertirse en una actividad?

Dado que cada aplicación es diferente, depende de cada desarrollador de aplicaciones comprender la mejor manera de asignar acciones dentro de la aplicación a las actividades del usuario. Por ejemplo, los juegos pueden crear una actividad para cada campaña, las aplicaciones de creación de documentos pueden crear una actividad para cada documento único y las aplicaciones de línea de negocio pueden crear una actividad para cada flujo de trabajo.

Aplique las siguientes directrices a medida que defina actividades en la aplicación:

HACER: Registre una sola actividad para un grupo de acciones de usuario relacionadas. Si la aplicación se usa para una secuencia de contenido relacionado, probablemente tenga sentido registrar una sola actividad para toda la sesión de interacción.

Escenarios de lista de reproducción: Esto es especialmente relevante para las listas de reproducción de música o programas de TELEVISIÓN: se puede actualizar una actividad de usuario único para mostrar su progreso. En este caso, tiene una única actividad de usuario con varios elementos del historial que representan períodos de interacción durante varios días o semanas.

HACER: Almacene los datos de usuario en la nube. Si quiere admitir actividades entre dispositivos, debe asegurarse de que el contenido necesario para volver a activar esta actividad se almacena en una ubicación en la nube. Por ejemplo, si publica una actividad cada vez que un usuario edita un documento, el documento debe almacenarse en la nube en lugar de localmente en el dispositivo del usuario para habilitar la reconexión entre dispositivos.

NO: Cree una actividad de usuario para las acciones que los usuarios no necesitan reanudar en el futuro. Si la aplicación se usa para completar operaciones sencillas y únicas que no conservan el estado para realizar un seguimiento en el futuro, probablemente no tenga que escribir una actividad de usuario.

Para ser claro, aunque las actividades del usuario aparezcan en la escala de tiempo de Windows, esto no está diseñado como una herramienta de control de versiones: la elección de una actividad basada en documentos siempre debe mostrar la versión más reciente de ese documento (incluidos los cambios realizados por otro usuario).

NO: Cree una actividad de usuario para las acciones completadas por otros usuarios. Si alguien envía un mensaje al usuario o @mentions al usuario dentro de la aplicación, no debe escribir una actividad nueva. Estas interacciones se atienden mejor mediante notificaciones emergentes.

Escenarios de colaboración: Si varias personas trabajan en la misma actividad (por ejemplo, un documento Word), habrá casos en los que otro usuario haya realizado cambios en el documento después de editarlo por última vez. En este caso, es posible que los desarrolladores de aplicaciones quieran actualizar los elementos visuales de la actividad para reflejar los cambios realizados en el documento. Para ello, la aplicación podría actualizar la actividad existente sin crear un nuevo elemento de historial.

Nota: Si va a publicar actividades para una aplicación web, es importante incluir un activationURL y un fallbackURL para cada una de las actividades. Las actividades volverán a iniciar al usuario en la aplicación según lo esperado desde experiencias de Microsoft, como la escala de tiempo de Windows.

Patrones de interacción de aplicaciones y actividades de usuario

Las actividades de usuario que cree variarán en función del patrón de interacción de la aplicación. Aunque cada aplicación es diferente, la mayoría se dividirá en uno de los siguientes patrones de interacción:

  • Aplicaciones basadas en documentos : cree una actividad por documento con uno o varios registros de historial que reflejen los períodos de uso. Es importante actualizar la tarjeta de actividad a medida que se realizan cambios en el documento.
  • Aplicaciones de reproducción multimedia: cree una actividad por agrupación lógica de contenido, como una lista de reproducción, un programa o un contenido independiente.
  • Juegos : crea una actividad para cada juego o mundo guardado. Si tu juego solo admite una única secuencia de niveles, puedes escribir la misma actividad a lo largo del tiempo, aunque es posible que quieras actualizar tu tarjeta para mostrar tu progreso o logros más recientes.
  • Aplicaciones de utilidad : si no hay nada dentro de la aplicación que los usuarios quieran reanudar, no debe publicar actividades. Un buen ejemplo es una aplicación sencilla de un solo uso, como la calculadora.
  • Aplicaciones de línea de negocio : existen muchas aplicaciones para administrar tareas sencillas o flujos de trabajo. Cree una actividad para cada flujo de trabajo independiente al que se accede a través de la aplicación. Por ejemplo, cada informe de gastos sería una actividad independiente, ya que es posible que quiera seleccionar esa actividad para ver si se aprobó.

Algunas aplicaciones complejas incluyen varios patrones de interacción. Es posible que quiera seguir diferentes patrones de creación de actividad de usuario para diferentes escenarios controlados por la aplicación.

Pasos siguientes

¿Buscas más ideas?