デスクトップ アプリケーションでエラーの詳細を取得する

アプリの特定のエラーの詳細なデータを JSON 形式で取得するには、Microsoft Store 分析 API の次のメソッドを使用します。 このメソッドは、過去 30 日間に発生したエラーの詳細のみを取得できます。 詳細なエラー データは、パートナー センターのデスクトップ アプリケーションの 正常性レポート でも使用できます。

このメソッドを使用する前に、最初にエラー報告データを取得 メソッドを使用して、詳細情報を取得するエラーの ID を取得する必要があります。

[前提条件]

このメソッドを使用するには、まず次の操作を行う必要があります。

• まだ行っていない場合は、Microsoft Store 分析 API の 前提条件をすべて満たしてください。
• このメソッドの要求ヘッダーで使用する Azure AD アクセス トークン を取得します。 アクセス トークンを取得すると、有効期限が切れるまで 60 分かかります。 トークンの有効期限が切れた後、新しいトークンを取得できます。
• 詳細情報を取得するエラーの ID を取得します。 この ID を取得するには、 エラー報告データの取得メソッドを 使用し、そのメソッドの応答本文で failureHash 値を使用します。

リクエスト

リクエスト構文

リクエストヘッダー

要求パラメーター

要求の例

次の例では、詳細なエラー データを取得するためのいくつかの要求を示します。 applicationId 値をデスクトップ アプリケーションの製品 ID に置き換えます。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

[応答]

応答内容

エラーの詳細値

Value 配列内の要素には、次の値が含まれています。

応答の例

次の例は、この要求の JSON 応答本文の例を示しています。

{
  "Value": [
    {
      "applicationId": "10238467886765136388",
      "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
      "failureName": "NULL_CLASS_PTR_WRITE_c0000005_contoso.exe!unknown_error_in_process",
      "date": "2018-01-28 23:55:29",
      "cabIdHash": "54ffb83a-e159-41d2-8158-f36f306cc01e",
      "cabExpirationTime": "2018-02-27 23:55:29",
      "market": "US",
      "osBuild": "10.0.10240",
      "applicationVersion": "2.2.2.0",
      "deviceModel": "Contoso All-in-one",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "deviceType": "PC",
      "cabDownloadable": false,
      "fileName": "contosodemo.exe"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}

関連トピック

• 健康報告書
• Microsoft Store サービス を使用して分析データにアクセスする
• デスクトップ アプリケーション のエラー報告データを取得する
• デスクトップ アプリケーションでエラーのスタック トレースを取得
• デスクトップ アプリケーションでエラーが発生した場合に CAB ファイルをダウンロード