Veille sur les contacts et l’espace de travail dans Microsoft Graph

  • Article

Les centaines de millions d’utilisateurs des services cloud de Microsoft 365 constituent le cœur de Microsoft Graph. Les données des utilisateurs sont gérées, protégées avec soin, et mises à disposition avec l’autorisation appropriée, par les services Microsoft Graph afin de stimuler la productivité et la créativité dans les entreprises.

L’API de profil vous permet, en tant que développeurs d’applications, de modéliser et de représenter des personnes dans les services Microsoft 365, et l’API de carte de visite permet aux administrateurs de contrôler les informations qui s’affichent sur les cartes de profil des utilisateurs dans l’organisation.

Étant donné que les données de l’utilisateur sont omniprésentes dans Microsoft Graph, les données dérivées des interactions de l’utilisateur sont particulièrement intéressantes. Elles fournissent des informations pertinentes pouvant répondre à des questions du type :

  • « Rechercher les personnes qui utilisent le nom commence par «J »»
  • « Quels documents sont les plus intéressants pour cette personne ? »

Vous pouvez utiliser l’API Contacts et l’API Information dans Microsoft Graph pour créer des applications plus intelligentes qui peuvent, respectivement, accéder aux personnes et documents pertinents pour un utilisateur.

L’API contacts retourne les personnes classées par pertinence pour un utilisateur, en fonction des contacts de cet utilisateur, de son répertoire organization et des communications récentes sur les e-mails. Ceci est particulièrement utile pour les scénarios de sélection de contacts.

L’API Informations utilise des analyses avancées et l’apprentissage machine pour fournir les fichiers les plus pertinents dont les utilisateurs ont besoin pendant leur journée de travail. L’API alimente les expériences Microsoft 365 classiques, notamment Office Delve, SharePoint Home, le mode Découvrir dans OneDrive Entreprise et Outlook sur le web.

Les API Contacts et Informations renvoient les contacts et les documents appropriés d’un utilisateur

Pourquoi intégrer les données de contacts ?

L’API Contacts renvoie les données d’une seule entité, personne, qui inclut les données typiques d’un individu dans le monde des entreprises d’aujourd’hui. Ce qui rend les données de cette personne particulièrement utiles est leur pertinence pour un utilisateur de Microsoft Graph. La pertinence est notée dans les résultats retournés qui sont classés du plus pertinent au moins pertinent. Vous pouvez utiliser les API Microsoft Graph suivantes pour rechercher des personnes à l’intérieur d’un organization.

Utiliser le point de terminaison /search

Nous encourageons les développeurs à utiliser le point de terminaison lors de la /search création de leurs produits ; le point de /people terminaison est en mode maintenance. Voici les raisons d’utiliser le point de /search terminaison :

  • Tous les investissements futurs dans la recherche de personnes seront rendus disponibles via /search; par exemple, la recherche en langage naturel comme « John le comptable à Nairobi ».
  • La recherche d’attributs correspondant à des attributs autres que le nom et l’adresse e-mail est disponible.
  • De meilleurs résultats de pertinence donnent de /search meilleurs résultats en raison de l’utilisation de l’intelligence artificielle, de meilleurs modèles de données et de la correction orthographique sophistiquée.
  • Réduction du coût des biens lors de l’utilisation /searchde , mais plus particulièrement d’une latence plus faible.

Parcourir des contacts par pertinence

Vous pouvez parcourir des contacts qui sont liés à l’utilisateur connecté ou à un autre utilisateur dans l’organisation de l’utilisateur connecté, à condition de disposer de l’autorisation appropriée. Vous obtenez une collection d’objets person classés selon leur pertinence. Vous pouvez personnaliser davantage la collection d’objets person renvoyée dans la réponse en spécifiant les paramètres de requête top, skip, orderby, select et filter.

Recherches analogiques en fonction de critères de contacts

L’API Contacts vous permet de rechercher des contacts associés à l’utilisateur connecté, à condition que l’utilisateur ait octroyé des autorisations à votre application. (En savoir plus sur les autorisations de personnes.)

Les recherches analogiques renvoient des résultats fondés sur une correspondance exacte, ainsi que sur des inférences relatives à l’objectif de la recherche. Pour illustrer cela, l’exemple suivant renvoie des objets person associés à l’utilisateur connecté dont le nom ou l’adresse e-mail contient un mot qui commence par « j ».

GET /me/people/?$search=j

Pourquoi une intégration avec l’API de profil (version préliminaire) ?

L’API de profil représente la nouvelle génération de modélisation et de représentation des contacts dans les services Microsoft 365. Les données de profil peuvent être utilisées conjointement avec les données des contacts pour créer des expériences personnalisées basées sur Microsoft Graph.

Pourquoi configurer des cartes de profil dans votre organization ?

Les cartes de profil permettent aux utilisateurs d’une organisation de consulter des informations relatives aux autres utilisateurs, comme leurs noms et leurs coordonnées. Les administrateurs peuvent utiliser l’API de carte de profil pour personnaliser la façon dont les informations relatives à leur organisation apparaissent dans l’expérience utilisateur de Microsoft 365.

Pourquoi configurer des pronoms dans votre organization ?

Les pronoms servent de substituts au nom d’une personne dans les phrases, avec des versions non sexistes disponibles dans plusieurs langues, par exemple en anglais, « elle », « elle », « il », « lui » et les « ils », « eux » et « eux ». L’utilisation précise des pronoms montre l’inclusivité et le respect, en évitant les hypothèses basées sur les noms ou les observations initiales de la personne. Dans un environnement professionnel ou scolaire hybride et multiculturel, le simple fait d’utiliser les bons pronoms peut aider à instaurer la confiance et à améliorer la communication entre les uns et les autres. Les administrateurs peuvent utiliser l’API pronomsSettings pour configurer les paramètres de pronoms dans votre organization.

Pourquoi intégrer des informations issues des documents ?

Utiliser la veille pour améliorer la collaboration

Pendant une journée de travail classique, les utilisateurs interagissent souvent avec de grandes quantités d’informations stockées dans plusieurs documents et collaborent avec d’autres utilisateurs de plusieurs manières différentes. Il est important qu’ils puissent toujours trouver ce dont ils ont besoin, quand ils en ont besoin.

Vous pouvez utiliser les API Informations avec les API de tendance, de partage et d’utilisation pour faire apparaître les fichiers de Microsoft 365 en fonction du contexte et des besoins actuels de vos utilisateurs, ce qui rend les utilisateurs plus productifs et améliore la collaboration au sein de votre organisation. Les organisations peuvent personnaliser les paramètres de confidentialité pour ces informations basées sur des documents et contrôler la disponibilité de ces informations dans des expériences Microsoft 365 spécifiques.

Il est simple de générer le rendu des résultats issus de l’API Informations dans votre application. Chaque résultat est fourni avec un ensemble de propriétés de visualisation courantes, comme une URL d’image de prévisualisation ou un texte de prévisualisation.

Rendre le contenu pertinent visible

Dans Microsoft 365, Delve utilise l’information trending pour aider les utilisateurs à découvrir les documents qui sont les plus intéressants pour eux à l’heure actuelle. Voir figure 1.

Par programme, vous pouvez utiliser l’entité trending dans l’API Informations pour fournir une expérience similaire aux clients de votre application. Utilisez l’entité trending pour vous connecter aux documents les plus demandés associés à l’utilisateur. Répertorier les documents les plus demandés renvoie les fichiers stockés sur les sites d’équipe OneDrive ou SharePoint, triés par pertinence, les plus importants apparaissant en premier.

Figure 1. Delve dans Microsoft 365 montrant des documents populaires pour un utilisateur

Capture d’écran de Delve dans Microsoft 365 indiquant les documents les plus demandés pour un utilisateur

Permettre aux utilisateurs de collaborer et de se remettre au travail

Les nouvelles cartes de contacts Microsoft 365 exploitent les informations used et shared pour établir un lien entre les contacts et les unités de connaissances. La carte de contacts identifie et affiche les documents pertinents concernant une personne. Les utilisateurs peuvent afficher les cartes de contacts dans la suite, par exemple, dans Outlook sur le web. Voir figure 2.

L’API Informations offre une fonctionnalité similaire avec les entités used et shared. Elles renvoient les éléments affichés ou utilisés très récemment par un utilisateur, ou les éléments partagés récemment par des collègues avec l’utilisateur dans Microsoft 365.

Figure 2. Outlook sur le web montrant un carte de personnes pour un utilisateur

Capture d’écran d’une carte de contacts pour un utilisateur dans Outlook sur le web, affichant des fichiers récents

Pourquoi intégrer à Microsoft Viva Insights (préversion) ?

Microsoft Viva Insights fournit des informations sur la façon dont les gens passent leur temps et avec qui ils le passent. Ces données peuvent aider les utilisateurs à planifier leur journée, à se familiariser avec leurs habitudes de travail et à concilier vie professionnelle et vie personnelle.

L’API Analytics vous permet de synchroniser ou d’intégrer des données d’analyse utilisateur avec une application tierce personnalisée pour prendre en charge un large éventail de scénarios qui peuvent contribuer à améliorer la productivité et la collaboration des utilisateurs. Par exemple, vous pouvez intégrer des données Viva Insights aux activités d’appareil mobile pour aider les utilisateurs à suivre toutes leurs activités professionnelles et sociales et à planifier leur journée au sein d’une seule application.

Référence d’API

Vous recherchez la référence d’API pour ces services ?

Étapes suivantes