Baixar o arquivo CAB de um erro em seu aplicativo da área de trabalhoDownload the CAB file for an error in your desktop application

Use este método na da API de análise da Microsoft Store para baixar o arquivo CAB associado a um determinado erro para um aplicativo da área de trabalho que você adicionou ao programa do aplicativo de área de trabalho do 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. Este método pode apenas baixar o arquivo CAB de um erro de app que ocorreu nos últimos 30 dias.This method can only download the CAB file for an app error that occurred in the last 30 days. Downloads de arquivo CAB também estão disponíveis no relatório de integridade para aplicativos de área de trabalho no Partner Center.CAB file downloads are also available in the Health report for desktop applications in Partner Center.

Antes de usar esse método, primeiro você deverá usar o método obter detalhes de um erro em seu aplicativo da área de trabalho para recuperar o hash de ID do arquivo CAB que deseja baixar.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.

Pré-requisitosPrerequisites

Para usar este método, primeiro você precisa do seguinte:To use this method, you need to first do the following:

  • Se você não tiver feito isso, conclua todos os pré-requisitos para a API de análise da Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para este método.Obtain an Azure AD access token to use in the request header for this method. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar.After you obtain an access token, you have 60 minutes to use it before it expires. Depois que o token expirar, você poderá obter um novo.After the token expires, you can obtain a new one.
  • Obtenha o hash da ID do arquivo CAB que você deseja baixar.Get the ID hash of the CAB file you want to download. Para obter esse valor, use o método obter detalhes de um erro em seu aplicativo da área de trabalho para recuperar os detalhes de um erro específico em seu app, e use o valor de cabIdHash no corpo da resposta desse método.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.

SolicitaçãoRequest

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload

Cabeçalho da solicitaçãoRequest header

CabeçalhoHeader TipoType DescriçãoDescription
AutorizaçãoAuthorization stringstring Obrigatórios.Required. O token de acesso do Azure AD no formulário Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parâmetros da solicitaçãoRequest parameters

ParâmetroParameter TipoType DescriçãoDescription ObrigatórioRequired
applicationIdapplicationId stringstring A ID do produto do aplicativo da área de trabalho para o qual você deseja baixar um arquivo CAB.The product ID of the desktop application for which you want to download a CAB file. Para obter a ID do produto de um aplicativo de área de trabalho, abra qualquer relatório de análise do Partner Center para seu aplicativo de desktop (como o relatório de integridade) e recupere a ID do produto da 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. SimYes
cabIdHashcabIdHash stringstring O hash da ID exclusiva do arquivo CAB que você deseja baixar.The unique ID hash of the CAB file you want to download. Para obter esse valor, use o método obter detalhes de um erro em seu aplicativo da área de trabalho para recuperar os detalhes de um erro específico em seu aplicativo, e use o valor de cabIdHash no corpo da resposta desse método.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. SimYes

Exemplo de solicitaçãoRequest example

O exemplo a seguir demonstra como obter baixar um arquivo CAB usando esse método.The following example demonstrates how to download a CAB file using this method. Substitua os parâmetros applicationId e cabIdHash pelos valores apropriados para seu aplicativo da área de trabalho.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>

RespostaResponse

Esse método retorna um código de resposta 302 (redirecionamento) e o cabeçalho Local na resposta é atribuído à URI de assinatura do acesso compartilhado (SAS) do arquivo 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. O chamador é redirecionado para essa URI a fim de baixar automaticamente o arquivo CAB.The caller is redirected to this URI to automatically download the CAB file.