Scaricare il file CAB per un errore nell'applicazione desktop

Usare questo metodo nell'API di analisi di Microsoft Store per scaricare il file CAB associato a un determinato errore per un'applicazione desktop che si è aggiunta al programma per applicazioni desktop di Windows. Questo metodo consente solo di scaricare il file CAB per un errore dell'app che si è verificato negli ultimi 30 giorni. È anche possibile scaricare i file CAB nel report sull'integrità per le applicazioni desktop nel Centro per i partner.

Per poter usare questo metodo, è innanzitutto necessario usare il metodo di recupero dei dettagli per un errore nell'applicazione desktop per recuperare l'hash ID del file CAB che si desidera scaricare.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

  • Se non lo si è ancora fatto, completare i prerequisiti per l'API di analisi di Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
  • Ottenere l'hash ID del file CAB che si desidera scaricare. Per ottenere questo valore, usare il metodo di recupero dei dettagli su un errore nell'applicazione desktop per recuperare i dettagli su un errore specifico nell'app e usare il valore cabIdHash nel corpo della risposta di tale metodo.

Richiedi

Sintassi della richiesta

metodo URI della richiesta
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Parametro Tipo Descrizione Richiesto
applicationId string ID prodotto dell'applicazione desktop per cui si desidera scaricare un file CAB. Per ottenere l'ID prodotto di un'applicazione desktop, aprire qualsiasi report di analisi del Centro per i partner per l'applicazione desktop (ad esempio il report sull'integrità) e recuperare l'ID prodotto dall'URL.
cabIdHash string Hash ID univoco del file CAB che si desidera scaricare. Per ottenere questo valore, usare il metodo di recupero dei dettagli su un errore nell'applicazione desktop per recuperare i dettagli su un errore specifico nell'applicazione e usare il valore cabIdHash nel corpo della risposta di tale metodo.

Esempio di richiesta

L'esempio seguente illustra come scaricare un file CAB usando questo metodo. Sostituire i parametri applicationId e cabIdHash con valori appropriati per l'applicazione desktop.

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

Questo metodo restituisce un codice di risposta 302 (reindirizzamento) e l'intestazione Location nella risposta viene assegnata all'URI della firma di accesso condiviso (SAS) del file CAB. Il chiamante viene reindirizzato a questo URI per scaricare automaticamente il file CAB.