デスクトップ アプリケーションのエラーの CAB ファイルをダウンロードする
Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションの特定のエラーに関連する CAB ファイルをダウンロードするには、Microsoft Store 分析 API の以下のメソッドを使います。 このメソッドでダウンロードできるのは、過去 30 日以内に発生したアプリのエラーに関する CAB ファイルのみです。 CAB ファイルのダウンロードは、パートナー センターにあるデスクトップ アプリケーションの状態レポートからも行うことができます。
このメソッドを使用するには、事前に「デスクトップ アプリケーションのエラーに関する詳細情報の取得」のメソッドを使って、ダウンロードする CAB ファイルの ID ハッシュを取得しておく必要があります。
前提条件
このメソッドを使うには、最初に次の作業を行う必要があります。
- Microsoft Store 分析 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。
- このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れたら新しいトークンを取得できます。
- ダウンロードする CAB ファイルの ID ハッシュを取得します。 この値を取得するには、「デスクトップ アプリケーションのエラーに関する詳細情報の取得」のメソッドを使ってアプリの特定のエラーに関する詳細情報を取得し、そのメソッドの応答本文に含まれる cabIdHash 値を使用します。
要求
要求の構文
| 認証方法 | 要求 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload |
要求ヘッダー
| Header | 型 | 説明 |
|---|---|---|
| 承認 | string | 必須。 Bearer<トークン> という形式の Azure AD アクセス トークン。 |
要求パラメーター
| パラメーター | 型 | 内容 | 必須 |
|---|---|---|---|
| applicationId | string | CAB ファイルをダウンロードするデスクトップ アプリケーションの製品 ID です。 デスクトップ アプリケーションの製品 ID を取得するには、パートナー センターでデスクトップ アプリケーションの分析レポートのいずれか (状態レポートなど) を開き、URL から製品 ID を取得します。 | はい |
| cabIdHash | string | ダウンロードする CAB ファイルの一意の ID ハッシュです。 この値を取得するには、「デスクトップ アプリケーションのエラーに関する詳細情報の取得」のメソッドを使ってアプリケーションの特定のエラーに関する詳細情報を取得し、そのメソッドの応答本文に含まれる cabIdHash 値を使用します。 | はい |
要求の例
次の例は、このメソッドを使って CAB ファイルをダウンロードする方法を示しています。 applicationId パラメーターと cabIdHash パラメーターは、デスクトップ アプリケーションに合わせて適切な値に置き換えてください。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload?applicationId=10238467886765136388&cabIdHash=54ffb83a-e159-41d2-8158-f36f306cc01e HTTP/1.1
Authorization: Bearer <your access token>
Response
このメソッドは 302 (リダイレクト) 応答コードを返します。また、応答に含まれる Location ヘッダーは、CAB ファイルの Shared Access Signature (SAS) URI に割り当てられます。 呼び出し元はこの URI にリダイレクトされ、CAB ファイルが自動的にダウンロードされます。