Utiliser l’API REST du flux d’activité

  • Article

Espace de noms: microsoft.graph

Vous pouvez utiliser l’API de flux d’activité dans Microsoft Graph pour reprendre l’activité d’un utilisateur sur les appareils et les plateformes. Les demandes d’API de flux d’activité sont effectuées pour le compte d’un utilisateur via des autorisations déléguées et l’autorisation d’activité de l’utilisateur, qui peuvent être utilisées avec des comptes personnels ou professionnels et scolaires.

Les activités utilisateur sont représentées par la ressource d’activité et sont organisées dans un flux basé sur le temps représenté par la collection me/activities.

Qu’est-ce qui rend une activité utilisateur exceptionnelle ?

Les activités des utilisateurs ne se contentent pas de lancer des applications : elles sont des liens profonds vers du contenu spécifique au sein de votre application. Les activités utilisateur que vous créez peuvent non seulement être utilisées dans votre propre application, mais elles s’affichent également dans Cortana et la chronologie Windows, ce qui entraîne davantage de réengagement des applications et facilite la poursuite de l’utilisation de votre application sur plusieurs appareils.

Qu’est-ce qui doit devenir une activité ?

Étant donné que chaque application est différente, c’est à chaque développeur d’application de comprendre la meilleure façon de mapper les actions de votre application aux activités des utilisateurs. Par exemple, les jeux peuvent créer une activité pour chaque campagne, les applications de création de documents peuvent créer une activité pour chaque document unique et les applications métier peuvent créer une activité pour chaque workflow.

Appliquez les instructions suivantes lorsque vous définissez des activités dans votre application :

FAIRE: Enregistrez une seule activité pour un groupe d’actions utilisateur associées. Si votre application est utilisée pour une séquence de contenu connexe, il est probablement judicieux d’enregistrer une seule activité pour l’ensemble de la session d’engagement.

Scénarios de sélection : Cela est particulièrement pertinent pour les playlists musicales ou les émissions de télévision : une activité utilisateur unique peut être mise à jour pour montrer votre progression. Dans ce cas, vous avez une activité utilisateur unique avec plusieurs éléments d’historique représentant des périodes d’engagement sur plusieurs jours ou semaines.

FAIRE: Stockez les données utilisateur dans le cloud. Si vous souhaitez prendre en charge les activités inter-appareils, vous devez vous assurer que le contenu requis pour réengager cette activité est stocké dans un emplacement cloud. Par exemple, si vous publiez une activité chaque fois qu’un utilisateur modifie un document, le document doit être stocké dans le cloud plutôt que localement sur l’appareil de l’utilisateur afin d’activer le réengagement inter-appareils.

NE PAS: Créez une activité utilisateur pour les actions que les utilisateurs n’ont pas besoin de reprendre à l’avenir. Si votre application est utilisée pour effectuer des opérations simples et ponctuelles qui ne sont pas conservées status que vous pouvez suivre à l’avenir, vous n’avez probablement pas besoin d’écrire une activité utilisateur.

Pour être clair, même si les activités de l’utilisateur apparaissent dans la chronologie Windows, ce n’est pas conçu comme un outil de gestion de version. Le choix d’une activité basée sur un document doit toujours afficher la dernière version de ce document (y compris les modifications apportées par un autre utilisateur).)

NE PAS: Créez une activité utilisateur pour les actions effectuées par d’autres utilisateurs. Si quelqu’un envoie un message à l’utilisateur ou @mentions à l’utilisateur au sein de votre application, vous ne devez pas écrire une nouvelle activité. Ces interactions sont mieux servies par des notifications d’exposition.

Scénarios de collaboration : Si plusieurs personnes travaillent sur la même activité (par exemple, un document Word), il peut arriver qu’un autre utilisateur ait apporté des modifications au document après sa dernière modification. Dans ce cas, les développeurs d’applications peuvent mettre à jour les éléments visuels de l’activité pour refléter les modifications apportées au document. Pour ce faire, l’application peut mettre à jour l’activité existante sans créer d’élément d’historique.

Note: Si vous publiez des activités pour une application web, il est important d’inclure à la fois un activationURL et un fallbackURL pour chacune de vos activités. Les activités relancent l’utilisateur dans votre application comme prévu à partir d’expériences Microsoft telles que la chronologie Windows.

Modèles d’interaction d’application et activités utilisateur

Les activités utilisateur que vous créez varient en fonction du modèle d’interaction de votre application. Bien que chaque application soit différente, la plupart se trouvent dans l’un des modèles d’interaction suivants :

  • Applications basées sur un document : créez une activité par document avec un ou plusieurs enregistrements d’historique reflétant les périodes d’utilisation. Il est important de mettre à jour votre carte d’activité à mesure que des modifications sont apportées au document.
  • Applications de lecture multimédia : créez une activité par regroupement logique de contenu, tel qu’une playlist, un programme ou du contenu autonome.
  • Jeux : créez une activité pour chaque jeu ou monde enregistré. Si votre jeu ne prend en charge qu’une seule séquence de niveaux, vous pouvez écrire la même activité au fil du temps, bien que vous souhaitiez mettre à jour votre carte pour afficher vos dernières progrès ou réalisations.
  • Applications utilitaires : s’il n’y a rien dans votre application que les utilisateurs souhaitent reprendre, vous ne devez pas publier d’activités. Un bon exemple est une application simple à usage unique comme la calculatrice.
  • Applications métier : de nombreuses applications permettent de gérer des tâches ou des workflows simples. Créez une activité pour chaque workflow distinct accessible via votre application. Par exemple, chaque note de frais est une activité distincte, car vous souhaiterez peut-être sélectionner cette activité pour voir si elle a été approuvée.

Certaines applications complexes incluent plusieurs modèles d’interaction. Vous pouvez suivre différents modèles de création d’activités utilisateur pour différents scénarios gérés par votre application.

Prochaines étapes

Vous cherchez d’autres idées ?