userSettings リソースの種類

名前空間: microsoft.graph

コンテンツ検出に関する現在のユーザー設定を表します。 ユーザーの設定は、次のリソースに適用されます。

• Exchange の設定
• アイテム インサイト
• 作業時間と場所

ユーザーの Exchange 設定にアクセスします。 ユーザーに属するメールボックスを含む、Exchange 設定の一覧を取得します。

クラウドに保存されているユーザーの Windows 設定と値をエクスポートします。

• ユーザーの windowsSetting オブジェクトのリストを取得します。
• フィルター クエリで次のいずれかを渡して、ユーザーの windowsSetting オブジェクトのフィルター処理された一覧を取得します。
  • windowsSettingType
  • windowsDeviceId

勤務時間と場所の設定を管理する:

• ユーザーの作業時間と場所の設定を取得して更新し、スケジュールと空き時間管理を行います。
• 作業プランの繰り返しと発生にアクセスして、柔軟な作業形態を実現します。

エンティティ から継承します。 ユーザーの設定を更新したりする方法については、設定 と 設定を更新するを参照してください。

このリソースは以下をサポートしています。

• ユーザーとユーザーの組織がコンテンツの検出に貢献するかどうかを確認します。
• 特定のユーザーのコンテンツの検出を有効または無効にします。 Office Delve のドキュメントも無効になります。

注:

このエンドポイントは、ユーザーのみ使用できます。 このエンドポイントは、連絡先で使用できません。

メソッド

メソッド	戻り値の型	説明
Get settings	userSettings	ユーザーおよび組織の設定を取得します。
Update settings	userSettings	ユーザーの現在の設定を更新します。
Exchange 設定の一覧表示	exchangeSettings コレクション	ユーザーに属する Exchange メールボックスの一覧を取得します。
Windows の設定を一覧表示する	windowsSetting コレクション	サインインしているユーザーの windowsSetting オブジェクトとそのプロパティを取得します。
作業時間と場所を取得する	workHoursAndLocationsSetting	ユーザーの workHoursAndLocationsSetting のプロパティとリレーションシップを取得します。

プロパティ

プロパティ	型	説明
contributionToContentDiscoveryAsOrganizationDisabled	ブール値	組織レベルの設定が代理人アクセスを制御して、トレンド API へ反映します。 True に設定する場合は、組織は Office Delve へアクセスすることができません。 Microsoft 365 に表示されるコンテンツの関連性 (SharePoint ホームのおすすめサイトや職場や学校の OneDrive の検出ビューなど) は、organization全体に影響を受けます。 この設定は読み取り専用で、SharePoint 管理センターの管理者しか変更することができません。
contributionToContentDiscoveryDisabled	ブール値	ユーザーの代理人アクセスを true に設定すると、ユーザーのトレンド API は無効になります。 True に設定する場合、ユーザーの Office Delve のドキュメントは無効になります。 true に設定すると、SharePoint ホームのおすすめサイトや職場や学校の OneDrive の検出ビューなど、Microsoft 365 に表示されるコンテンツの関連性が影響を受けます。 ユーザーがこの設定で Office Delveを制御することができます。
id	文字列	ユーザー設定の一意識別子。 読み取り専用です。 エンティティから継承 されます。
windows	windowsSetting コレクション	クラウドに保存されているユーザーの Windows 設定。

リレーションシップ

リレーションシップ	型	説明
交換	exchangeSettings	メールボックス検出の Exchange 設定。
itemInsights	userInsightsSettings	会議時間の分析情報と、ユーザーと Microsoft 365 内の他のアイテム (ドキュメントやサイトなど) の間で派生した分析情報を可視化するためのユーザー設定。 このナビゲーション プロパティを使用して userInsightsSettings を取得します。
windows	windowsSetting コレクション	クラウドに保存されているユーザーの Windows 設定。
workHoursAndLocations	workHoursAndLocationsSetting	勤務時間に関するユーザーの設定と、スケジュールと空き時間管理のための場所の設定。

JSON 表記

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

{
  "contributionToContentDiscoveryDisabled": false,
  "contributionToContentDiscoveryAsOrganizationDisabled": false
}