itemInsights type de ressourceitemInsights resource type

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .To determine whether an API is available in v1.0, use the Version selector.

Les relations entre un utilisateur et des éléments tels que les documents OneDrive Entreprise, calculées à l'aide de techniques d'analyse et d'apprentissage automatique avancées.Relationships between a user and items such as OneDrive for Business documents, calculated using advanced analytics and machine learning techniques. Vous pouvez, par exemple, identifier les documents de OneDrive Entreprise qui suivent les tendances des utilisateurs.You can, for example, identify OneDrive for Business documents trending around users. Dérivé de officeGraphInsights.Derived from officeGraphInsights.

Les informations sont renvoyés par les API suivantes :Insights are returned by the following APIs:

  • Trending : renvoie des documents à partir de OneDrive Entreprise et des sites SharePoint qui sont populaires pour un utilisateur.Trending - returns documents from OneDrive for Business and from SharePoint sites trending around a user.
  • Utilisé – renvoie les documents consultés et modifiés par un utilisateur.Used - returns documents viewed and modified by a user. Inclut les documents déjà utilisés dans OneDrive Entreprise et SharePoint.Includes documents the user used in OneDrive for Business, and SharePoint.
  • Shared : renvoie les documents partagés avec un utilisateur.Shared - returns documents shared with a user. Les documents peuvent être partagés en tant que pièces jointes ou en tant que lien OneDrive for Business envoyés dans des messages électroniques.Documents can be shared as email attachments or as OneDrive for Business links sent in emails.

Chaque insight est renvoyé avec un type de valeur complexes (CVT) resourceVisualization et resourceReference.Each insight is returned with a resourceVisualization and resourceReference complex value type (CVT). Le CVT ResourceVisualization contient des propriétés telles que title et previewImageUrl.The resourceVisualization CVT contains properties such as title and previewImageUrl. Microsoft utilise les propriétés de visualisation pour afficher les fichiers dans les expériences tels que Office Delve.Microsoft uses the visualization properties to render the files in experiences like Office Delve.

Limiter les aperçus d'articlesLimiting item insights

Mettre à jour les itemInsightsSettings pour désactiver les aperçus d'articles pour un groupe Azure AD spécifique ou une organisation entière.Update itemInsightsSettings to disable item insights for a specific Azure AD group or an entire organization. Pour plus dínformations, voir Personnaliser la confidentialité des informations.For more details, see customize insights privacy.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
trendingtrending Collection trendingtrending collection Relation calculée identifiant les documents populaires auprès d’un utilisateur.Calculated relationship identifying documents trending around a user. Les documents les plus populaires sont calculés sur la base de l’activité du réseau de personnes le plus proche de l’utilisateur et l’ajout de fichiers stockés dans OneDrive Entreprise et SharePoint.Trending documents are calculated based on activity of the user's closest network of people and include files stored in OneDrive for Business and SharePoint. Les aperçus des tendances permettent à l’utilisateur de découvrir un contenu potentiellement utile auquel il a accès, mais qui ne l’a jamais consulté.Trending insights help the user to discover potentially useful content that the user has access to, but has never viewed before.
usedused Collection usedInsightusedInsight collection Relation calculée identifiant les derniers documents consultés et modifiés par un utilisateur, y compris les documents OneDrive Entreprise et SharePoint, classés par ordre de leur utilisation récente.Calculated relationship identifying the latest documents viewed and modified by a user, including OneDrive for Business and SharePoint documents, ranked by recency of use.
partagéshared Collection sharedInsightsharedInsight collection Relation calculée qui identifie les documents partagés avec ou par l’utilisateur, inclut les pièces jointes dans les e-mails et les réunions, ainsi que les URL et pièces jointes de référence aux fichiers OneDrive Entreprise et SharePoint présents dans les e-mails, les réunions et les conversations Teams.Calculated relationship identifying documents shared with or by the user, includes file attachments in emails and meetings, as well as URLs and Reference attachments to OneDrive for Business and SharePoint files found in emails, meetings, and Teams conversations. Classé par partage du plus au moins récent.Ordered by recency of share.

Représentation JSONJSON representation

Voici une représentation JSON de la ressourceHere is a JSON representation of the resource

{
  "id": "string",
  "trending": [ { "@odata.type": "microsoft.graph.trending" } ],
  "used": [ { "@odata.type": "microsoft.graph.used" } ],
  "shared": [ { "@odata.type": "microsoft.graph.shared" } ]
}