Obtenir les données de signalement d’erreurs pour votre application de bureau

Utilisez cette méthode dans l’API d’analytique du Microsoft Store pour obtenir des données de rapport d’erreurs agrégées pour une application de bureau que vous avez ajoutée au programme d’application de bureau Windows . Cette méthode ne peut récupérer que les erreurs qui se sont produites au cours des 30 derniers jours. Ces informations sont également disponibles dans le rapport de santé pour les applications de bureau dans le Partner Center.

Conditions préalables

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

Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour l’API d’analytique du Microsoft Store.
Obtenez 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.

Requête

Syntaxe de la requête

Méthode	URI de la requête
OBTENIR	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits`

En-tête de requête

En-tête de page	Catégorie	Descriptif
Autorisation	ficelle	Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Paramètre	Catégorie	Descriptif	Obligatoire
applicationId	ficelle	ID de produit de l’application de bureau pour laquelle vous souhaitez récupérer les données de rapport d’erreurs. Pour obtenir l’ID de produit d’une application de bureau, ouvrez n’importe quel rapport d’analyse pour votre application de bureau dans l’Espace partenaires (par exemple, le rapport d’intégrité ) et récupérez l’ID de produit à partir de l’URL.	Oui
date de début	date	Date de début dans la plage de dates des données de rapport d’erreurs à récupérer, au format `mm/dd/yyyy`. La valeur par défaut est la date actuelle. Remarque : Cette méthode ne peut récupérer que les erreurs qui se sont produites au cours des 30 derniers jours.	Non
date de fin	date	Date de fin de la plage de dates des données de rapport d’erreurs à récupérer, au format `mm/dd/yyyy`. La valeur par défaut est la date actuelle.	Non
Haut de page	Int	Nombre de lignes de données à retourner dans la requête. La valeur maximale et la valeur par défaut si elle n’est pas spécifiée est 1 0000. S’il existe plus de lignes dans la requête, le corps de la réponse inclut un lien suivant que vous pouvez utiliser pour demander la page suivante de données.	Non
passer	Int	Nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir des jeux de données volumineux. Par exemple, top=10000 et skip=0 récupère les 1 000 premières lignes de données, top=10000 et skip=10000 récupère les 1 0000 lignes de données suivantes, et ainsi de suite.	Non
Filter	ficelle	Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction contient un nom de champ à partir du corps de la réponse et une valeur associés aux opérateurs eq ou ne, et les instructions peuvent être combinées à l’aide et ou ou. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre . Vous pouvez spécifier les champs suivants à partir du corps de la réponse : nomDuFichier version de l'application nomÉchec échecHash symbole osVersion osBuild osRelease eventType marché type d'appareil NomDuProduit date	Non
niveau d'agrégation	ficelle	Spécifie l’intervalle de temps pour lequel récupérer des données agrégées. Il peut s’agir de l’une des chaînes suivantes : jour, semaine ou mois. Si aucune valeur n’est spécifiée, la valeur par défaut est jour. Si vous spécifiez la semaine ou le mois , les valeurs failureName et failureHash sont limitées à 1 000 compartiments.	Non
classer par	ficelle	Une instruction qui ordonne les valeurs des données de résultat. La syntaxe est orderby=field [order],field [order],.... Le paramètre de champ peut être l’une des chaînes suivantes : nomDuFichier version de l'application nomÉchec échecHash symbole osVersion osBuild osRelease eventType marché type d'appareil NomDuProduit date Le paramètre d’ordre est facultatif et peut être asc ou desc pour spécifier l’ordre croissant ou décroissant pour chaque champ. La valeur par défaut est asc. Voici un exemple de chaîne orderby : orderby=date,market	Non
grouppar	ficelle	Instruction qui applique l’agrégation de données uniquement aux champs spécifiés. Vous pouvez spécifier les champs suivants : nomÉchec échecHash symbole osVersion eventType marché type d'appareil Les lignes de données retournées contiennent les champs spécifiés dans le paramètre groupby , ainsi que les éléments suivants : date applicationId nomapplication nombre d'événements Le paramètre groupby peut être utilisé avec le paramètre aggregationLevel . Par exemple : &groupby=failureName,market&aggregationLevel=week	Non

Exemple de requête

Les exemples suivants illustrent plusieurs demandes d’obtention de données de rapport d’erreurs. Remplacez la valeur applicationId par l’ID de produit de votre application de bureau.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Réponse

Corps de réponse

Valeur	Catégorie	Descriptif
Valeur	tableau	Tableau d’objets qui contiennent des données de rapport d’erreurs agrégées. Pour plus d'informations sur les données de chaque objet, consultez la section ci-dessous relative aux valeurs d'erreur et.
@nextLink	ficelle	S’il existe des pages de données supplémentaires, cette chaîne contient un URI que vous pouvez utiliser pour demander la page suivante des données. Par exemple, cette valeur est retournée si le paramètre premier de la requête est défini sur 1 0000, mais qu’il y a plus de 1 000 lignes d’erreurs pour la requête.
NombreTotal	entier	Nombre total de lignes dans le résultat des données de la requête.

Valeurs d’erreur

Les éléments du tableau Valeur contiennent les valeurs suivantes.

Valeur	Catégorie	Descriptif
date	ficelle	La date de début de la plage de dates pour les données d'erreur, au format `yyyy-mm-dd`. Si la demande spécifie un jour unique, cette valeur est cette date. Si la demande spécifie une plage de dates plus longue, cette valeur est la première date de cette plage de dates. Pour les requêtes qui spécifient une valeur aggregationLevel de hour, cette valeur inclut également une valeur temporelle au format `hh:mm:ss`.
applicationId	ficelle	ID de produit de l’application de bureau pour laquelle vous avez récupéré les données d’erreur.
Nom du produit	ficelle	Nom affiché de l’application de bureau dérivé des métadonnées des exécutables qui lui sont associés.
nomappli	ficelle	À déterminer
Nom de fichier	ficelle	Nom du fichier exécutable de l’application de bureau.
nom de l'échec	ficelle	Nom de l’échec, constitué de quatre parties : une ou plusieurs classes de problème, un code de vérification d’exception/bogue, le nom de l’image où l’échec s’est produit et le nom de la fonction associée.
hashErreur	ficelle	Identificateur unique de l’erreur.
symbole	ficelle	Symbole affecté à cette erreur.
osBuild	ficelle	Numéro de build en quatre parties du système d’exploitation sur lequel l’erreur s’est produite.
osVersion	ficelle	L’une des chaînes suivantes qui spécifie la version du système d’exploitation sur laquelle l’application de bureau est installée : Windows 7 Windows 8.1 Windows 10 Windows 11 Windows Server 2016 Windows Server 1709 Inconnu
osRelease	ficelle	Une des chaînes suivantes qui spécifie la version du système d'exploitation ou l'anneau de vol (en tant que sous-population au sein de la version du système d'exploitation) sur lequel l'erreur s'est produite. Pour Windows 11 : version 2110 Pour Windows 10 : version 1507 version 1511 Version 1607 Version 1703 Version 1709 version 1803 Aperçu de la version Rapide pour les initiés Initié Lent Pour Windows Server 1709 : RTM Pour Windows Server 2016 : Version 1607 Pour Windows 8.1 : Mise à jour 1 Pour Windows 7 : Pack de Service 1 Si la version du système d’exploitation ou l’anneau de distribution est inconnu, ce champ a la valeur Inconnu.
type d'événement	ficelle	Une des chaînes suivantes qui indique le type d’événement d’erreur : de blocage bloquer mémoire JSE
marché	ficelle	Code pays ISO 3166 du marché de l’appareil.
type de dispositif	ficelle	Une des chaînes suivantes qui spécifie le type d’appareil sur lequel l’erreur s’est produite : PC Serveur Tablette Inconnu
version de l'application	ficelle	Version de l’exécutable de l’application dans laquelle l’erreur s’est produite.
nombre d'événements	nombre	Nombre d’événements attribués à cette erreur pour le niveau d’agrégation spécifié.

Exemple de réponse

L’exemple suivant illustre un exemple de corps de réponse JSON pour cette requête.

{
  "Value": [
    {
      "date": "2018-02-01",
      "applicationId": "10238467886765136388",
      "productName": "Contoso Demo",
      "appName": "Contoso Demo",
      "fileName": "contosodemo.exe",
      "failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
      "failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
      "symbol": "hardware_disk!Unknown",
      "osBuild": "10.0.15063.850",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "eventType": "crash",
      "market": "US",
      "deviceType": "PC",
      "applicationVersion": "2.2.2.0",
      "eventCount": 0.0012422360248447205
    }
  ],
  "@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
  "TotalCount": 21
}

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-06-10