Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um aggregierte Fehlerberichtsdaten für eine Desktopanwendung abzurufen, die Sie dem Windows-Desktopanwendungsprogramm hinzugefügt haben. Diese Methode kann nur Fehler abrufen, die in den letzten 30 Tagen aufgetreten sind. Diese Informationen sind auch im Gesundheitsbericht für Desktopanwendungen im Partner Center verfügbar.
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.
Anfrage
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| ERHALTEN/Bekommen | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits |
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 Fehlerberichtsdaten 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 |
| Startdatum | Datum | Das Startdatum im Datumsbereich der Fehlerberichtsdaten, die abgerufen werden sollen, im Format mm/dd/yyyy. Der Standardwert ist das aktuelle Datum.
Anmerkung: Diese Methode kann nur Fehler abrufen, die in den letzten 30 Tagen aufgetreten sind. |
Nein |
| Enddatum | Datum | Das Enddatum im Datumsbereich der abzurufenden Fehlerberichtsdaten im Format mm/dd/yyyy. 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=10000 und skip=0 die ersten 10000 Datenzeilen ab, top=100000 und skip=10000 ruft die nächsten 10000 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:
|
Nein |
| Aggregationsniveau | Schnur | Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Dies kann eine der folgenden Zeichenfolgen sein: Tag, Wocheoder Monat. Wenn nicht angegeben, ist der Standardwert Tag. Wenn Sie Woche oder Monat angeben, sind die Fehlername - und failureHash-Werte auf 1000 Buckets beschränkt. | 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:
Hier ist ein Beispiel für eine Orderby-Zeichenfolge : orderby=date,market |
Nein |
| GruppierenNach | Schnur | Eine Aussage, die die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder angeben:
Die zurückgegebenen Datenzeilen enthalten die im groupby Parameter angegebenen Felder sowie folgendes:
Der parameter groupby kann mit dem aggregationLevel-Parameter verwendet werden. Beispiel: &groupby=failureName,market&aggregationLevel=week |
Nein |
Beispielanfrage
Die folgenden Beispiele veranschaulichen mehrere Anforderungen für das Abrufen von Fehlerberichtsdaten. Ersetzen Sie den Wert applicationId mit der Produkt-ID für Ihre Desktopanwendung.
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>
Antwort
Antwortkörper
| Wert | Typ | BESCHREIBUNG |
|---|---|---|
| Wert | Array | Ein Array von Objekten, die aggregierte Fehlerberichtsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt "Fehlerwerte ". |
| @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. Beispielsweise wird dieser Wert zurückgegeben, wenn der oberste Parameter der Anforderung auf 10000 festgelegt ist, aber für die Abfrage mehr als 10000 Zeilen mit Fehlern vorhanden sind. |
| Gesamtzahl | Integer | Die Gesamtanzahl der Zeilen des Abfrageergebnisses. |
Fehlerwerte
Elemente im Value-Array enthalten die folgenden Werte.
| Wert | Typ | BESCHREIBUNG |
|---|---|---|
| Datum | Schnur | Das erste Datum im Datumsbereich für die Fehlerdaten, im Format yyyy-mm-dd. Wenn die Anforderung einen einzelnen Tag angibt, ist dieser Wert dieses Datum. Wenn die Anforderung einen längeren Datumsbereich angibt, ist dieser Wert das erste Datum in diesem Datumsbereich. Für Anforderungen, die einen AggregationLevel-Wert der Stunde angeben, enthält dieser Wert auch einen Zeitwert im Format hh:mm:ss. |
| Anwendungs-ID | Schnur | Die Produkt-ID der Desktopanwendung, für die Sie Fehlerdaten abgerufen haben. |
| Produktname | Schnur | Der Anzeigename der Desktop-Anwendung, wie er aus den Metadaten der zugeordneten ausführbaren Datei(en) abgeleitet wird. |
| appName | Schnur | TBD |
| Dateiname | Schnur | Der Name der ausführbaren Datei für die Desktopanwendung. |
| 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. |
| FehlerHash | Schnur | Der eindeutige Bezeichner für den Fehler. |
| Symbol | Schnur | Das diesem Fehler zugewiesene Symbol. |
| osBuild (Englisch) | Schnur | Die vierteilige Buildnummer des Betriebssystems, auf dem der Fehler aufgetreten ist. |
| osVersion | Schnur | Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, auf der die Desktopanwendung installiert ist:
|
| 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:
Für Windows Server 1709:
Für Windows Server 2016:
Für Windows 8.1:
Für Windows 7:
Wenn die Betriebssystemversion oder der Flighting-Ring unbekannt ist, weist dieses Feld den Wert Unbekannt auf. |
| Ereignistyp | Schnur | Eine der folgenden Zeichenfolgen, die den Typ des Fehlerereignisses angibt:
|
| Markt | Schnur | Der ISO 3166-Ländercode des Gerätemarktes. |
| Gerätetyp | Schnur | Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem der Fehler aufgetreten ist:
|
| Anwendungsversion | Schnur | Die Version der ausführbaren Anwendung, in der der Fehler aufgetreten ist. |
| Ereigniszählung | Zahl | Die Anzahl der Ereignisse, die diesem Fehler für die angegebene Aggregationsebene zugeordnet werden. |
Antwortbeispiel
Im folgenden Beispiel wird ein Beispiel für einen JSON-Antworttext für diese Anforderung veranschaulicht.
{
"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
}