itemInsights リソースの種類

[アーティクル]
03/26/2023

重要

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

ユーザーと OneDrive for Business ドキュメントなどのアイテムとのリレーションシップであり、高度な分析と機械学習の手法を使用して計算されます。たとえば、ユーザーの周囲で人気急上昇中の OneDrive for Business ドキュメントを特定することができます。 officeGraphInsights から派生します。

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

Trending - ユーザーの周囲で人気上昇中の OneDrive for Business ドキュメントや SharePoint サイトを返します。
Used - ユーザーが表示および変更したドキュメントを返します。ユーザーが OneDrive for Business および SharePoint で使用したドキュメントが含まれます。
Shared - ユーザーと共有されているドキュメントを返します。ドキュメントは、メールの添付ファイルとして、またはメールで送信した OneDrive for Business のリンクとして共有できます。

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

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

insightsSettingsを更新し、特定のグループまたは組織全体Azure ADインサイトを無効にします。詳細については、「分析情報のプライバシーをカスタマイズする」をご覧ください。

プロパティ

なし

リレーションシップ

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

JSON 表記

以下は、リソースの JSON 表記です

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