userExperienceAnalyticsOverview の更新

[アーティクル]
02/01/2022

名前空間: microsoft.graph

大事な： Microsoft Graph /beta バージョンの API は変更される可能性があります。実稼働環境での使用はサポートされていません。

注: Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

userExperienceAnalyticsOverview オブジェクトのプロパティを更新します。

前提条件

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

HTTP 要求

PATCH /deviceManagement/userExperienceAnalyticsOverview

要求ヘッダー

ヘッダー	値
Authorization	ベアラー <トークン> が必要です。
承諾	application/json

要求本文

要求本文で、 userExperienceAnalyticsOverview オブジェクトの JSON 表記を指定します。

次の表に、 userExperienceAnalyticsOverview を作成するときに必要なプロパティを示します。

プロパティ	種類	説明
id	String	ユーザーエクスペリエンス分析の概要の一意の識別子。
overallScore	Int32	ユーザーエクスペリエンス分析の全体的なスコア。
deviceBootPerformanceOverallScore	Int32	ユーザーエクスペリエンス分析デバイスの起動パフォーマンスの全体的なスコア。
bestPracticesOverallScore	Int32	ユーザーエクスペリエンス分析のベストプラクティスの全体的なスコア。
workFromAnywhereOverallScore	Int32	ユーザーエクスペリエンス分析 Work From Anywhere 全体的なスコア。
appHealthOverallScore	Int32	ユーザーエクスペリエンス分析アプリの正常性の全体的なスコア。
resourcePerformanceOverallScore	Int32	ユーザーエクスペリエンス分析リソースのパフォーマンスの全体的なスコア。
batteryHealthOverallScore	Int32	ユーザーエクスペリエンス分析バッテリーの正常性の全体的なスコア。
insights	userExperienceAnalyticsInsight コレクション	ユーザーエクスペリエンス分析の分析情報。
state	userExperienceAnalyticsHealthState	ユーザーエクスペリエンス分析の概要の現在の正常性状態。使用可能な値は、`unknown`、`insufficientData`、`needsAttention`、`meetingGoals` です。
deviceBootPerformanceHealthState	userExperienceAnalyticsHealthState	ユーザーエクスペリエンス分析 'BootPerformance' カテゴリの現在の正常性状態。使用可能な値: `unknown`、`insufficientData`、`needsAttention`、`meetingGoals`。
bestPracticesHealthState	userExperienceAnalyticsHealthState	ユーザーエクスペリエンス分析 'BestPractices' カテゴリの現在の正常性状態。使用可能な値: `unknown`、`insufficientData`、`needsAttention`、`meetingGoals`。
workFromAnywhereHealthState	userExperienceAnalyticsHealthState	ユーザーエクスペリエンス分析 'WorkFromAnywhere' カテゴリの現在の正常性状態。使用可能な値: `unknown`、`insufficientData`、`needsAttention`、`meetingGoals`。
appHealthState	userExperienceAnalyticsHealthState	ユーザーエクスペリエンス分析 'BestPractices' カテゴリの現在の正常性状態。使用可能な値は、`unknown`、`insufficientData`、`needsAttention`、`meetingGoals` です。
resourcePerformanceHealthState	userExperienceAnalyticsHealthState	ユーザーエクスペリエンス分析 'ResourcePerformance' カテゴリの現在の正常性状態。使用可能な値は、`unknown`、`insufficientData`、`needsAttention`、`meetingGoals` です。
batteryHealthState	userExperienceAnalyticsHealthState	ユーザーエクスペリエンス分析 'BatteryHealth' カテゴリの現在の正常性状態。可能な値は、`unknown`、`insufficientData`、`needsAttention`、`meetingGoals` です。

応答

成功した場合、このメソッドは応答 200 OK コードと、応答本文で更新された userExperienceAnalyticsOverview オブジェクトを返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsOverview
Content-type: application/json
Content-length: 1085

{
  "@odata.type": "#microsoft.graph.userExperienceAnalyticsOverview",
  "overallScore": 12,
  "deviceBootPerformanceOverallScore": 1,
  "bestPracticesOverallScore": 9,
  "workFromAnywhereOverallScore": 12,
  "appHealthOverallScore": 5,
  "resourcePerformanceOverallScore": 15,
  "batteryHealthOverallScore": 9,
  "insights": [
    {
      "@odata.type": "microsoft.graph.userExperienceAnalyticsInsight",
      "userExperienceAnalyticsMetricId": "User Experience Analytics Metric Id value",
      "insightId": "Insight Id value",
      "values": [
        {
          "@odata.type": "microsoft.graph.insightValueDouble",
          "value": 1.6666666666666667
        }
      ],
      "severity": "informational"
    }
  ],
  "state": "insufficientData",
  "deviceBootPerformanceHealthState": "insufficientData",
  "bestPracticesHealthState": "insufficientData",
  "workFromAnywhereHealthState": "insufficientData",
  "appHealthState": "insufficientData",
  "resourcePerformanceHealthState": "insufficientData",
  "batteryHealthState": "insufficientData"
}

応答

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1134

{
  "@odata.type": "#microsoft.graph.userExperienceAnalyticsOverview",
  "id": "8228da2b-da2b-8228-2bda-28822bda2882",
  "overallScore": 12,
  "deviceBootPerformanceOverallScore": 1,
  "bestPracticesOverallScore": 9,
  "workFromAnywhereOverallScore": 12,
  "appHealthOverallScore": 5,
  "resourcePerformanceOverallScore": 15,
  "batteryHealthOverallScore": 9,
  "insights": [
    {
      "@odata.type": "microsoft.graph.userExperienceAnalyticsInsight",
      "userExperienceAnalyticsMetricId": "User Experience Analytics Metric Id value",
      "insightId": "Insight Id value",
      "values": [
        {
          "@odata.type": "microsoft.graph.insightValueDouble",
          "value": 1.6666666666666667
        }
      ],
      "severity": "informational"
    }
  ],
  "state": "insufficientData",
  "deviceBootPerformanceHealthState": "insufficientData",
  "bestPracticesHealthState": "insufficientData",
  "workFromAnywhereHealthState": "insufficientData",
  "appHealthState": "insufficientData",
  "resourcePerformanceHealthState": "insufficientData",
  "batteryHealthState": "insufficientData"
}

userExperienceAnalyticsOverview の更新

前提条件

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック