Vue d’ensemble de la veille sur les contacts et l’espace de travail dans Microsoft GraphOverview of people and workplace intelligence in Microsoft Graph

Les centaines de millions d’utilisateurs des services cloud de Microsoft 365 constituent le cœur de Microsoft Graph.The hundreds of millions of users of Microsoft 365 cloud services form part of the core of 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.The users' data is carefully managed, protected, and with proper authorization, made available by Microsoft Graph services to drive productivity and creativity in businesses.

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 profil permet aux administrateurs de contrôler les informations affichées sur les cartes de profil des utilisateurs dans l’organisation.The profile API lets you, as app developers, model and represent people in Microsoft 365 services, and the profile card API lets administrators control the information showing on users' profile cards in the organization.

Les données de l’utilisateur sont omniprésentes dans Microsoft Graph et les données issues des interactions sociales de l’utilisateur sont particulièrement intéressantes.As ubiquitous the user's data is in Microsoft Graph, data derived from the user's social interactions is particularly interesting. Elles fournissent des informations pertinentes pouvant répondre à des questions du type :It provides intelligent insights that can answer questions such as the following:

  • « Qui cet utilisateur doit-il contacter pour obtenir des informations à ce sujet ? »"Who should this user contact for information on this topic?"
  • « Quels documents sont les plus intéressants pour cette personne ? »"Which documents are most interesting to this person?"

Vous pouvez utiliser l’API Contacts et l’API Informations dans Microsoft Graph pour créer des applications qui peuvent respectivement accéder aux contacts et aux documents appropriés d’un utilisateur.You can use the people API and insights API in Microsoft Graph to build smarter apps that can, respectively, access the relevant people and documents for a user.

L’API Contacts renvoie des contacts classés par pertinence pour un utilisateur, en fonction des contacts, des réseaux sociaux, de l’annuaire de l’organisation et des communications récentes sur e-mail et Skype.The people API returns people ordered by relevance to a user, based on that user's contacts, social networks, organization directory, and recent communications on email and Skype. Ceci est particulièrement utile pour les scénarios de sélection de contacts.This is particularly useful for people-picking scenarios.

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.The insights API uses advanced analytics and machine learning to provide the most relevant files users need throughout their work day. 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.The API powers familiar Microsoft 365 experiences, including Office Delve, SharePoint Home, the Discover view in OneDrive for Business, and Outlook on the 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 ?Why integrate with people data?

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.The people API returns data of a single entity, person, which includes typical data of an individual in today's business world. Ce qui rend les données de cette personne particulièrement utiles est leur pertinence pour un utilisateur de Microsoft Graph.What makes this person data especially useful is its relevance with respect to a Microsoft Graph user. La pertinence est indiquée dans la note de pertinence de chaque personne. Elle est calculée en fonction des modèles de communication et de collaboration de l’utilisateur, et des relations commerciales.Relevance is noted in a relevance score of each person, calculated based on the user's communication and collaboration patterns and business relationships. Il y a 3 types principaux d’application de ces données de pertinence.There are 3 main types of application of this relevance data.

Parcourir des contacts par pertinenceBrowse people by relevance

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.You can browse people who are related to the signed-in user or to some other user in the signed-in user's organization, provided you have got the appropriate authorization. Vous obtenez une collection d’objets person classés selon leur pertinence.You get a collection of person objects that are ordered by relevance. 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.You can further customize the collection of person objects that is returned in the response by specifying the query parameters top, skip, orderby, select, and filter.

Recherches analogiques en fonction de critères de contactsFuzzy searches based on people criteria

L’API Contacts vous permet de rechercher des contacts associés à l’utilisateur connecté, à condition que l’utilisateur ait octroyé des autorisations à votre application.The people API lets you search for people relevant to the signed-in user, provided that your app has got permissions by that user. (En savoir plus sur les autorisations de personnes.)(Read more on people permissions.)

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.Fuzzy searches return results based on an exact match and also on inferences about the intent of the search. 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 ».To illustrate this, the following example returns person objects relevant to the signed-in user whose name, or email address, contains a word that starts with 'j'.

GET /me/people/?$search=j

Recherches analogiques en fonction de critères de sujetsFuzzy searches based on topic criteria

L’API Contacts vous permet également de rechercher des contacts associés à l’utilisateur connecté qui ont exprimé le souhait de communiquer avec cet utilisateur sur différents « sujets ».The people API also lets you perform searches for people who are relevant to the signed-in user, and have expressed an interest in communicating with that user over certain "topics". Les sujets correspondent aux mots les plus utilisés par les utilisateurs dans les e-mails.Topics are just words that have been used most by users in email conversations. Microsoft extrait ces mots, dépourvus de contexte, et crée un index de données pour faciliter les recherches analogiques.Microsoft extracts such words, free of their contexts, and creates an index for this data to facilitate fuzzy searches.

L’exemple suivant illustre les inférences relatives à l’objectif d’une recherche sur le sujet « beetle » :The following example illustrates inferences about the intent of a search on the topic "beetle":

GET /me/people/?$search="topic:beetle" 

Une recherche analogique dans l’index des données du sujet renvoie des instances correspondant à l’insecte beetle, la voiture Volkswagen Beetle, le groupe de musique Beatles et d’autres définitions.A fuzzy search in the topic data index return instances that mean the beetle insect, the iconic Volkswagen Beetle car, the Beatles band, and other definitions.

Pourquoi une intégration avec l’API de profil (version préliminaire) ?Why integrate with the profile API (preview)?

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.The profile API represents the next generation in modeling and representing people in Microsoft 365 services. 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.Profile data can be used together with people data to build customized experiences based on Microsoft Graph.

Pourquoi configurer des cartes de profil dans votre organisation (préversion) ?Why configure profile cards in your organization (preview)?

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.Profile cards let users in an organization see information about one another, such as their names and contact information. 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.Administrators can use the profile card API to customize how information about their organization surfaces within Microsoft 365 people experiences.

Pourquoi intégrer des informations issues des documents ?Why integrate with document-based insights?

Utiliser la veille pour améliorer la collaborationUse intelligence to improve 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.During a typical work day, users often interact with large amounts of information stored across many documents and collaborate with other users in many different ways. Il est important qu’ils puissent toujours trouver ce dont ils ont besoin, au moment où ils en ont besoin.It's important that they can always can find what they need, when they need it.

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.You can use the insights API, which includes the trending, shared, and used APIs, to surface files from across Microsoft 365 based on your users' current context and needs, making users more productive and improving collaboration in your organization. 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.Organizations can customize privacy settings for these document-based insights, and control the availability of these insights in specific Microsoft 365 experiences.

Il est simple de générer le rendu des résultats issus de l’API Informations dans votre application.It is easy to render the results from the insights API in your app. 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.Every result comes with a set of common visualization properties, like a preview image URL or preview text.

Rendre le contenu pertinent visibleMake relevant content 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.In Microsoft 365, Delve uses the trending insight to help users discover the documents that are most interesting to them right now. Voir figure 1.See 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.Programmatically, you can use the trending entity in the insights API to provide your app customers a similar experience. Utilisez l’entité trending pour vous connecter aux documents les plus demandés associés à l’utilisateur.Use the trending entity to connect to documents that are trending around and relevant to the user. 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.Listing trending documents returns those files stored on OneDrive or SharePoint team sites, sorted by relevance with the most important ones first.

Figure 1. Delve dans Microsoft 365 affichant les documents les plus demandés pour un utilisateurFigure 1. Delve in Microsoft 365 showing popular documents for a user

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 travailAllow users to collaborate and get back to work

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.The new Microsoft 365 people cards tap into the used and shared insights to connect the dots between people and units of knowledge. La carte de contacts identifie et affiche les documents pertinents concernant une personne.The people card identifies and displays relevant documents about a person. Les utilisateurs peuvent afficher les cartes de contacts dans la suite, par exemple, dans Outlook sur le web.Users can see people cards across the suite, for example, in Outlook on the web. Voir figure 2.See figure 2.

L’API Informations offre une fonctionnalité similaire avec les entités used et shared.The insights API provides a similar functionality with the used and shared entities. 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.They return what a user has been viewing or working on most recently, or what colleagues have shared with the user most recently in Microsoft 365.

Figure 2. Outlook sur le web affichant une carte de contacts pour un utilisateurFigure 2. Outlook on the web showing a people card for a user

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

Pourquoi intégrer MyAnalytics (préversion) ?Why integrate with MyAnalytics (preview)?

MyAnalytics fournit des informations sur la façon dont les gens passent leur temps et avec qui ils le passent.MyAnalytics provides insight into how people spend their time and who they spend it with. 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.This data can help people plan their day, gain insights into their different work patterns, and help them balance work and life.

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.The analytics API enables you to synchronize or integrate user analytics data with a custom, third-party app to support a wide range of scenarios that can help improve user productivity and collaboration. Par exemple, vous pourriez intégrer les données de MyAnalytics aux activités des appareils mobiles pour aider les utilisateurs à suivre toutes leurs activités professionnelles et sociales et à planifier leur journée dans une même application.For example, you could integrate MyAnalytics data with mobile device activities to help users keep track of all their work and social activities and plan their day all within one app.

Référence d’APIAPI reference

Vous recherchez la référence d’API pour ces services ?Looking for the API reference for these services?

Étapes suivantesNext steps