Nutzerrezensionen – Liste abrufen (Steamworks-Dokumentation)

Steamworks-Dokumentation

Nutzerrezensionen – Liste abrufen

Steamworks-Dokumentation > Shopauftritt > Nutzerrezensionen – Liste abrufen

Wenn Sie einen Auszug von Rezensionen für eine Anwendung auf Steam erhalten möchten, können Sie dazu die folgende Methode mit den unten angegebenen Parametern verwenden.

Parameter:

GET store.steampowered.com/appreviews/<appid>?json=1

Name	Typ	Erforderlich?	Beschreibung
filter	string	✔	recent: nach Erstellungsdatum sortiert. updated: nach Aktualisierungsdatum sortiert. all: (Standard) nach Nützlichkeit sortiert, mit gleitenden Bereichen auf dem Parameter „day_range“ basierend, wird immer Ergebnisse zurückgeben. Wenn Sie mit `cursor` durch die Rezensionen „blättern“, wählen Sie bitte entweder die Option „recent“ oder die Option „updated“, um schließlich eine leere Antwortliste zu erhalten.
language	string	✔	Lesen Sie https://partner.steamgames.com/documentation/languages (und verwenden Sie die API-Sprachcodesliste) oder übergeben Sie „all“, um Rezensionen aller Sprachen zu erhalten.
day_range	string	✔	Bereich von jetzt bis vor n Tagen, um nach hilfreichen Rezensionen zu suchen. Nur auf den Filter "all" anwendbar. Der Maximalwert ist 365.
cursor	string	✔	Es werden immer bis zu 20 Rezensionen zurückgegeben. Übergeben Sie für den ersten Satz „*“ und anschließend für jeden weiteren Satz den zurückgegebenen Wert von „cursor“ des vorigen Satzes. Bedenken Sie bitte, dass Zeigerwerte Zeichen beinhalten können, die zur Verwendung im Abfragestring URL-kodiert sein müssen.
review_type	string	✔	all: alle Rezensionen (Standard) positive: nur positive Rezensionen negative: nur negative Rezensionen
purchase_type	string	✔	all: alle Rezensionen. non_steam_purchase: Rezensionen von Nutzern, die nicht auf Steam für das Produkt bezahlt haben. steam: Rezensionen von Nutzern, die auf Steam für das Produkt bezahlt haben. (Standard)
num_per_page	string	✔	Standardmäßig werden bis zu 20 Rezensionen zurückgegeben. Abhängig von diesem Parameter können auch mehr Rezensionen zurückgegeben werden (maximal 100).
filter_offtopic_activity	number		Standardmäßig werden themenfremde Rezensionen (auch als „Rezensionsbomben“ (Review Bombs) bekannt) herausgefiltert und von dieser API nicht zurückgegeben. Übergeben Sie „0“, um diese miteinzubeziehen. Weitere Informationen

Rückgabewert

JSON-formatierte Liste von den Parametern entsprechenden Rezensionen mit Info-Feldern. Strings im JSON-Format können Escape-Sequenzen enthalten. Escapezeichen müssen unter Umständen aus den Daten in der Antwort entfernt werden, bevor diese verwendet werden können.

Antwort:

success: gibt den Wert „1“ aus, wenn die Abfrage erfolgreich war.
query_summary: wird in der ersten Abfrage zurückgegeben.
- num_reviews: Anzahl der in dieser Antwort zurückgegebenen Rezensionen.
- review_score: Rezensionswertung.
- review_score_desc: Beschreibung der Rezensionswertung.
- total_positive: Gesamtzahl der positiven Rezensionen.
- total_negative: Gesamtzahl der negativen Rezensionen.
- total_reviews: Gesamtzahl der mit den Abfrageparametern übereinstimmenden Rezensionen.
cursor: der Wert, der in der nächsten Abfrage als cursor übergeben werden soll, um den nächsten Satz Rezensionen zu erhalten.
reviews
- recommendationid: eindeutige ID der Rezension.
- author
  - steamid: die Steam-ID des Nutzers.
  - num_games_owned: die Anzahl der Spiele, die der Nutzer besitzt.
  - num_reviews: Anzahl der vom Nutzer verfassten Rezensionen.
  - playtime_forever: in der Anwendung erfasste Spielzeit (insgesamt).
  - playtime_last_two_weeks: in der Anwendung erfasste Spielzeit innerhalb der letzten zwei Wochen.
  - playtime_at_review: Spielzeit zum Zeitpunkt des Verfassens der Rezension.
  - last_played: Zeitpunkt, zu dem der Nutzer die Anwendung zuletzt gespielt hat.
- language: Sprache, die der Nutzer beim Verfassen der Rezension angegeben hat.
- review: Text der geschriebenen Rezension.
- timestamp_created: Erstellungsdatum der Rezension (Unix-Zeitstempel).
- timestamp_updated: Datum der letzten Aktualisierung der Rezension (Unix-Zeitstempel).
- voted_up: true bedeutet, dass es sich um eine positive Empfehlung handelt.
- votes_up: Anzahl der Nutzer, die diese Rezension hilfreich fanden.
- votes_funny: Anzahl der Nutzer, die diese Rezension lustig fanden.
- weighted_vote_score : Wert, wie hilfreich die Rezension ist.
- comment_count: Anzahl der zu dieser Rezension verfassten Kommentare.
- steam_purchase: true, wenn der Nutzer das Spiel auf Steam erworben hat.
- received_for_free: true, wenn vom Nutzer angegeben wurde, dass dieser das Spiel kostenlos erhalten hat.
- written_during_early_access: true, wenn der Nutzer die Rezension verfasst hat, während sich das Spiel in der Early-Access-Phase befunden hat.
- developer_response: Text der Entwicklerantwort, wenn vorhanden.
- timestamp_dev_responded: Unix-Zeitstempel der Entwicklerantwort, falls dies zutrifft.