Details zu einem Fehler in Ihrer Desktopanwendung abrufen

2025-06-10

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um detaillierte Daten für einen bestimmten Fehler für Ihre App im JSON-Format abzurufen. Diese Methode kann nur Details zu Fehlern abrufen, die in den letzten 30 Tagen aufgetreten sind. Detaillierte Fehlerdaten sind auch im Integritätsbericht für Desktopanwendungen im Partner Center verfügbar.

Bevor Sie diese Methode verwenden können, müssen Sie zunächst die Methode zum Abrufen von Fehlerberichtsdaten verwenden, um die ID des Fehlers abzurufen, für den Sie detaillierte Informationen erhalten möchten.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes ausführen:

Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API aus.
Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.
Rufen Sie die ID des Fehlers ab, für den Sie detaillierte Informationen erhalten möchten. Verwenden Sie zum Abrufen dieser ID die Methode zum Abrufen von Fehlerberichtsdaten und verwenden Sie den FailureHash-Wert im Antworttext dieser Methode.

Anfrage

Anforderungssyntax

Methode	Anforderungs-URI
ERHALTEN/Bekommen	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails`

Anforderungs-Kopfzeile

Kopfzeile	Typ	BESCHREIBUNG
Autorisierung	Schnur	Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Parameter	Typ	BESCHREIBUNG	Erforderlich
Anwendungs-ID	Schnur	Die Produkt-ID der Desktopanwendung, für die Fehlerdetails abgerufen werden sollen. Um die Produkt-ID einer Desktopanwendung abzurufen, öffnen Sie einen beliebigen Analysebericht für Ihre Desktopanwendung im Partner Center (z. B. den Gesundheitsbericht) und rufen Sie die Produkt-ID aus der URL ab.	Ja
FehlerHash	Schnur	Die eindeutige ID des Fehlers, für den Sie detaillierte Informationen erhalten möchten. Um diesen Wert für den gewünschten Fehler abzurufen, verwenden Sie die Methode zum Abrufen von Fehlerberichtsdaten und verwenden den FehlerHash-Wert im Antworttext dieser Methode.	Ja
Startdatum	Datum	Das Startdatum im Datumsbereich der detaillierten Fehlerdaten, die abgerufen werden sollen. Der Standardwert ist 30 Tage vor dem aktuellen Datum. Anmerkung: Diese Methode kann nur Details zu Fehlern abrufen, die in den letzten 30 Tagen aufgetreten sind.	Nein
Enddatum	Datum	Das Enddatum des Datumsbereichs für die detaillierten Fehlerdaten, die abgerufen werden sollen. Der Standardwert ist das aktuelle Datum.	Nein
Nach oben	INT	Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximalwert und der Standardwert, wenn nicht angegeben ist, ist 10000. Wenn in der Abfrage weitere Zeilen vorhanden sind, enthält der Antworttext einen nächsten Link, den Sie verwenden können, um die nächste Seite mit Daten anzufordern.	Nein
hüpfen	INT	Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze zu durchblättern. Beispielsweise ruft "top=10" und "skip=0" die ersten 10 Datenzeilen ab, "top=10" und "skip=10" ruft die nächsten 10 Datenzeilen usw. ab.	Nein
Filter	Schnur	Eine oder mehrere Aussagen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält einen Feldnamen aus dem Antworttext und Wert, die dem Eq - oder ne-Operator zugeordnet sind, und Anweisungen können mit undoder oder kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filterparameter umgeben sein. Sie können die folgenden Felder aus dem Antworttext angeben: Markt Datum cabIdHash cabAblaufzeit Gerätetyp deviceModell Betriebssystemversion osVeröffentlichung AnwendungsVersion osBuild (Englisch) Dateiname	Nein
Sortierung nach	Schnur	Eine Anweisung, die die Ergebnisdatenwerte anordnet. Die Syntax lautet orderby=field [order],field [order],.... Der field-Parameter kann eine der folgenden Zeichenfolgen sein: Markt Datum cabIdHash cabAblaufzeit Gerätetyp deviceModell Betriebssystemversion osVeröffentlichung AnwendungsVersion osBuild (Englisch) Dateiname Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Der Standardwert ist asc. Hier ist ein Beispiel für eine Orderby-Zeichenfolge : orderby=date,market	Nein

Beispielanfrage

Die folgenden Beispiele veranschaulichen mehrere Anforderungen für das Abrufen detaillierter Fehlerdaten. Ersetzen Sie den Wert applicationId mit der Produkt-ID für Ihre Desktopanwendung.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antwortkörper

Wert	Typ	BESCHREIBUNG
Wert	Array	Ein Array von Objekten, die detaillierte Fehlerdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt mit den Fehlerdetailwerten .
@nextLink	Schnur	Wenn zusätzliche Datenseiten vorhanden sind, enthält diese Zeichenfolge einen URI, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. Dieser Wert wird beispielsweise zurückgegeben, wenn der oberste Parameter der Anforderung auf 10 festgelegt ist, für die Abfrage jedoch mehr als 10 Fehlerzeilen vorhanden sind.
Gesamtzahl	Integer	Die Gesamtanzahl der Zeilen des Abfrageergebnisses.

Fehlerdetailwerte

Elemente im Value-Array enthalten die folgenden Werte.

Wert	Typ	BESCHREIBUNG
Anwendungs-ID	Schnur	Die Produkt-ID der Desktopanwendung, für die Sie Fehlerdetails abgerufen haben.
FehlerHash	Schnur	Der eindeutige Bezeichner für den Fehler.
Fehlername	Schnur	Der Name des Fehlers, der aus vier Teilen besteht: einer oder mehreren Problemklassen, einem Ausnahme-/Fehlerüberprüfungscode, dem Namen des Bilds, in dem der Fehler aufgetreten ist, und dem zugehörigen Funktionsnamen.
Datum	Schnur	Das erste Datum im Datumsbereich für die Fehlerdaten. Wenn die Anforderung einen einzelnen Tag angegeben hat, ist dieser Wert dieses Datum. Wenn die Anforderung eine Woche, einen Monat oder einen anderen Datumsbereich angegeben hat, ist dieser Wert das erste Datum in diesem Datumsbereich.
cabIdHash (Kabinett-Identifikationshash)	Schnur	Der eindeutige ID-Hash der CAB-Datei, die diesem Fehler zugeordnet ist.
Ablaufzeit für CAB-Datei	Schnur	Das Datum und die Uhrzeit, zu dem die CAB-Datei abgelaufen ist und nicht mehr im ISO 8601-Format heruntergeladen werden kann.
Markt	Schnur	Der ISO 3166-Ländercode des Gerätemarktes.
osBuild (Englisch)	Schnur	Die Buildnummer des Betriebssystems, auf dem der Fehler aufgetreten ist.
Anwendungsversion	Schnur	Die Version der ausführbaren Anwendung, in der der Fehler aufgetreten ist.
Gerätemodell	Schnur	Eine Zeichenfolge, die das Modell des Geräts angibt, auf dem die App ausgeführt wurde, als der Fehler aufgetreten ist.
osVersion	Schnur	Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, auf der die Desktopanwendung installiert ist: Windows 7 Windows 8.1 Windows 10 Windows 11 Windows Server 2016 Windows Server 1709 Unbekannt
osVeröffentlichung	Schnur	Eine der folgenden Zeichenfolgen, die den Release- oder Flighting-Ring des Betriebssystems (als Teilmenge innerhalb der Betriebssystemversion) angibt, bei dem der Fehler aufgetreten ist. Für Windows 11: Version 2110 Für Windows 10: Version 1507 Version 1511 Version 1607 Version 1703 Version 1709 Version 1803 Versionsvorschau Insider schnell Insider Langsam Für Windows Server 1709: RTM Für Windows Server 2016: Version 1607 Für Windows 8.1: Aktualisierung 1 Für Windows 7: Servicepaket 1 Wenn die Betriebssystemversion oder der Flighting-Ring unbekannt ist, weist dieses Feld den Wert Unbekannt auf.
Gerätetyp	Schnur	Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem der Fehler aufgetreten ist: PC Server Unbekannt
cabHerunterladbar	Boolescher Typ (Boolean)	Gibt an, ob die CAB-Datei für diesen Benutzer heruntergeladen werden kann.
Dateiname	Schnur	Der Name der ausführbaren Datei für die Desktopanwendung, für die Sie Fehlerdetails abgerufen haben.

Antwortbeispiel

Im folgenden Beispiel wird ein Beispiel für einen JSON-Antworttext für diese Anforderung veranschaulicht.

{
  "Value": [
    {
      "applicationId": "10238467886765136388",
      "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
      "failureName": "NULL_CLASS_PTR_WRITE_c0000005_contoso.exe!unknown_error_in_process",
      "date": "2018-01-28 23:55:29",
      "cabIdHash": "54ffb83a-e159-41d2-8158-f36f306cc01e",
      "cabExpirationTime": "2018-02-27 23:55:29",
      "market": "US",
      "osBuild": "10.0.10240",
      "applicationVersion": "2.2.2.0",
      "deviceModel": "Contoso All-in-one",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "deviceType": "PC",
      "cabDownloadable": false,
      "fileName": "contosodemo.exe"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}