Edit

Share via

itemInsights resource type

  • Article

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents relationships between a user and items such as OneDrive for work or school documents, calculated using advanced analytics and machine learning techniques. You can, for example, identify OneDrive for work or school documents trending around users. Derived from officeGraphInsights.

Insights are returned by the following APIs:

  • Shared - returns documents shared with a user. Documents can be shared as email attachments or as OneDrive for work or school links sent in emails.
  • Trending - returns documents from OneDrive for work or school and from SharePoint sites trending around a user.
  • Used - returns documents viewed and modified by a user. Includes documents the user used in OneDrive for work or school, and SharePoint.

Each insight is returned with a resourceVisualization and resourceReference complex value type (CVT). The resourceVisualization CVT contains properties such as title and previewImageUrl. Microsoft uses the visualization properties to render the files in experiences like Office Delve.

Limiting item insights

Update insightsSettings to disable item insights for a specific Microsoft Entra group or an entire organization. For more information, see customize insights privacy.

Properties

None.

Relationships

Relationship Type Description
shared sharedInsight collection Calculated relationship that identifies documents shared with or by the user, includes file attachments in emails and meetings, as well as URLs and reference attachments to OneDrive for work or school and SharePoint, files found in emails, meetings, and Teams conversations. Ordered by recency of share. Inherited from officeGraphInsights.
trending trending collection Calculated relationship that identifies documents trending around a user. Trending documents are calculated based on activity of the user's closest network of people and include files stored in OneDrive for work or school and SharePoint. Trending insights help users discover potentially useful content they have access to but have never viewed before. Inherited from officeGraphInsights.
used usedInsight collection Calculated relationship that identifies the latest documents viewed and modified by a user, including OneDrive for work or school and SharePoint documents. Ranked by recency of use. Inherited from officeGraphInsights.

JSON representation

The following JSON representation shows the resource type.

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