名前空間: microsoft.graph
注:
officeGraphInsights の代わりに itemInsights を使用して、insights API にアクセスします。
officeGraphInsights は、以前のバージョンの insights API との下位互換性のために維持されます。 itemInsights の基本型です。
インサイトとは、高度な分析と機械学習の機能を使って計算されるリレーションシップのことです。 たとえば、ユーザーを中心にトレンドになっている職場や学校のドキュメントの OneDrive を特定できます。
インサイトは、次の API によって返されます。
- [傾向] - 職場または学校用の OneDrive から、およびユーザーを中心に傾向を持つ SharePoint サイトからドキュメントを返します。
- Used - ユーザーが表示または変更したドキュメントを返します。 職場または学校の OneDrive でユーザーが使用するドキュメントと SharePoint が含まれます。
- Shared - ユーザーと共有またはユーザーが共有したドキュメントを返します。 ドキュメントは、URL、添付ファイル、職場または学校用の OneDrive への参照添付ファイル、Outlook のメッセージや会議で見つかった SharePoint ファイルとして共有できます。
各分析情報は、resourceVisualization および resourceReference の複合値の型 (CVT) で返されます。 resourceVisualization CVT には、title や previewImageUrl などのプロパティが含まれています。 Microsoft では、視覚化プロパティを使って Office Delve のようなエクスペリエンスでファイルをレンダリングします。
プロパティ
なし
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| 共有 | sharedInsight コレクション | ユーザーと共有またはユーザーが共有するドキュメントを識別する計算リレーションシップ。 これには、職場または学校用の OneDrive への URL、添付ファイル、参照添付ファイル、Outlook のメッセージや会議で見つかった SharePoint ファイルが含まれます。 これには、URL と Teams の会話への参照添付ファイルも含まれます。 共有の最近順で並べ替えられました。 |
| trending | trending コレクション | ユーザーの周りの傾向を示すドキュメントを識別する計算されたリレーションシップ。 傾向のあるドキュメントは、ユーザーの最も近いユーザー ネットワークのアクティビティに基づいて計算され、職場または学校および SharePoint 用の OneDrive に格納されているファイルが含まれます。 トレンド分析は、ユーザーがアクセスできるが以前に表示したことのない潜在的に有用なコンテンツを発見するのに役立ちます。 |
| used | usedInsight コレクション | 職場または学校用の OneDrive や SharePoint ドキュメントなど、ユーザーが表示または変更した最新のドキュメントを識別する計算されたリレーションシップ。使用の再使用度によってランク付けされます。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"id": "string",
"shared": [ { "@odata.type": "microsoft.graph.shared" } ],
"trending": [ { "@odata.type": "microsoft.graph.trending" } ],
"used": [ { "@odata.type": "microsoft.graph.used" } ]
}