デスクトップ アプリケーションのエラーに関する詳細情報の取得

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

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

前提条件

このメソッドを使うには、最初に次の作業を行う必要があります。

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

要求

要求の構文

要求ヘッダー

要求パラメーター

要求の例

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&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=012e33e3-dbc9-b12f-c124-9d9810f05d8b&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 ファイルをダウンロードする