Zdobądź instalacje aplikacji

2025-06-20

Użyj tej metody w interfejsie API analizy sklepu Microsoft Store, aby uzyskać zagregowane dane instalacji w formacie JSON dla aplikacji w danym zakresie dat i innych opcjonalnych filtrach. Ta informacja jest również dostępna w Raporcie o Pozyskaniach w Centrum partnerskim.

Wymagania wstępne

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

Jeśli jeszcze tego nie zrobiłeś, wykonaj wszystkie wymagania wstępne dotyczące interfejsu API Microsoft Store do analizy.
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/installs`

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 sklepu aplikacji, dla której chcesz pobrać dane instalacji.	Tak
data rozpoczęcia	termin	Data początkowa w zakresie dat danych instalacyjnych do pobrania. Wartość domyślna to bieżąca data.	Nie.
data zakończenia	termin	Data zakończenia w zakresie dat, z którego pobierane są dane dotyczące instalacji. 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: rynek Wersja systemu operacyjnego typ urządzenia wersja pakietu	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ń.	Nie.
sortowanie według	sznurek	Instrukcja, która porządkuje wartości danych wynikowych dla każdej instalacji. Składnia to orderby=field [order],field [order],.... Parametr pola może być jednym z następujących pól z treści odpowiedzi: applicationName (nazwa_aplikacji) data typ urządzenia rynek Wersja systemu operacyjnego wersja pakietu liczbaUdanychInstalacji 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 orderby: orderby=date,market	Nie.
grupowanie	sznurek	Instrukcja, która stosuje agregację danych tylko do określonych pól. W treści odpowiedzi można określić następujące pola: applicationName (nazwa_aplikacji) data typ urządzenia rynek Wersja systemu operacyjnego wersja pakietu Zwrócone wiersze danych będą zawierać pola określone w parametrze groupby , a także następujące: data applicationId (identyfikator aplikacji) liczbaUdanychInstalacji Parametr groupby może być używany z parametrem aggregationLevel . Na przykład: &groupby=ageGroup,market&aggregationLevel=week	Nie.

Przykład zapytania

W poniższym przykładzie pokazano kilka żądań pobierania danych instalacji aplikacji. Zastąp wartość applicationId identyfikatorem sklepu dla aplikacji.

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&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 zawierających zagregowane dane instalacji. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz poniższą tabelę.
@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 ma wartość 10000, ale dla zapytania jest więcej niż 10000 wierszy danych instalacji.
Łączna liczba	int (integer)	Całkowita liczba wierszy w wyniku danych dla zapytania.

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

Wartość	Typ	Opis
termin	sznurek	Pierwsza data w zakresie dat dotyczących danych instalacji. Jeśli żądanie określiło jeden dzień, ta wartość to ta data. Jeśli w żądaniu określono tydzień, miesiąc lub inny zakres dat, ta wartość jest pierwszą datą w tym zakresie dat.
applicationId (identyfikator aplikacji)	sznurek	Identyfikator sklepu aplikacji, dla której pobierasz dane instalacji.
Nazwa aplikacji	sznurek	Nazwa wyświetlana aplikacji.
typ urządzenia	sznurek	Jeden z następujących ciągów określający typ urządzenia, które zakończyło instalację: Komputer osobisty Telefon Console-Xbox jeden Console-Xbox Seria X Iot Holograficzne Nieznany
wersja pakietu	sznurek	Wersja zainstalowanego pakietu.
Wersja systemu operacyjnego	sznurek	Jeden z następujących ciągów określający wersję systemu operacyjnego, na której wystąpiła instalacja: Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Telefon z systemem Windows Phone 10 Okna 8 Windows 8.1 Windows 10 Windows 11 Nieznany
rynek	sznurek	Kod kraju ISO 3166 rynku, na którym wystąpiła instalacja.
liczbaUdanychInstalacji	Liczba	Liczba pomyślnych instalacji, które wystąpiły podczas określonego poziomu agregacji.

Przykład żądania i odpowiedzi

Poniższe fragmenty kodu przedstawiają przykładowe żądanie i treść odpowiedzi JSON dla tego żądania.

Przykładowe żądanie

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9WZDNCRFJB4P
HTTP/1.1
Authorization: Bearer <your access token>

Przykładowa odpowiedź

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "successfulInstallCount": 100053
        }
    ],
    "TotalCount": 1
}

Przykładowe żądanie

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=06/19/2022&endDate=07/21/2022&top=10&skip=0&groupby=applicationName,date,deviceType,market,osVersion,packageVersion&orderby=date desc
HTTP/1.1
Authorization: Bearer <your access token>

Przykładowa odpowiedź

{
    "Value": [
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "AR",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "AU",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BD",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BG",
            "osVersion": "Windows 11",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BO",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BR",
            "osVersion": "Windows 10",
            "successfulInstallCount": 6
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BR",
            "osVersion": "Windows 11",
            "successfulInstallCount": 3
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "CA",
            "osVersion": "Windows 11",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "CN",
            "osVersion": "Windows 11",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "MX",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        }
    ],
    "TotalCount": 10
}

Udostępnij za pośrednictwem

Zdobądź instalacje aplikacji

Wymagania wstępne

Żądanie

Składnia żądania

Nagłówek żądania

Parametry żądania

Przykład zapytania

Odpowiedź

Ciało odpowiedzi

Przykład żądania i odpowiedzi

Przykładowe żądanie

Przykładowa odpowiedź

Przykładowe żądanie

Przykładowa odpowiedź

Tematy pokrewne

Opinia

Dodatkowe zasoby