アプリのエラーの CAB ファイルをダウンロードするDownload the CAB file for an error in your app

Microsoft Store analytics API でこのメソッドを使用すると、パートナー センターが報告されているアプリの特定のエラーに関連付けられている CAB ファイルをダウンロードします。Use this method in the Microsoft Store analytics API to download the CAB file that is associated with a particular error in your app that has been reported to Partner Center. このメソッドでダウンロードできるのは、過去 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 Failures section of the Health report in Partner Center.

このメソッドを使うには、事前に 「アプリのエラーに関する詳細情報の取得」のメソッドを使用し、ダウンロードする CAB ファイルの ID を取得しておく必要があります。Before you can use this method, you must first use the get details for an error in your app method to retrieve the ID 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 of the CAB file you want to download. この ID を取得するには、「アプリのエラーに関する詳細情報の取得」のメソッドを使って、アプリの特定のエラーに関する詳細情報を取得し、そのメソッドの応答本文で cabId 値を使います。To get this ID, use the get details for an error in your app method to retrieve details for a specific error in your app, and use the cabId value in the response body of that method.

要求Request

要求の構文Request syntax

メソッドMethod 要求 URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/cabdownload

要求ヘッダーRequest header

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

要求パラメーターRequest parameters

パラメーターParameter 種類Type 説明Description 必須Required
applicationIdapplicationId stringstring CAB ファイルをダウンロードするアプリのストア ID です。The Store ID of the app for which you want to download a CAB file. Store ID は、アプリ id のページパートナー センターの。The Store ID is available on the App identity page of Partner Center. ストア ID は、たとえば 9WZDNCRFJ3Q8 のような文字列です。An example Store ID is 9WZDNCRFJ3Q8. Yes
cabIdcabId stringstring ダウンロードする CAB ファイルの一意の ID です。The unique ID of the CAB file you want to download. この ID を取得するには、「アプリのエラーに関する詳細情報の取得」のメソッドを使って、アプリの特定のエラーに関する詳細情報を取得し、そのメソッドの応答本文で cabId 値を使います。To get this ID, use the get details for an error in your app method to retrieve details for a specific error in your app, and use the cabId 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 および cabId パラメーターを、アプリの適切な値に置き換えてください。Replace the applicationId and cabId parameters with the appropriate values for your app.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/cabdownload?applicationId=9NBLGGGZ5QDR&cabId=1336373323853 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.