Compartilhar via

Baixar o arquivo CAB de um erro no aplicativo da área de trabalho

  • Artigo

Use esse método na API de análise da Microsoft Store para baixar o arquivo CAB associado a um erro específico para um aplicativo da área de trabalho que você adicionou ao programa Aplicativo da Área de Trabalho do Windows. Esse método só pode baixar o arquivo CAB para um erro de aplicativo ocorrido nos últimos 30 dias. Os downloads de arquivos CAB também estão disponíveis no relatório de integridade para aplicativos da área de trabalho no Partner Center.

Antes de usar esse método, você deve primeiro usar os detalhes de obtenção de um erro no método de aplicativo da área de trabalho para recuperar o hash de ID do arquivo CAB que deseja baixar.

Pré-requisitos

Para usar este método, primeiro você precisa fazer o seguinte:

  • Se você ainda não fez isso, conclua todos os pré-requisitos da API de análise da Microsoft Store.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para esse método. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.
  • Obtenha o hash de ID do arquivo CAB que você deseja baixar. Para obter esse valor, use o método get details for an error in your desktop application para recuperar detalhes de um erro específico em seu aplicativo e use o valor cabIdHash no corpo da resposta desse método.

Solicitar

Sintaxe da solicitação

Método URI da solicitação
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização string Obrigatório. O token de acesso do Azure AD no Token<de portador> do formulário.

Parâmetros da solicitação

Parâmetro Tipo Descrição Obrigatório
applicationId string A ID do produto do aplicativo da área de trabalho para o qual você deseja baixar um arquivo CAB. Para obter a ID do produto de um aplicativo da área de trabalho, abra qualquer relatório de análise do Partner Center para seu aplicativo da área de trabalho (como o relatório de integridade) e recupere a ID do produto da URL. Sim
cabIdHash string O hash de ID exclusivo do arquivo CAB que você deseja baixar. Para obter esse valor, use o método get details for an error in your desktop application para recuperar detalhes de um erro específico em seu aplicativo e use o valor cabIdHash no corpo da resposta desse método. Sim

Exemplo de solicitação

O exemplo a seguir demonstra como baixar um arquivo CAB usando esse método. Substitua os parâmetros applicationId e cabIdHash pelos valores apropriados para seu aplicativo da área de trabalho.

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>

Resposta

Esse método retorna um código de resposta 302 (redirecionamento) e o cabeçalho Location na resposta é atribuído ao URI de assinatura de acesso compartilhado (SAS) do arquivo CAB. O chamador é redirecionado para esse URI para baixar automaticamente o arquivo CAB.