Udostępnij przez

Uzyskaj instalacje aplikacji desktopowych

Użyj tego identyfikatora URI REST, aby uzyskać zbiorcze dane dotyczące instalacji w formacie JSON dla aplikacji na komputery stacjonarne, którą dodałeś do programu Windows Desktop Application. Ten URI umożliwia uzyskiwanie danych instalacyjnych w określonym zakresie dat oraz inne opcjonalne filtry. Ta informacja jest również dostępna w raporcie Installs dla aplikacji klasycznych w Partner Center.

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 i dla API analizy 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/installbasedaily

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 desktopowej, dla której chcesz pobrać dane instalacji. Aby uzyskać identyfikator produktu aplikacji klasycznej, otwórz dowolny raport analityczny aplikacji klasycznej w Centrum partnerskim (takim jak raport Instalowanie) i pobierz identyfikator produktu z adresu URL, umieszczając wskaźnik myszy na linku, aby wyświetlić szczegóły. Tak
data rozpoczęcia termin Data początkowa w zakresie dat danych instalacyjnych do pobrania. Wartość domyślna to 90 dni przed bieżącą datą. 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 lub lub. 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:

  • applicationVersion (wersja aplikacji)
  • typ urządzenia
  • rynek
  • wersja systemu operacyjnego
  • osRelease (Wydanie systemu)
 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:

  • Nazwa produktu
  • daty
  • applicationVersion (wersja aplikacji)
  • typ urządzenia
  • rynek
  • wersja systemu operacyjnego
  • osRelease (Wydanie systemu)
  • installBase

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:

  • applicationVersion (wersja aplikacji)
  • typ urządzenia
  • rynek
  • wersja systemu operacyjnego
  • osRelease (Wydanie systemu)

Zwrócone wiersze danych będą zawierać pola określone w parametrze groupby , a także następujące:

  • applicationId (identyfikator aplikacji)
  • daty
  • Nazwa produktu
  • installBase

 Nie.

Przykład zapytania

Poniższy przykład demonstruje kilka żądań uzyskiwania danych instalacji aplikacji desktopowych. Zastąp wartość applicationId identyfikatorem produktu dla aplikacji na komputer stacjonarny.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily?applicationId=1234567890&startDate=2018-01-01&endDate=2018-02-01&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily?applicationId=1234567890&startDate=2018-01-01&endDate=2018-02-01&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 Data skojarzona z wartością bazową instalacji.
applicationId (identyfikator aplikacji) sznurek Identyfikator produktu aplikacji desktopowej, dla której pobrano dane instalacyjne.
nazwa produktu sznurek Nazwa wyświetlana aplikacji komputerowej pochodząca z metadanych powiązanych plików wykonywalnych.
wersja aplikacji sznurek Zainstalowana wersja pliku wykonywalnego aplikacji.
typ urządzenia sznurek Jeden z następujących ciągów określających typ urządzenia, na którym zainstalowano aplikację klasyczną:

  • Komputer osobisty
  • Serwer
  • tablet
  • Nieznane
rynek sznurek Kod kraju ISO 3166 dotyczący rynku, na którym zainstalowano aplikację stacjonarną.
Wersja systemu operacyjnego sznurek Jeden z następujących ciągów określających wersję systemu operacyjnego, na którym zainstalowano aplikację desktopową:

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • Nieznane
osRelease (Wydanie systemu) sznurek Jeden z poniższych ciągów określający pierścień wydania systemu operacyjnego lub pierścienia testowego (jako podpopulacji w wersji systemu operacyjnego), na którym zainstalowano aplikację klasyczną.

W systemie Windows 11: wersja 2110

W systemie Windows 10:

  • wersja 1507
  • w wersji 1511
  • wersja 1607
  • w wersji 1703
  • wersja 1709
  • Wersja zapoznawcza
  • Szybka wersja Insider
  • Insider Wolne

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ść Nieznane.
installBase Liczba Liczba odrębnych urządzeń, na których zainstalowano produkt na określonym poziomie agregacji.

Przykład odpowiedzi

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

{
  "Value": [
    {
      "date": "2018-01-24",
      "applicationId": "123456789",
      "productName": "Contoso Demo",
      "applicationVersion": "1.0.0.0",
      "deviceType": "PC",
      "market": "All",
      "osVersion": "Windows 10",
      "osRelease": "Version 1709",
      "installBase": 348218.0
    }
  ],
  "@nextLink": "desktop/installbasedaily?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}
  • program aplikacji desktopowych systemu Windows
  • Last updated on