insightsSettings リソースの種類

名前空間: microsoft.graph

重要

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

組織内の特定の種類の分析情報の表示またはプログラムによるリターンを計算および管理するための設定を表します。 分析情報には、連絡先の分析情報、アイテムの分析情報、会議時間の分析情報、またはユーザーの分析情報があります。

連絡先分析情報は、Microsoft 365 でユーザーの連絡先を整理するためのインテリジェントな提案を表します。 プログラムによって、ユーザーの連絡先は 連絡先 リソースによって表されます。 連絡先分析情報の例としては、Outlook のエンド ユーザーが使用できる、重複する連絡先の差し込み候補があります。

アイテム分析情報と 会議時間分析情報 は、Microsoft 365 のドキュメント、サイト、その他のコンテンツ タイプなどのユーザーとアイテム間の関係を表します。 プログラムによって、 itemInsights リソースによって表されます。 ユーザーと 共有 されているドキュメント、ユーザーの 周りのトレンド 、またはユーザーによって 使用される ドキュメントを取得できます。 insightsSettings を使用して、組織内のアイテム分析情報を計算、表示、または返すプライバシー設定をカスタマイズできます。

People Insights は、パブリックリレーションシップに基づいて相互に関連している、または互いに協力する人のつながりを表します。 プログラムによって、個々のユーザーは 人物 リソースによって表されます。 people API を使用して、ユーザーの分析情報を取得できます。 insightsSettings を使用して、ユーザーの分析情報を表示または返すプライバシー設定をカスタマイズできます。

一方、アイテム分析情報と 会議時間分析情報の場合は、 userInsightsSettings リソースを使用して、ユーザー レベルで計算と可視性を管理することもできます。

メソッド

メソッド	戻り値の型	説明
contactInsights を一覧表示する	insightsSettings	組織内の連絡先分析情報を表示するための insightsSettings リソースのプロパティを取得します。
itemInsights を一覧表示する	insightsSettings	組織内のアイテム分析情報を表示または返す insightsSettings オブジェクトのプロパティを取得します。
peopleInsights を一覧表示する	insightsSettings	組織内の ユーザー分析情報を表示するための insightsSettings リソースのプロパティを取得します。
insightsSettings を更新する	insightsSettings	insightsSettings リソースのプロパティを更新して、指定した種類の分析情報 (連絡先分析情報、アイテム分析情報、またはユーザー分析情報) の表示または返しを管理します。

プロパティ

プロパティ	種類	説明
disabledForGroup	String	Microsoft Entra グループの ID。指定された種類の分析情報がそのメンバーに対して無効になっています。 既定値は null です。 省略可能。
isEnabledInOrganization	ブール型	true 指定した型の分析情報が組織に対して有効になっている場合。指定した型の分析情報が例外なしですべてのユーザーに対して無効になっている場合に false します。 既定値は true です。 省略可能。

JSON 表記

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

{
  "disabledForGroup": "String",
  "isEnabledInOrganization": "Boolean"
}