officeGraphInsights リソースの種類

名前空間: microsoft.graph

インサイトとは、高度な分析と機械学習の機能を使って計算されるリレーションシップのことです。 たとえば、ユーザーの周囲で人気急上昇中の OneDrive for Business ドキュメントを特定することができます。

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

• Trending - ユーザーの周囲で人気上昇中の OneDrive for Business ドキュメントや SharePoint サイトを返します。
• Used - ユーザーが表示または変更したドキュメントを返します。 ユーザーが OneDrive for Business および SharePoint で使用したドキュメントが含まれます。
• Shared - ユーザーと共有またはユーザーが共有したドキュメントを返します。 ドキュメントは、URL、添付ファイル、Outlook メッセージや会議で見つかる OneDrive for Business および SharePoint ファイルへの参照添付ファイルとして共有できます。

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

リレーションシップ

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