Baixar o arquivo CAB de um erro no aplicativo da área de trabalho
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=00001111-aaaa-2222-bbbb-3333cccc4444 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.