デスクトップ アプリケーションのエラーの CAB ファイルをダウンロードするDownload the CAB file for an error in your desktop application

Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションの特定のエラーに関連する CAB ファイルをダウンロードするには、Microsoft Store 分析 API の以下のメソッドを使います。Use this method in the Microsoft Store analytics API to download the CAB file that is associated with a particular error for a desktop application that you have added to the Windows Desktop Application program. このメソッドでダウンロードできるのは、過去 30 日以内に発生したアプリのエラーに関する CAB ファイルのみです。This method can only download the CAB file for an app error that occurred in the last 30 days. CAB ファイルのダウンロードは、パートナーセンターのデスクトップアプリケーションの 状態レポート でも利用できます。CAB file downloads are also available in the Health report for desktop applications in Partner Center.

このメソッドを使用するには、事前に「デスクトップ アプリケーションのエラーに関する詳細情報の取得」のメソッドを使って、ダウンロードする CAB ファイルの ID ハッシュを取得しておく必要があります。Before you can use this method, you must first use the get details for an error in your desktop application method to retrieve the ID hash of the CAB file you want to download.

前提条件Prerequisites

このメソッドを使うには、最初に次の作業を行う必要があります。To use this method, you need to first do the following:

  • Microsoft Store 分析 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。Obtain an Azure AD access token to use in the request header for this method. アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。After you obtain an access token, you have 60 minutes to use it before it expires. トークンの有効期限が切れたら新しいトークンを取得できます。After the token expires, you can obtain a new one.
  • ダウンロードする CAB ファイルの ID ハッシュを取得します。Get the ID hash of the CAB file you want to download. この値を取得するには、「デスクトップ アプリケーションのエラーに関する詳細情報の取得」のメソッドを使ってアプリの特定のエラーに関する詳細情報を取得し、そのメソッドの応答本文に含まれる cabIdHash 値を使用します。To get this value, use the get details for an error in your desktop application method to retrieve details for a specific error in your app, and use the cabIdHash value in the response body of that method.

RequestRequest

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload

要求ヘッダーRequest header

HeaderHeader TypeType 説明Description
承認Authorization stringstring 必須。Required. Bearer <トークン> という形式の Azure AD アクセス トークン。The Azure AD access token in the form Bearer <token>.

要求パラメーターRequest parameters

パラメーターParameter TypeType 説明Description 必須Required
applicationIdapplicationId stringstring CAB ファイルをダウンロードするデスクトップ アプリケーションの製品 ID です。The product ID of the desktop application for which you want to download a CAB file. デスクトップアプリケーションの製品 ID を取得するには、デスクトップアプリケーション (状態レポートなど)のパートナーセンター分析レポートを開き、URL から製品 id を取得します。To get the product ID of a desktop application, open any Partner Center analytics report for your desktop application (such as the Health report) and retrieve the product ID from the URL. はいYes
cabIdHashcabIdHash stringstring ダウンロードする CAB ファイルの一意の ID ハッシュです。The unique ID hash of the CAB file you want to download. この値を取得するには、「デスクトップ アプリケーションのエラーに関する詳細情報の取得」のメソッドを使ってアプリケーションの特定のエラーに関する詳細情報を取得し、そのメソッドの応答本文に含まれる cabIdHash 値を使用します。To get this value, use the get details for an error in your desktop application method to retrieve details for a specific error in your application, and use the cabIdHash value in the response body of that method. はいYes

要求の例Request example

次の例は、このメソッドを使って CAB ファイルをダウンロードする方法を示しています。The following example demonstrates how to download a CAB file using this method. applicationId パラメーターと cabIdHash パラメーターは、デスクトップ アプリケーションに合わせて適切な値に置き換えてください。Replace the applicationId and cabIdHash parameters with the appropriate values for your desktop application.

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 に割り当てられます。This method returns a 302 (redirect) response code, and the Location header in the response is assigned to the shared access signature (SAS) URI of the CAB file. 呼び出し元はこの URI にリダイレクトされ、CAB ファイルが自動的にダウンロードされます。The caller is redirected to this URI to automatically download the CAB file.