Télécharger le fichier CAB concernant une erreur dans votre application de bureau

  • Article

Utilisez cette méthode dans l’API d’analyse du Microsoft Store pour télécharger le fichier CAB associé à une erreur particulière pour une application de bureau que vous avez ajoutée au programme Application de bureau Windows. Cette méthode peut uniquement télécharger le fichier CAB pour une erreur d’application qui s’est produite au cours des 30 derniers jours. Les téléchargements de fichiers CAB sont également disponibles dans le rapport d’intégrité des applications de bureau dans l’Espace partenaires.

Avant de pouvoir utiliser cette méthode, vous devez d’abord utiliser les détails d’obtention d’une erreur dans votre méthode d’application de bureau pour récupérer le hachage d’ID du fichier CAB que vous souhaitez télécharger.

Prérequis

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

  • Si ce n’est pas déjà fait, remplissez toutes les conditions préalables relatives à l’API d’analyse de la Boutique Microsoft.
  • Obtenir un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour cette méthode. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.
  • Obtenez le hachage d’ID du fichier CAB que vous souhaitez télécharger. Pour obtenir cette valeur, utilisez les détails d’obtention d’une erreur dans votre méthode d’application de bureau pour récupérer les détails d’une erreur spécifique dans votre application et utilisez la valeur cabIdHash dans le corps de la réponse de cette méthode.

Requête

Syntaxe de la requête

Méthode URI de demande
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>.

Paramètres de la demande

Paramètre Type Description Obligatoire
applicationId string ID de produit de l’application de bureau pour laquelle vous souhaitez télécharger un fichier CAB. Pour obtenir l’ID de produit d’une application de bureau, ouvrez un rapport analytique de l’Espace partenaires pour votre application de bureau (par exemple, le rapport d’intégrité) et récupérez l’ID de produit à partir de l’URL. Oui
cabIdHash string Hachage d’ID unique du fichier CAB que vous souhaitez télécharger. Pour obtenir cette valeur, utilisez les détails d’obtention d’une erreur dans votre méthode d’application de bureau pour récupérer les détails d’une erreur spécifique dans votre application et utilisez la valeur cabIdHash dans le corps de la réponse de cette méthode. Oui

Exemple de requête

L’exemple suivant montre comment télécharger un fichier CAB à l’aide de cette méthode. Remplacez les paramètres applicationId et cabIdHash par les valeurs appropriées pour votre application de bureau.

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

Cette méthode retourne un code de réponse 302 (redirect) et l’en-tête Location de la réponse est affecté à l’URI de signature d’accès partagé (SAP) du fichier CAB. L’appelant est redirigé vers cet URI pour télécharger automatiquement le fichier CAB.