Скачивание CAB-файла для ошибки в классическом приложенииDownload the CAB file for an error in your desktop application

Используйте этот метод в API аналитики для Microsoft Store для загрузки CAB-файла, связанного с конкретной ошибкой для классического приложения, которое вы добавили в программу для разработчиков классических приложений для Windows.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. Этот метод позволяет скачать CAB-файл только для ошибок приложения, возникших за последние 30 дней.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-файла.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:

  • Если вы еще не сделали этого, выполните все необходимые условия для API аналитики для Microsoft Store.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-файла, который необходимо скачать.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.

ЗапросRequest

Синтаксис запросаRequest syntax

МетодMethod Универсальный код ресурса (URI) запросаRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload

Заголовок запросаRequest header

ЗаголовокHeader ТипType ОписаниеDescription
АвторизацияAuthorization строкаstring Обязательный.Required. Маркер доступа Azure AD в формате Bearer <token>.The Azure AD access token in the form Bearer <token>.

Параметры запросаRequest parameters

ПараметрParameter ТипType ОписаниеDescription ОбязательноRequired
applicationIdapplicationId строкаstring Код продукта для классического приложения, по которому требуется скачать CAB-файл.The product ID of the desktop application for which you want to download a CAB file. Чтобы получить идентификатор продукта для классического приложения, откройте любой отчет аналитики центра партнеров для своего приложения (например, отчет о работоспособности) и получите идентификатор продукта из URL-адреса.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 строкаstring Уникальный хэш идентификатора CAB-файла, который необходимо скачать.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 в ответе присваивается универсальный код ресурса (URI) для подписанного URL-адреса (SAS) CAB-файла.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.