Uzyskaj dane raportowania błędów dla aplikacji desktopowej

Użyj tej metody w interfejsie API analizy sklepu Microsoft Store, aby uzyskać zagregowane dane raportowania błędów dla aplikacji komputerowej, którą dodałeś do programu Windows Desktop Application. Ta metoda może pobierać tylko błędy, które wystąpiły w ciągu ostatnich 30 dni. Te informacje są również dostępne w raporcie zdrowia aplikacji na komputery stacjonarne w Centrum Partnerów.

Wymagania wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

Jeśli jeszcze tego nie zrobiono, wykonaj wszystkie wymagania wstępne dotyczące interfejsu API analizy sklepu Microsoft Store.
Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.

Żądanie

Składnia żądania

Metoda	Żądanie URI
POBIERZ	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits`

Nagłówek żądania

Nagłówek	Typ	Opis
Autoryzacja	sznurek	To jest wymagane. Token dostępu usługi Azure AD w postaci tokenu typu Bearer <>.

Parametry żądania

Parametr	Typ	Opis	Wymagane
applicationId (identyfikator aplikacji)	sznurek	Identyfikator produktu aplikacji na komputery stacjonarne, dla której chcesz pobrać dane raportowania błędów. Aby uzyskać identyfikator produktu aplikacji klasycznej, otwórz dowolny raport analityczny aplikacji klasycznej w Centrum partnerskim (takim jak raport kondycji) i pobierz identyfikator produktu z adresu URL.	Tak
data rozpoczęcia	termin	Data początkowa w zakresie dat wykorzystywanych do pobierania danych raportu błędów w formacie `mm/dd/yyyy`. Wartość domyślna to bieżąca data. Nuta: Ta metoda może pobierać tylko błędy, które wystąpiły w ciągu ostatnich 30 dni.	Nie.
data zakończenia	termin	Data końcowa zakresu dat raportowania błędów do pobrania w formacie `mm/dd/yyyy`. Wartość domyślna to bieżąca data.	Nie.
Do góry	int (integer)	Liczba wierszy danych, które należy zwrócić w żądaniu. Wartość maksymalna i wartość domyślna, jeśli nie zostanie określona, to 10000. Jeśli w zapytaniu znajduje się więcej wierszy, treść odpowiedzi zawiera następny link, którego można użyć do żądania następnej strony danych.	Nie.
pominąć	int (integer)	Liczba wierszy do pominięcia w zapytaniu. Użyj tego parametru, aby przeglądać duże zestawy danych. Na przykład top=10000 i skip=0 pobiera pierwsze 10000 wierszy danych, top=10000 i skip=10000 pobiera następne 10000 wierszy danych itd.	Nie.
filtr	sznurek	Jedno lub więcej wyrażeń, które filtrują wiersze w odpowiedzi. Każda instrukcja zawiera nazwę pola z treści odpowiedzi i wartości, które są skojarzone z operatorami eq lub ne , a instrukcje mogą być łączone przy użyciu i lublub. Wartości ciągu muszą być otoczone pojedynczymi cudzysłowami w parametrze filtru . W treści odpowiedzi można określić następujące pola: nazwa pliku applicationVersion (wersja aplikacji) nazwaAwarii Skrót niepowodzenia symbol wersja systemu operacyjnego osBuild (Kompilacja systemu) osRelease (Wydanie systemu) typ zdarzenia rynek typ urządzenia Nazwa produktu data	Nie.
poziom agregacji	sznurek	Określa zakres czasu, dla którego mają być pobierane agregowane dane. Może być jednym z następujących ciągów: dzień, tydzień lub miesiąc. Jeśli jest to nieokreślone, wartość domyślna to dzień. Jeśli określisz tydzień lub miesiąc, wartości failureName i failureHash są ograniczone do 1000 zasobników.	Nie.
sortowanie według	sznurek	Instrukcja, która porządkuje wartości danych wyników. Składnia to orderby=field [order],field [order],.... Parametr pole może być jednym z następujących ciągów: nazwa pliku applicationVersion (wersja aplikacji) nazwaAwarii Skrót niepowodzenia symbol wersja systemu operacyjnego osBuild (Kompilacja systemu) osRelease (Wydanie systemu) typ zdarzenia rynek typ urządzenia Nazwa produktu data Parametr order jest opcjonalny i może być asc lub desc w celu określenia kolejności rosnącej lub malejącej dla każdego pola. Wartość domyślna to asc. Oto przykładowy ciąg zamówienia : orderby=date,market	Nie.
grupowanie	sznurek	Instrukcja, która stosuje agregację danych tylko do określonych pól. Możesz określić następujące pola: nazwaAwarii Skrót niepowodzenia symbol wersja systemu operacyjnego typ zdarzenia rynek typ urządzenia Zwrócone wiersze danych będą zawierać pola określone w parametrze groupby , a także następujące: data applicationId (identyfikator aplikacji) applicationName (nazwa_aplikacji) eventCount (liczba zdarzeń) Parametr groupby może być używany z parametrem aggregationLevel . Na przykład: &groupby=failureName,market&aggregationLevel=week — przedmiot grupowania to failureName i market, poziom agregacji to tydzień.	Nie.

Przykład zapytania

W poniższych przykładach pokazano kilka żądań dotyczących pobierania danych raportowania błędów. Zastąp wartość applicationId identyfikatorem produktu dla aplikacji na komputer stacjonarny.

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>

Odpowiedź

Ciało odpowiedzi

Wartość	Typ	Opis
Wartość	układ	Tablica obiektów, które zawierają zagregowane dane raportowania błędów. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz poniżej sekcję dotyczącą wartości błędów .
@nextLink	sznurek	Jeśli istnieją dodatkowe strony danych, ten ciąg zawiera identyfikator URI, którego można użyć do żądania następnej strony danych. Na przykład ta wartość jest zwracana, jeśli górny parametr żądania jest ustawiony na 10000, ale istnieje więcej niż 10000 wierszy błędów dla zapytania.
Łączna liczba	liczba całkowita	Całkowita liczba wierszy w wyniku danych dla zapytania.

Wartości błędów

Elementy w tablicy Value zawierają następujące wartości.

Wartość	Typ	Opis
termin	sznurek	Pierwsza data w zakresie dat dla danych błędów w formacie `yyyy-mm-dd`. Jeśli żądanie określa jeden dzień, ta wartość jest tą datą. Jeśli żądanie określa dłuższy zakres dat, ta wartość jest pierwszą datą w tym zakresie dat. W przypadku żądań określających wartość aggregationLevelgodziny ta wartość zawiera również wartość godziny w formacie `hh:mm:ss`.
applicationId (identyfikator aplikacji)	sznurek	Identyfikator produktu aplikacji komputerowej, dla której pobrano dane o błędach.
nazwa produktu	sznurek	Nazwa wyświetlana aplikacji komputerowej pochodząca z metadanych powiązanych plików wykonywalnych.
nazwa_aplikacji	sznurek	Do ustalenia
nazwa pliku	sznurek	Nazwa pliku wykonywalnego dla aplikacji desktopowej.
nazwaAwarii	sznurek	Nazwa błędu, która składa się z czterech części: co najmniej jednej klasy problemu, kodu sprawdzania wyjątku/błędu, nazwy obrazu, w którym wystąpił błąd i skojarzonej nazwy funkcji.
WskaźnikNiepowodzenia	sznurek	Unikatowy identyfikator błędu.
symbol	sznurek	Symbol przypisany do tego błędu.
osBuild (Kompilacja systemu)	sznurek	Czteroczęściowy numer kompilacji systemu operacyjnego, na którym wystąpił błąd.
Wersja systemu operacyjnego	sznurek	Jeden z następujących ciągów określający wersję systemu operacyjnego, na którym zainstalowano aplikację desktopową: Windows 7 Windows 8.1 Windows 10 Windows 11 Windows Server 2016 Windows Server 1709 Nieznany
osRelease (Wydanie systemu)	sznurek	Jeden z następujących ciągów określających wydanie systemu operacyjnego lub pierścień testowy (jako podpopulacja w wersji systemu operacyjnego), w którym wystąpił błąd. W systemie Windows 11: wersja 2110 W systemie Windows 10: Wersja 1507 Wersja 1511 Wersja 1607 Wersja 1703 Wersja 1709 Wersja 1803 Wersja zapoznawcza Szybka wersja Insider Insider wolny W systemie Windows Server 1709: RTM Dla Windows Server 2016: Wersja 1607 Dla systemu Windows 8.1: Aktualizacja 1 Dla systemu Windows 7: Dodatek Service Pack 1 Jeśli wersja systemu operacyjnego lub pierścień testowy jest nieznany, to pole ma wartość Nieznany.
typ zdarzenia	sznurek	Jeden z następujących ciągów wskazujący typ zdarzenia błędu: awaria wisieć pamięć Język JSE
rynek	sznurek	Kod kraju ISO 3166 dla rynku urządzeń.
typ urządzenia	sznurek	Jeden z następujących ciągów określający typ urządzenia, na którym wystąpił błąd: Komputer osobisty Serwer tablet Nieznany
wersja aplikacji	sznurek	Wersja pliku wykonywalnego aplikacji, w której wystąpił błąd.
liczbaZdarzeń	Liczba	Liczba zdarzeń przypisanych do tego błędu dla określonego poziomu agregacji.

Przykład odpowiedzi

W poniższym przykładzie pokazano przykładową treść odpowiedzi JSON dla tego żądania.

{
  "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
}

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-06-20