itemInsights 资源类型

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

用户与项目之间的关系，例如使用高级分析和机器学习技术计算得出的OneDrive for Business文档。 例如，你可以标识与用户有关的 OneDrive for Business 文档趋势。 派生自 officeGraphInsights。

Insights 由以下 API 返回：

• 趋势 - 返回与用户有关的 OneDrive for Business 和 SharePoint 网站趋势文档。
• Used - 返回用户查看和修改过的文档。 包括用户在 OneDrive for Business 和 SharePoint 中使用的文档。
• Shared - 返回与用户共享的文档。 可作为电子邮件附件或电子邮件中发送的 OneDrive for Business 链接的文档。

返回的每个 insight 均为 resourceVisualization 和 resourceReference 复杂值类型 (CVT)。 resourceVisualization CVT 包含诸如 title 和 previewImageUrl 之类的属性。 Microsoft 使用可视化属性来渲染 Office Delve 等体验中的文件。

限制项目见解

更新 insightsSettings 以禁用特定 Azure AD 组或整个组织的项目见解。 有关详细信息，请参阅自定义见解隐私。

属性

无。

关系

关系	类型	说明
趋势	trending 集合	用于标识与用户趋势文档的计算关系。 趋势文档是根据用户最近的人际网络活动来计算的，包括存储在 OneDrive for Business 和 SharePoint 的文件。 趋势见解帮助用户发现可能有用的内容，这些内容用户有权访问，但之前从未看过。
使用的内容	usedInsight 集合	用于标识用户查看和修改的最新文档的计算关系，包括按使用时间排序的 OneDrive for Business 和 SharePoint 文档。
shared	sharedInsight 集合	用于识别与或用户共享的文档的计算关系，包括电子邮件和会议中的文件附件，以及在电子邮件、会议和 Teams 对话中找到的 OneDrive for business 和 SharePoint 文件的 URL 和参考附件。按共享时间排序。

JSON 表示形式

下面是资源的 JSON 表示形式。

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