itemInsights リソースの種類

名前空間: microsoft.graph

高度な分析と機械学習の手法を使用して計算された、職場または学校のドキュメント用の OneDrive などのユーザーとアイテム間のリレーションシップを表します。 たとえば、ユーザーを中心にトレンドになっている職場や学校のドキュメントの OneDrive を特定できます。 officeGraphInsights から派生します。

インサイトは、次の API によって返されます。

  • Shared - ユーザーと共有されているドキュメントを返します。 ドキュメントは、メールの添付ファイルとして、またはメールで送信された職場または学校のリンク用の OneDrive として共有できます。
  • [傾向] - 職場または学校用の OneDrive から、およびユーザーを中心に傾向を持つ SharePoint サイトからドキュメントを返します。
  • Used - ユーザーが表示および変更したドキュメントを返します。 OneDrive で職場または学校および SharePoint で使用されるドキュメントが含まれます。

各分析情報は、resourceVisualization および resourceReference の複合値の型 (CVT) で返されます。 resourceVisualization CVT には、titlepreviewImageUrl などのプロパティが含まれています。 Microsoft では、視覚化プロパティを使って Office Delve のようなエクスペリエンスでファイルをレンダリングします。

アイテムの分析情報を制限する

insightsSettings を更新して、特定の Microsoft Entra グループまたは組織全体のアイテム分析情報を無効にします。 詳細については、「 分析情報のプライバシーをカスタマイズする」を参照してください。

プロパティ

なし

リレーションシップ

リレーションシップ 説明
共有 sharedInsight コレクション ユーザーと共有またはユーザーが共有するドキュメントを識別する計算された関係には、メールや会議の添付ファイルのほか、職場または学校や SharePoint 用の OneDrive への URL と参照添付ファイル、メール、会議、Teams の会話に含まれるファイルが含まれます。 共有の最近順で並べ替えられました。 officeGraphInsights から継承されます。
trending trending コレクション ユーザーの周りの傾向を示すドキュメントを識別する計算されたリレーションシップ。 傾向のあるドキュメントは、ユーザーの最も近いユーザー ネットワークのアクティビティに基づいて計算され、職場または学校および SharePoint 用の OneDrive に格納されているファイルが含まれます。 トレンド分析情報は、ユーザーがアクセスできるが、これまでに表示したことがない、有用な可能性のあるコンテンツを検出するのに役立ちます。 officeGraphInsights から継承されます。
used usedInsight コレクション 職場または学校用の OneDrive や SharePoint ドキュメントなど、ユーザーが表示および変更した最新のドキュメントを識別する計算リレーションシップ。 使用のレジェンシーでランク付けされます。 officeGraphInsights から継承されます。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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