Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションの集計エラー報告データを取得するには、Microsoft Store 分析 API の次のメソッドを使用します。 このメソッドは、過去 30 日間に発生したエラーのみを取得できます。 この情報は、パートナー センターのデスクトップ アプリケーションの 正常性レポート でも確認できます。
[前提条件]
このメソッドを使用するには、まず次の操作を行う必要があります。
- まだ行っていない場合は、Microsoft Store 分析 API の
前提条件をすべて満たしてください。 - このメソッドの要求ヘッダーで使用する Azure AD アクセス トークン を取得します。 アクセス トークンを取得すると、有効期限が切れるまで 60 分かかります。 トークンの有効期限が切れた後、新しいトークンを取得できます。
リクエスト
リクエスト構文
メソッド | URI リクエスト |
---|---|
取得する | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits |
リクエストヘッダー
ヘッダ | タイプ | 説明 |
---|---|---|
認証 | ひも | 必須。 Bearer<token> 形式の Azure AD アクセス トークン。 |
要求パラメーター
パラメーター | タイプ | 説明 | 必須 |
---|---|---|---|
アプリケーションID | ひも | エラー報告データを取得するデスクトップ アプリケーションの製品 ID。 デスクトップ アプリケーションの製品 ID を取得するには、パートナー センター でデスクトップ アプリケーションの |
イエス |
開始日 | 日付 | 取得するエラー報告データの日付範囲の開始日を、mm/dd/yyyy 形式で指定します。 既定値は現在の日付です。
注: このメソッドは、過去 30 日間に発生したエラーのみを取得できます。 |
いいえ |
終了日 | 日付 | 取得するエラー報告データの日付範囲の終了日を、mm/dd/yyyy 形式で指定します。 既定値は現在の日付です。 |
いいえ |
ページのトップへ | 整数 (int) | 要求で返されるデータの行数。 最大値と既定値 (指定しない場合) は 10000 です。 クエリにさらに行がある場合、応答本文には次のリンクが含まれています。このリンクを使用して、データの次のページを要求できます。 | いいえ |
スキップ | 整数 (int) | クエリでスキップする行数。 大きなデータ セットをページングするには、このパラメーターを使用します。 たとえば、top=10000 と skip=0 はデータの最初の 10000 行を取得し、top=10000 と skip=10000 は次の 10000 行のデータを取得します。 | いいえ |
フィルター | ひも | 応答内の行をフィルター処理する 1 つ以上のステートメント。 各ステートメントには、応答本文のフィールド名と、eq または ne 演算子に関連付けられている値が含まれており、ステートメントは、、、、またはを使用して結合できます。 文字列値は、 フィルター パラメーター内で一重引用符で囲む必要があります。 応答本文から次のフィールドを指定できます。
|
いいえ |
集約レベル | ひも | 集計データを取得する時間範囲を指定します。 次のいずれかの文字列を指定できます: |
いいえ |
オーダーバイ (orderby) | ひも | 結果データ値を並べ替えるステートメント。 構文は orderby=field [order],field [order],...です。 フィールド パラメーターには、次のいずれかの文字列を指定できます。
例として次のような orderby 文字列があります: orderby=date、market |
いいえ |
グループバイ | ひも | 指定したフィールドにのみデータ集計を適用するステートメント。 次のフィールドを指定できます。
返されるデータ行には、 groupby パラメーターで指定されたフィールドと、次のものが含まれます。
groupby パラメーターは aggregationLevel パラメーターと共に使用できます。 例: &groupby=failureName,market&aggregationLevel=week |
いいえ |
要求の例
次の例では、エラー報告データを取得するためのいくつかの要求を示します。 applicationId 値をデスクトップ アプリケーションの製品 ID に置き換えます。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>
[応答]
応答内容
価値 | タイプ | 説明 |
---|---|---|
価値 | 配列 | 集計エラー報告データを含むオブジェクトの配列。 各オブジェクトのデータの詳細については、以下のセクション エラー値 |
@nextLink | ひも | 追加のデータ ページがある場合、この文字列には、データの次のページを要求するために使用できる URI が含まれます。 たとえば、この値は、要求の top パラメーターが 10000 に設定されているが、クエリに 1,0000 行を超えるエラーがある場合に返されます。 |
トータルカウント | 整数 (integer) | クエリのデータ結果内の行の合計数。 |
エラー値
Value 配列内の要素には、次の値が含まれています。
価値 | タイプ | 説明 |
---|---|---|
日付 | ひも | エラー データの日付範囲の最初の日付 (yyyy-mm-dd 形式)。 要求で 1 日が指定されている場合、この値はその日付になります。 要求で長い日付範囲が指定されている場合、この値はその日付範囲の最初の日付になります。
時間の aggregationLevel 値を指定する要求の場合、この値には hh:mm:ss 形式の時刻値も含まれます。 |
アプリケーションID | ひも | エラー データを取得したデスクトップ アプリケーションの製品 ID。 |
製品名 | ひも | 関連付けられている実行可能ファイルのメタデータから派生したデスクトップ アプリケーションの表示名。 |
アプリ名 | ひも | 未定 |
ファイル名 | ひも | デスクトップ アプリケーションの実行可能ファイルの名前。 |
エラー名 | ひも | エラーの名前。1 つ以上の問題クラス、例外/バグ チェック コード、エラーが発生したイメージの名前、および関連する関数名の 4 つの部分で構成されます。 |
failureHash (フェイリャーハッシュ) | ひも | エラーの識別子(ユニーク ID)。 |
記号 | ひも | このエラーに割り当てられたシンボル。 |
osビルド | ひも | エラーが発生した OS の 4 部構成のビルド番号。 |
osVersion (英語) | ひも | デスクトップ アプリケーションをインストールする OS のバージョンを指定する次のいずれかの文字列。
|
osリリース | ひも | エラーが発生した OS リリースまたはフライト リング (OS バージョン内のサブ集団として) を指定する次の文字列のいずれか。 Windows 11 の場合: バージョン 2110 Windows 10 の場合:
Windows Server 1709 の場合:
Windows Server 2016 の場合:
Windows 8.1 の場合:
Windows 7 の場合:
OS リリースまたはフライティング リングが不明な場合、このフィールドの値は [不明] になります。 |
イベントタイプ | ひも | エラー イベントの種類を示す次のいずれかの文字列。
|
市場 | ひも | デバイス市場の ISO 3166 国コード。 |
デバイスタイプ | ひも | エラーが発生したデバイスの種類を指定する次のいずれかの文字列。
|
アプリケーションバージョン | ひも | エラーが発生したアプリケーション実行可能ファイルのバージョン。 |
イベント数 | 数 | 指定された集計レベルでこのエラーに起因するイベントの数。 |
応答の例
次の例は、この要求の JSON 応答本文の例を示しています。
{
"Value": [
{
"date": "2018-02-01",
"applicationId": "10238467886765136388",
"productName": "Contoso Demo",
"appName": "Contoso Demo",
"fileName": "contosodemo.exe",
"failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
"failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
"symbol": "hardware_disk!Unknown",
"osBuild": "10.0.15063.850",
"osVersion": "Windows 10",
"osRelease": "Version 1703",
"eventType": "crash",
"market": "US",
"deviceType": "PC",
"applicationVersion": "2.2.2.0",
"eventCount": 0.0012422360248447205
}
],
"@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
"TotalCount": 21
}
関連トピック
- 健康報告書
- Microsoft Store サービス を使用して分析データにアクセスする
- デスクトップ アプリケーションの でエラーの詳細を取得する
- デスクトップ アプリケーションでエラーのスタック トレースを取得
- デスクトップ アプリケーションでエラーが発生した場合に CAB ファイルをダウンロード