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

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. Este método pode apenas baixar o arquivo CAB de um erro de app que ocorreu nos últimos 30 dias. Os downloads de arquivos CAB também estão disponíveis no relatório Integridade para aplicativos da área de trabalho no 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.

Pré-requisitos

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

  • Se você não tiver feito isso, conclua todos os pré-requisitos para a 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 este 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 da ID do arquivo CAB que você deseja baixar. 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.

Solicitação

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

parâmetro Tipo Descrição
Autorização string Obrigatórios. O token de acesso Azure AD notoken> de portador< de 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 da ID exclusiva do arquivo CAB que você deseja baixar. 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. Sim

Exemplo de solicitação

O exemplo a seguir demonstra como obter 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 Local na resposta é atribuído à URI de assinatura do acesso compartilhado (SAS) do arquivo CAB. O chamador é redirecionado para essa URI a fim de baixar automaticamente o arquivo CAB.