itemInsights リソースの種類

重要

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

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

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

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

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

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

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

プロパティ

なし

リレーションシップ

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

JSON 表記

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

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