itemInsights 资源类型

重要

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

用户与工作或学校文档的 OneDrive 等项之间的关系，使用高级分析和机器学习技术进行计算。 例如，可以识别面向用户的工作或学校文档的 OneDrive。 派生自 officeGraphInsights。

Insights 由以下 API 返回：

• 趋势 - 从 OneDrive 中返回工作或学校的文档，以及从用户周围趋势的 SharePoint 网站返回文档。
• Used - 返回用户查看和修改过的文档。 包括用户在 OneDrive 中用于工作或学校和 SharePoint 的文档。
• Shared - 返回与用户共享的文档。 文档可以作为电子邮件附件共享，也可以作为电子邮件中发送的工作或学校链接的 OneDrive 共享。

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

限制项目见解

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

属性

无。

关系

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

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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