officeGraphInsights リソースの種類

名前空間: microsoft.graph

重要

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

officeGraphInsights の代わりに itemInsights を使用して、Insights API にアクセスします。

officeGraphInsights は、以前のバージョンの Insights API からの下位互換性を保つためのものです。 itemInsights の基本の種類です。

インサイトとは、高度な分析と機械学習の機能を使って計算されるリレーションシップのことです。 たとえば、ユーザーの周囲で人気急上昇中の 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 のようなエクスペリエンスでファイルをレンダリングします。

リレーションシップ

リレーションシップ	型	説明
trending	trending コレクション	このプロパティには、派生型 itemInsights からアクセスします。
used	usedInsight コレクション	このプロパティには、派生型 itemInsights からアクセスします。
共有	sharedInsight コレクション	このプロパティには、派生型 itemInsights からアクセスします。

JSON 表記

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

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