Microsoft Store 分析 API の次のメソッドを使用して、 Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションの特定のエラーに関連付けられている CAB ファイルをダウンロードします。 このメソッドは、過去 30 日間に発生したアプリ エラーの CAB ファイルのみをダウンロードできます。 CAB ファイルのダウンロードは、パートナー センターのデスクトップ アプリケーションの 正常性レポート でも入手できます。
このメソッドを使用する前に、 まずデスクトップ アプリケーション メソッドでエラーの詳細を取得 して、ダウンロードする CAB ファイルの ID ハッシュを取得する必要があります。
[前提条件]
このメソッドを使用するには、まず次の操作を行う必要があります。
- まだ行っていない場合は、Microsoft Store 分析 API の
前提条件をすべて満たしてください。 - このメソッドの要求ヘッダーで使用する Azure AD アクセス トークン を取得します。 アクセス トークンを取得すると、有効期限が切れるまで 60 分かかります。 トークンの有効期限が切れた後、新しいトークンを取得できます。
- ダウンロードする CAB ファイルの ID ハッシュを取得します。 この値を取得するには、デスクトップ アプリケーション メソッドでエラーの詳細を取得し、アプリ内の特定のエラーの詳細を取得し、そのメソッドの応答本文で cabIdHash 値を使用します。
リクエスト
リクエスト構文
メソッド | URI リクエスト |
---|---|
取得する | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload |
リクエストヘッダー
ヘッダ | タイプ | 説明 |
---|---|---|
認証 | ひも | 必須。 Bearer<token> 形式の Azure AD アクセス トークン。 |
要求パラメーター
パラメーター | タイプ | 説明 | 必須 |
---|---|---|---|
アプリケーションID | ひも | CAB ファイルをダウンロードするデスクトップ アプリケーションの製品 ID。 デスクトップ アプリケーションの製品 ID を取得するには、デスクトップ アプリケーションの パートナー センター分析レポート ( 正常性レポートなど) を開き、URL から製品 ID を取得します。 | イエス |
cabIdHash (英語) | ひも | ダウンロードする CAB ファイルの一意の ID ハッシュ。 この値を取得するには、デスクトップ アプリケーション メソッドでエラーの詳細を取得し、アプリケーション内の特定のエラーの詳細を取得し、そのメソッドの応答本文で cabIdHash 値を使用します。 | イエス |
要求の例
次の例では、この方法を使用して CAB ファイルをダウンロードする方法を示します。 applicationId パラメーターと cabIdHash パラメーターを、デスクトップ アプリケーションに適した値に置き換えます。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload?applicationId=10238467886765136388&cabIdHash=00001111-aaaa-2222-bbbb-3333cccc4444 HTTP/1.1
Authorization: Bearer <your access token>
[応答]
このメソッドは 302 (リダイレクト) 応答コードを返し、応答の Location ヘッダーが CAB ファイルの Shared Access Signature (SAS) URI に割り当てられます。 呼び出し元はこの URI にリダイレクトされ、CAB ファイルが自動的にダウンロードされます。
関連トピック
- 健康報告書
- Microsoft Store サービス を使用して分析データにアクセスする
- デスクトップ アプリケーション のエラー報告データを取得する
- デスクトップ アプリケーションの でエラーの詳細を取得する
- デスクトップ アプリケーションでエラーのスタック トレースを取得