Uzyskiwanie przeglądów aplikacji

Użyj tej metody w interfejsie API analizy sklepu Microsoft Store, aby uzyskać dane przeglądu w formacie JSON dla danego zakresu dat i innych opcjonalnych filtrów. Te informacje są również dostępne w raporcie Recenzje w Centrum Partnerskim.

Po pobraniu recenzji możesz użyć metod pobierz informacje o odpowiedzi na recenzje aplikacji i przesłać odpowiedzi do recenzji aplikacji w interfejsie API recenzji Microsoft Store, aby programowo reagować na recenzje.

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 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/reviews

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 dla aplikacji, dla której chcesz pobrać dane z recenzji.	Tak
data rozpoczęcia	termin	Data początkowa w przedziale dat, z którego pobierane są dane do przeglądu. Wartość domyślna to bieżąca data.	Nie.
data zakończenia	termin	Data końcowa w zakresie dat przeglądu danych do pobrania. 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. Aby uzyskać więcej informacji, zobacz sekcję pól filtru poniżej.	Nie.
sortowanie według	sznurek	Instrukcja, która porządkuje wartości danych wyników. Składnia to orderby=pole [order],pole [order],.... Parametr pole może być jednym z następujących ciągów: data wersjaSystemuOperacyjnego rynek typUrządzenia jestZmieniony wersja pakietu deviceModel (model urządzenia) Rodzina produktów deviceScreenResolution (rozdzielczość ekranu) isTouchEnabled (Włączona funkcja isTouchEnabled) Imię i nazwisko recenzenta reviewTitle (recenzjaTytuł) reviewText (tekst recenzji) pomocny licznik notHelpCount (liczba nieprzydatnych) data_odpowiedzi responseText (Tekst odpowiedzi) pamięćRAM urządzenia pojemność pamięci urządzenia ocena 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.

Filtrowanie pól

Parametr filtru w żądaniu zawiera jedną lub więcej instrukcji filtrujących wiersze w odpowiedzi. Każda instrukcja zawiera pole i wartość, które są skojarzone z operatorami eq lub ne , a niektóre pola obsługują również operatory contains, gt, lt, ge i le . Stwierdzenia można łączyć przy użyciu i lub lub.

Oto przykładowy ciąg filtru : filter=contains(reviewText,'great') i contains(reviewText,'ads') i deviceRAM lt 2048 i market eq "US"

Aby uzyskać listę obsługiwanych pól i operatorów obsługi dla każdego pola, zobacz poniższą tabelę. Wartości ciągu muszą być otoczone pojedynczymi cudzysłowami w parametrze filtru .

Pola formularza	Obsługiwane operatory	Opis
rynek	eq, ne	Ciąg znaków zawierający kod państwowy ISO 3166 dla rynku urządzenia.
Wersja systemu operacyjnego	eq, ne	Jeden z następujących ciągów: 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
typ urządzenia	eq, ne	Jeden z następujących ciągów: Komputer osobisty Telefon Console-Xbox jeden SeriaConsole-Xbox X Iot Holograficzne Nieznany
jestZmieniony	eq, ne	Określ true, aby filtrować recenzje, które zostały poprawione; w przeciwnym razie false.
wersja pakietu	eq, ne	Wersja pakietu aplikacji, który został przejrzyszony.
Model urządzenia	eq, ne	Typ urządzenia, na którym została sprawdzona aplikacja.
rodzina produktów	eq, ne	Jeden z następujących ciągów: Komputer osobisty tablet Telefon Ubieralne Serwer Współpracyjący Inne
pamięć RAM urządzenia	eq, ne, gt, lt, ge, le	Fizyczna pamięć RAM, w MB.
rozdzielczośćEkranuUrządzenia	eq, ne	Rozdzielczość ekranu urządzenia w formacie "width x height".
pojemność pamięci urządzenia	eq, ne, gt, lt, ge, le	Pojemność głównego dysku pamięci w GB.
czyDotykAktywny	eq, ne	Określ true do filtrowania urządzeń z obsługą dotykową; w przeciwnym razie false.
Imię i nazwisko recenzenta	eq, ne	Nazwa recenzenta.
ocena	eq, ne, gt, lt, ge, le	Ocena aplikacji w gwiazdkach.
tytuł recenzji	równa się, nie równa się, zawiera	Tytuł przeglądu.
tekst recenzji	równa się, nie równa się, zawiera	Zawartość tekstowa przeglądu.
liczba pomocnych opinii	eq, ne	Liczba przypadków, w których recenzja została oznaczona jako pomocna.
liczbaNiezbytPomocnych	eq, ne	Liczba razy, kiedy recenzja została oznaczona jako nieprzydatna.
data_odpowiedzi	eq, ne	Data przesłania odpowiedzi.
tekst odpowiedzi	równa się, nie równa się, zawiera	Zawartość tekstowa odpowiedzi.
id	eq, ne	Identyfikator przeglądu (jest to identyfikator GUID).

Przykład zapytania

W poniższych przykładach pokazano kilka żądań pobierania danych przeglądu. Zastąp wartość applicationId identyfikatorem sklepu dla aplikacji.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?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/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>

Odpowiedź

Ciało odpowiedzi

Wartość	Typ	Opis
Wartość	układ	Tablica obiektów zawierających dane recenzji. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz sekcję przejrzyj wartości poniżej.
@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 parametr top żądania jest ustawiony na 10000, ale dla zapytania istnieje więcej niż 10000 wierszy danych z recenzjami.
Łączna liczba	int (integer)	Całkowita liczba wierszy w wyniku danych dla zapytania.

 

Przegląd wartości

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

Wartość	Typ	Opis
termin	sznurek	Pierwsza data w zakresie dat dla danych przeglądu. 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 dotyczące recenzji.
Nazwa aplikacji	sznurek	Nazwa wyświetlana aplikacji.
rynek	sznurek	Kod kraju ISO 3166 rynku, na którym został złożony przegląd.
Wersja systemu operacyjnego	sznurek	Wersja systemu operacyjnego, na której została przesłana recenzja. Aby zapoznać się z listą obsługiwanych ciągów, zobacz sekcję pól filtru powyżej.
typ urządzenia	sznurek	Typ urządzenia, na którym przesłano recenzję. Aby zapoznać się z listą obsługiwanych ciągów, zobacz sekcję pól filtru powyżej.
jestZmieniony	Boolowski	Wartość true wskazuje, że przegląd został poprawiony; w przeciwnym razie false.
wersja pakietu	sznurek	Wersja pakietu aplikacji, który został przejrzyszony.
Model urządzenia	sznurek	Typ urządzenia, na którym została sprawdzona aplikacja.
rodzina produktów	sznurek	Nazwa rodziny urządzeń. Aby zapoznać się z listą obsługiwanych ciągów, zobacz sekcję pól filtru powyżej.
pamięć RAM urządzenia	Liczba	Fizyczna pamięć RAM, w MB.
rozdzielczośćEkranuUrządzenia	sznurek	Rozdzielczość ekranu urządzenia w formacie "width x height".
pojemność pamięci urządzenia	Liczba	Pojemność głównego dysku pamięci w GB.
czyDotykAktywny	Boolowski	Wartość true wskazuje, że dotyk jest włączony; w przeciwnym razie false.
Imię i nazwisko recenzenta	sznurek	Nazwa recenzenta.
ocena	Liczba	Ocena aplikacji w gwiazdkach.
tytuł recenzji	sznurek	Tytuł przeglądu.
tekst recenzji	sznurek	Zawartość tekstowa przeglądu.
liczba pomocnych opinii	Liczba	Liczba przypadków, w których recenzja została oznaczona jako pomocna.
liczbaNiezbytPomocnych	Liczba	Liczba razy, kiedy recenzja została oznaczona jako nieprzydatna.
data_odpowiedzi	sznurek	Data przesłania odpowiedzi.
tekst odpowiedzi	sznurek	Zawartość tekstowa odpowiedzi.
id	sznurek	Identyfikator przeglądu (jest to identyfikator GUID). Tego identyfikatora można użyć w metodach pobierania informacji o odpowiedziach na przeglądy aplikacji i przesyłania odpowiedzi na przeglądy aplikacji.

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/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Przykładowa odpowiedź

{
    "Value": [
        {
            "date": "3/5/2021 12:48:33 PM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "Jose Antonio",
            "rating": 5,
            "reviewTitle": "Contoso Demo",
            "reviewText": "Un juego fantastico",
            "helpfulCount": 3,
            "notHelpfulCount": 0,
            "id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
        },
        {
            "date": "1/6/2021 8:41:42 AM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "fef",
            "rating": 5,
            "helpfulCount": 0,
            "notHelpfulCount": 0,
            "id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
        }
    ],
    "TotalCount": 2
}

Tematy pokrewne

• Raport przeglądów
• Uzyskiwanie dostępu do danych analitycznych przy użyciu usług ze Sklepu Microsoft
• Uzyskaj informacje o odpowiedziach na recenzje aplikacji
• Prześlij odpowiedzi do recenzji aplikacji
• Pozyskiwanie użytkowników dla aplikacji
• Uzyskiwanie dodatkowych rozszerzeń
• Pobieranie danych raportowania błędów
• Uzyskiwanie ocen aplikacji