Freigeben über


Abrufen von Details zu einem Fehler in Ihrer App

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 Abschnitt "Fehler " des Integritätsberichts 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 tun:

  • Falls noch nicht geschehen, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu 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.

Anfordern

Anforderungssyntax

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Parameter Typ Beschreibung Erforderlich
applicationId Zeichenfolge Die Store-ID der App, für die Sie detaillierte Fehlerdaten abrufen möchten. Die Store-ID ist auf der Seite "App-Identität" im Partner Center verfügbar. Ein Beispiel für die Store-ID ist 9WZDNCRFJ3Q8. Ja
failureHash Zeichenfolge 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
startDate date Das Startdatum im Datumsbereich der detaillierten Fehlerdaten, die abgerufen werden sollen. Der Standardwert ist 30 Tage vor dem aktuellen Datum.

Hinweis: Diese Methode kann nur Details zu Fehlern abrufen, die in den letzten 30 Tagen aufgetreten sind.
No
endDate date Das Enddatum im Datumsbereich der detaillierten Fehlerdaten, die abgerufen werden sollen. Die Standardeinstellung ist das aktuelle Datum. Nein
Oben int Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Höchstwert und der Standardwert, falls nicht angegeben, 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
skip int Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datasets zu durchlaufen. 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. No
filter Zeichenfolge Eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält einen Feldnamen aus dem Antwortkörper und einen Wert, die mit den Operatoren eq oder ne verbunden sind, und Anweisungen können mit and oder or kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filter-Parameter umgeben sein. Sie können die folgenden Felder aus dem Antworttext angeben:

  • market
  • date
  • cabId
  • cabExpirationTime
  • deviceType
  • deviceModel
  • osVersion
  • osRelease
  • packageVersion
  • osBuild
No
orderby Zeichenfolge Eine Anweisung, die die Ergebnisdatenwerte anordnet. Die Syntax ist orderby=Feld [order], Feld [order],.... Der Feld-Parameter kann eine der folgenden Zeichenfolgen sein:
  • market
  • date
  • cabId
  • cabExpirationTime
  • deviceType
  • deviceModel
  • osVersion
  • osRelease
  • packageVersion
  • osBuild

Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Die Standardeinstellung ist asc.

Hier ist ein Beispiel für eine orderby-Zeichenfolge: orderby=date,market

No

Anforderungsbeispiel

Die folgenden Beispiele veranschaulichen mehrere Anforderungen für das Abrufen detaillierter Fehlerdaten. Ersetzen Sie den applicationId-Wert durch die Store-ID für Ihre App.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&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/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'Windows.Desktop' HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antworttext

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 Zeichenfolge 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.
TotalCount integer Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage.

Fehlerdetailseitewerte

Elemente im Value-Array enthalten die folgenden Werte.

Wert Typ Beschreibung
applicationId Zeichenfolge Die Store-ID der App, für die Sie detaillierte Fehlerdaten abgerufen haben.
failureHash Zeichenfolge Der eindeutige Bezeichner für den Fehler.
failureName Zeichenfolge 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.
date Zeichenfolge 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.
cabId Zeichenfolge Die eindeutige ID der CAB-Datei, die diesem Fehler zugeordnet ist.
cabExpirationTime Zeichenfolge Das Datum und die Uhrzeit, zu dem die CAB-Datei abgelaufen ist und nicht mehr im ISO 8601-Format heruntergeladen werden kann.
Markt Zeichenfolge Der ISO 3166-Ländercode des Gerätemarktes.
osBuild Zeichenfolge Die Buildnummer des Betriebssystems, auf dem der Fehler aufgetreten ist.
packageVersion Zeichenfolge Die Version des App-Pakets, das diesem Fehler zugeordnet ist.
deviceModel Zeichenfolge Eine Zeichenfolge, die das Modell des Geräts angibt, auf dem die App ausgeführt wurde, als der Fehler aufgetreten ist.
osVersion Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, für die der Fehler aufgetreten ist:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8,1
  • Windows 10
  • Windows 11
  • Unbekannt
osRelease Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion oder den Flighting-Ring (als Unterpopulation innerhalb der Betriebssystemversion) angibt, für die 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
  • Vorschauversion
  • Insider Fast
  • Insider Slow

Für Windows Server 1709:

  • RTM

Für Windows Server 2016:

  • Version 1607

Für Windows 8,1:

  • Update 1

Für Windows 7:

  • Service Pack 1

Wenn die Betriebssystemversion oder der Flighting-Ring unbekannt ist, weist dieses Feld den Wert Unbekannt auf.

deviceType Zeichenfolge Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem die App ausgeführt wurde, wenn der Fehler aufgetreten ist:
  • PC
  • Telefonnummer
  • Konsolen-Xbox One
  • Konsolen-Xbox Series X
  • IoT
  • Holographisch
  • Unbekannt
cabDownloadable Boolean Gibt an, ob die CAB-Datei für diesen Benutzer heruntergeladen werden kann.

Hinweis

Diese Methode kann nur Details zu Fehlern abrufen, die in den letzten 30 Tagen aufgetreten sind.

Beispiel für Anforderung und Antwort

Die folgenden Codeausschnitte zeigen beispielweise Anforderungs- und JSON-Antworttext für diese Anforderung.

Beispiel-Anfrage

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012345-5dbc9-b12f-c124-9d9810f05d8b&startDate=2022-06-30&endDate=2022-07-28&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Beispiel für eine Antwort

{
    "Value": [
        {
            "date": "2022-07-12 00:00:00",
            "cabExpirationTime": "2022-08-16 01:37:00",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1180087848576586304",
            "market": "MX",
            "osBuild": "10.0.19043",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Dell Inc.-Inspiron 15-3567",
            "osVersion": "Windows 10",
            "osRelease": "Version 21H1",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i5",
            "cpuName": "Intel Core i5-7200U CPU @ 2.50GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-13 00:00:00",
            "cabExpirationTime": "2022-08-17 13:35:53",
            "cabDownloadable": true,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "2058585545558157474",
            "market": "RO",
            "osBuild": "10.0.22622",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Dell Inc.-Vostro 5502",
            "osVersion": "Windows 11",
            "osRelease": "External",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i5",
            "cpuName": "11th Gen Intel Core i5-1135G7 @ 2.40GHz",
            "praid": "app",
            "flightRing": "external",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-14 00:00:00",
            "cabExpirationTime": "2022-08-18 07:27:06",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1940204079766793391",
            "market": "IN",
            "osBuild": "10.0.19044",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Generic Desktop",
            "osVersion": "Windows 10",
            "osRelease": "Version 21H2",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Pentium",
            "cpuName": "Intel Pentium CPU G630 @ 2.70GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-17 00:00:00",
            "cabExpirationTime": "2022-08-21 10:04:16",
            "cabDownloadable": true,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1197051093472061859",
            "market": "ES",
            "osBuild": "10.0.22621",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Microsoft Corporation-Surface Pro 3",
            "osVersion": "Windows 11",
            "osRelease": "External",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i7",
            "cpuName": "Intel Core i7-4650U CPU @ 1.70GHz",
            "praid": "app",
            "flightRing": "external",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-20 00:00:00",
            "cabExpirationTime": "2022-08-24 12:40:05",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1332886311327579782",
            "market": "RU",
            "osBuild": "6.3.9600",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "ASUSTeK COMPUTER INC.-K75VJ",
            "osVersion": "Windows 8.1",
            "osRelease": "RTM",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i7",
            "cpuName": "Intel Core i7-3630QM CPU @ 2.40GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": ""
        }
    ],
    "TotalCount": 5
}