Abrufen von App-RezensionenGet app reviews

Verwenden Sie diese Methode in der Microsoft Store Analytics-API, um für einen bestimmten Datumsbereich und andere optionale Filter Überprüfungs Daten im JSON-Format zu erhalten.Use this method in the Microsoft Store analytics API to get review data in JSON format for a given date range and other optional filters. Diese Informationen sind auch im Bericht Reviews in Partner Center verfügbar.This information is also available in the Reviews report in Partner Center.

Nachdem Sie die Überprüfungen abgerufen haben, können Sie die Get Response Info for App Reviews und die Übermittlung von Antworten an App Reviews -Methoden in der Microsoft Store Reviews-API verwenden, um Programm gesteuert auf Überprüfungen zu reagieren.After you retrieve reviews, you can use the get response info for app reviews and submit responses to app reviews methods in the Microsoft Store reviews API to programmatically respond to reviews.

VoraussetzungenPrerequisites

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:To use this method, you need to first do the following:

  • Wenn Sie dies nicht bereits getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store Analytics-API erfüllen.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird.Obtain an Azure AD access token to use in the request header for this method. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft.After you obtain an access token, you have 60 minutes to use it before it expires. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.After the token expires, you can obtain a new one.

AnforderungRequest

AnforderungssyntaxRequest syntax

MethodeMethod Anforderungs-URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews

AnforderungsheaderRequest header

HeaderHeader typeType BESCHREIBUNGDescription
AuthorizationAuthorization Zeichenfolgestring Erforderlich.Required. Das Azure AD-Zugriffstoken im Format Bearer <token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

ParameterParameter typeType BESCHREIBUNGDescription ErforderlichRequired
applicationIdapplicationId Zeichenfolgestring Die Speicher-ID der APP, für die Sie Überprüfungs Daten abrufen möchten.The Store ID of the app for which you want to retrieve review data. JaYes
startDatestartDate datedate Das Startdatum im Datumsbereich der Rezensionsdaten, die abgerufen werden sollen.The start date in the date range of review data to retrieve. Als Standardeinstellung wird das aktuelle Datum festgelegt.The default is the current date. NeinNo
endDateendDate datedate Das Enddatum im Datumsbereich der Rezensionsdaten, die abgerufen werden sollen.The end date in the date range of review data to retrieve. Als Standardeinstellung wird das aktuelle Datum festgelegt.The default is the current date. NeinNo
toptop INTint Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen.The number of rows of data to return in the request. Der Maximal- und Standardwert ist 10.000, wenn nicht anders angegeben.The maximum value and the default value if not specified is 10000. Sind in der Abfrage keine weiteren Zeilen, enthält der Antworttext den Link „Weiter“, über den Sie die nächste Seite mit Daten anfordern können.If there are more rows in the query, the response body includes a next link that you can use to request the next page of data. NeinNo
skipskip INTint Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen.The number of rows to skip in the query. Verwenden Sie diesen Parameter, um große Datensätze durchzublättern.Use this parameter to page through large data sets. Beispielsweise rufen „top=10000“ und „skip=0“ die ersten 10.000 Datenzeilen ab, „top=10000“ und „skip=10000“ die nächsten 10.000 Datenzeilen usw.For example, top=10000 and skip=0 retrieves the first 10000 rows of data, top=10000 and skip=10000 retrieves the next 10000 rows of data, and so on. NeinNo
filterfilter Zeichenfolgestring Mindestens eine Anweisung, die die Zeilen in der Antwort filtert.One or more statements that filter the rows in the response. Weitere Informationen finden Sie unten im Abschnitt Filterfelder.For more information, see the filter fields section below. NeinNo
orderbyorderby Zeichenfolgestring Eine Anweisung, die die Ergebnisdatenwerte anfordert.A statement that orders the result data values. Die Syntax lautet OrderBy = Field [Order], Field [Order],.... Der Feld Parameter kann eine der folgenden Zeichen folgen sein:The syntax is orderby=field [order],field [order],.... The field parameter can be one of the following strings:
  • datedate
  • osVersionosVersion
  • Marktforschungsmarket
  • deviceTypedeviceType
  • isRevisedisRevised
  • packageVersionpackageVersion
  • "DeviceModel"deviceModel
  • productFamilyproductFamily
  • deviceScreenResolutiondeviceScreenResolution
  • isTouchEnabledisTouchEnabled
  • reviewerNamereviewerName
  • reviewTitlereviewTitle
  • reviewtextreviewText
  • helpfulCounthelpfulCount
  • notHelpfulCountnotHelpfulCount
  • responseDateresponseDate
  • responseTextresponseText
  • deviceRAMdeviceRAM
  • deviceStorageCapacitydeviceStorageCapacity
  • Leistungrating

Der Parameter order ist optional und kann asc oder desc sein, um die auf- oder absteigende Anordnung der einzelnen Felder anzugeben.The order parameter is optional, and can be asc or desc to specify ascending or descending order for each field. Der Standardwert ist ASC.The default is asc.

Hier ist ein Beispiel für eine OrderBy -Zeichenfolge: OrderBy = Date, MarketHere is an example orderby string: orderby=date,market

NeinNo

FilterfelderFilter fields

Der Parameter filter der Anforderung enthält mindestens eine Anweisung, die die Zeilen in der Antwort filtert.The filter parameter of the request contains one or more statements that filter the rows in the response. Jede Anweisung enthält ein Feld und einen Wert, das/der mit den Operatoren eq oder ne verknüpft ist. Einige Felder unterstützen darüber hinaus die Operatoren contains, gt, lt, ge und le.Each statement contains a field and value that are associated with the eq or ne operators, and some fields also support the contains, gt, lt, ge, and le operators. Anweisungen können mittels and oder or kombiniert werden.Statements can be combined using and or or.

Dies ist eine Beispielzeichenfolge für filter: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'Here is an example filter string: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

Eine Liste der unterstützten Felder und Operatoren für die einzelnen Felder finden Sie in der folgenden Tabelle.For a list of the supported fields and support operators for each field, see the following table. Zeichenfolgenwerte im Parameter filter müssen von einfachen Anführungszeichen eingeschlossen werden.String values must be surrounded by single quotes in the filter parameter.

FelderFields Unterstützte OperatorenSupported operators BESCHREIBUNGDescription
marketmarket eq, neeq, ne Eine Zeichenfolge, die den ISO 3166-Ländercode des Gerätemarkts enthält.A string that contains the ISO 3166 country code of the device market.
osVersionosVersion eq, neeq, ne Eine der folgenden Zeichenfolgen:One of the following strings:
  • Windows Phone 7.5Windows Phone 7.5
  • Windows Phone 8Windows Phone 8
  • Windows Phone 8.1Windows Phone 8.1
  • Windows Phone 10Windows Phone 10
  • Windows 8Windows 8
  • Windows 8.1Windows 8.1
  • Windows 10Windows 10
  • UnbekanntUnknown
deviceTypedeviceType eq, neeq, ne Eine der folgenden Zeichenfolgen:One of the following strings:
  • PCPC
  • SmartphonePhone
  • Konsole-Xbox OneConsole-Xbox One
  • Konsole-Xbox Series XConsole-Xbox Series X
  • IoTIoT
  • HolographicHolographic
  • UnbekanntUnknown
isRevisedisRevised eq, neeq, ne Geben Sie true an, um nach Rezensionen zu filtern, die überprüft wurden. Geben Sie andernfalls false an.Specify true to filter for reviews that have been revised; otherwise false.
packageVersionpackageVersion eq, neeq, ne Die Version des App-Pakets, das überprüft wurde.The version of the app package that was reviewed.
deviceModeldeviceModel eq, neeq, ne Der Typ des Geräts, auf dem die App überprüft wurde.The type of device on which the app was reviewed.
productFamilyproductFamily eq, neeq, ne Eine der folgenden Zeichenfolgen:One of the following strings:
  • PCPC
  • TabletTablet
  • SmartphonePhone
  • WearableWearable
  • ServerServer
  • GemeinsamesCollaborative
  • AndereOther
deviceRAMdeviceRAM eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le Der physische Arbeitsspeicher (RAM) in MB.The physical RAM, in MB.
deviceScreenResolutiondeviceScreenResolution eq, neeq, ne Die Bildschirmauflösung des Geräts im Format " Breite x Höhe " .The device screen resolution in the format "width x height".
deviceStorageCapacitydeviceStorageCapacity eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le Die Kapazität des primären Datenspeichers in GB.The capacity of the primary storage disk, in GB.
isTouchEnabledisTouchEnabled eq, neeq, ne Geben Sie true an, um nach für die Toucheingabe aktivierten Geräten zu filtern; andernfalls false.Specify true to filter for touch-enabled devices; otherwise false.
reviewerNamereviewerName eq, neeq, ne Der Name der Person, die die App rezensiert hat.The reviewer name.
ratingrating eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le Die App-Bewertung in Sternen.The app rating, in stars.
reviewTitlereviewTitle eq, ne, containseq, ne, contains Der Titel der Rezension.The title of the review.
reviewTextreviewText eq, ne, containseq, ne, contains Der Textinhalt der Rezension.The text contents of the review.
helpfulCounthelpfulCount eq, neeq, ne Die Häufigkeit, mit der die Rezension als nützlich markiert wurde.The number of times the review was marked helpful.
notHelpfulCountnotHelpfulCount eq, neeq, ne Die Häufigkeit, mit der die Rezension als nicht nützlich markiert wurde.The number of times the review was marked not helpful.
responseDateresponseDate eq, neeq, ne Das Datum, an dem die Antwort übermittelt wurde.The date that the response was submitted.
responseTextresponseText eq, ne, containseq, ne, contains Der Textinhalt der Antwort.The text contents of the response.
idid eq, neeq, ne Die ID der Überprüfung (Hierbei handelt es sich um eine GUID).The ID of the review (this is a GUID).

AnforderungsbeispielRequest example

Die folgenden Beispiele zeigen verschiedene Anforderungen für das Abrufen von Rezensionsdaten.The following examples demonstrate several requests for getting review data. Ersetzen Sie den applicationId-Wert durch die Store-ID Ihrer App.Replace the applicationId value with the Store ID for your app.

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>

AntwortResponse

AntworttextResponse body

WertValue typeType BESCHREIBUNGDescription
WertValue arrayarray Ein Array von Objekten, die Rezensionsdaten enthalten.An array of objects that contain review data. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt Rezensionswerte.For more information about the data in each object, see the review values section below.
@nextLink Zeichenfolgestring Wenn weitere Seiten mit Daten vorhanden sind, enthält diese Zeichenfolge einen URI, mit dem Sie die nächste Seite mit Daten anfordern können.If there are additional pages of data, this string contains a URI that you can use to request the next page of data. Beispielsweise wird dieser Wert zurückgegeben, wenn der Parameter top der Anforderung auf 10000 festgelegt ist, es jedoch mehr als 10.000 Zeilen mit Rezensionsdaten für die Abfrage gibt.For example, this value is returned if the top parameter of the request is set to 10000 but there are more than 10000 rows of reviews data for the query.
TotalCountTotalCount INTint Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage.The total number of rows in the data result for the query.

 

RezensionswerteReview values

Elemente im Array Value enthalten die folgenden Werte.Elements in the Value array contain the following values.

WertValue typeType BESCHREIBUNGDescription
datedate Zeichenfolgestring Das erste Datum im Datumsbereich für die Rezensionsdaten.The first date in the date range for the review data. Wenn die Anforderung einen einzelnen Tag angibt, ist dieses Datum dieser Wert.If the request specified a single day, this value is that date. Wenn die Anforderung eine Woche, einen Monat oder einen anderen Datumsbereich angibt, ist dieser Wert das erste Datum in diesem Datumsbereich.If the request specified a week, month, or other date range, this value is the first date in that date range.
applicationIdapplicationId Zeichenfolgestring Die Store-ID der App, für die Sie Rezensionsdaten abrufen.The Store ID of the app for which you are retrieving review data.
applicationNameapplicationName Zeichenfolgestring Der Anzeigename der App.The display name of the app.
marketmarket Zeichenfolgestring Der ISO 3166-Ländercode für den Markt, in dem die Rezension übermittelt wurde.The ISO 3166 country code of the market where the review was submitted.
osVersionosVersion Zeichenfolgestring Die Version des Betriebssystems, auf dem die Rezension übermittelt wurde.The OS version on which the review was submitted. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder.For a list of the supported strings, see the filter fields section above.
deviceTypedeviceType Zeichenfolgestring Der Typ des Geräts, auf dem die Rezension übermittelt wurde.The type of device on which the review was submitted. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder.For a list of the supported strings, see the filter fields section above.
isRevisedisRevised BooleanBoolean Der Wert true gibt an, dass die Rezension überprüft wurde; andernfalls false.The value true indicates that the review was revised; otherwise false.
packageVersionpackageVersion Zeichenfolgestring Die Version des App-Pakets, das überprüft wurde.The version of the app package that was reviewed.
deviceModeldeviceModel Zeichenfolgestring Der Typ des Geräts, auf dem die App überprüft wurde.The type of device on which the app was reviewed.
productFamilyproductFamily Zeichenfolgestring Der Name der Gerätefamilie.The device family name. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder.For a list of the supported strings, see the filter fields section above.
deviceRAMdeviceRAM numbernumber Der physische Arbeitsspeicher (RAM) in MB.The physical RAM, in MB.
deviceScreenResolutiondeviceScreenResolution Zeichenfolgestring Die Bildschirmauflösung des Geräts im Format "Width x height" (Breite x Höhe).The device screen resolution in the format "width x height".
deviceStorageCapacitydeviceStorageCapacity numbernumber Die Kapazität des primären Datenspeichers in GB.The capacity of the primary storage disk, in GB.
isTouchEnabledisTouchEnabled BooleanBoolean Der Wert true gibt an, dass die Toucheingabe aktiviert ist; andernfalls false.The value true indicates that touch is enabled; otherwise false.
reviewerNamereviewerName Zeichenfolgestring Der Name der Person, die die App rezensiert hat.The reviewer name.
ratingrating numbernumber Die App-Bewertung in Sternen.The app rating, in stars.
reviewTitlereviewTitle Zeichenfolgestring Der Titel der Rezension.The title of the review.
reviewTextreviewText Zeichenfolgestring Der Textinhalt der Rezension.The text contents of the review.
helpfulCounthelpfulCount numbernumber Die Häufigkeit, mit der die Rezension als nützlich markiert wurde.The number of times the review was marked helpful.
notHelpfulCountnotHelpfulCount numbernumber Die Häufigkeit, mit der die Rezension als nicht nützlich markiert wurde.The number of times the review was marked not helpful.
responseDateresponseDate Zeichenfolgestring Das Datum, an dem eine Antwort übermittelt wurde.The date a response was submitted.
responseTextresponseText Zeichenfolgestring Der Textinhalt der Antwort.The text contents of the response.
idid Zeichenfolgestring Die ID der Überprüfung (Hierbei handelt es sich um eine GUID).The ID of the review (this is a GUID). Sie können diese ID in der Get Response Info for App Reviews und Submit Response to App Reviews Methods verwenden.You can use this ID in the get response info for app reviews and submit responses to app reviews methods.

AntwortbeispielResponse example

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.The following example demonstrates an example JSON response body for this request.

{
  "Value": [
    {
      "date": "2015-07-29",
      "applicationId": "9NBLGGGZ5QDR",
      "applicationName": "Contoso demo",
      "market": "US",
      "osVersion": "10.0.10240.16410",
      "deviceType": "PC",
      "isRevised": true,
      "packageVersion": "",
      "deviceModel": "Microsoft Corporation-Virtual Machine",
      "productFamily": "PC",
      "deviceRAM": -1,
      "deviceScreenResolution": "1024 x 768",
      "deviceStorageCapacity": 51200,
      "isTouchEnabled": false,
      "reviewerName": "ALeksandra",
      "rating": 5,
      "reviewTitle": "Love it",
      "reviewText": "Great app for demos and great dev response.",
      "helpfulCount": 0,
      "notHelpfulCount": 0,
      "responseDate": "2015-08-07T01:50:22.9874488Z",
      "responseText": "1",
      "id": "6be543ff-1c9c-4534-aced-af8b4fbe0316"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}