itemInsights リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

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

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

各分析情報は、resourceVisualization および resourceReference の複合値の型 (CVT) で返されます。 resourceVisualization CVT には、title や previewImageUrl などのプロパティが含まれています。 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" } ]
}