Récupération des évaluations de la communauté : méthode GET (Documentation Steamworks)

Documentation Steamworks

Récupération des évaluations de la communauté : méthode GET

Documentation Steamworks > Présence sur le magasin > Récupération des évaluations de la communauté : méthode GET

Si vous souhaitez obtenir une liste des évaluations d'une application Steam, vous pouvez utiliser la méthode suivante avec les paramètres indiqués.

Paramètres

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

Nom	Type	Obligatoire	Description
filter	string	✔	recent : classement par date de création. updated : classement par date de mise à jour. all (valeur par défaut) : classement par pertinence, avec des fenêtres glissantes en fonction du paramètre day_range. Ce classement renverra toujours des résultats. Si vous consultez les évaluations avec `cursor`, choisissez alors l'une des options « recent » ou « updated » pour obtenir une liste de réponses vide.
language	string	✔	Code langue de l'API Web (https://partner.steamgames.com/doc/store/localization/languages), ou « all » pour récupérer les évaluations dans toutes les langues.
day_range	string	✔	Intervalle de jours entre aujourd'hui et il y a n jours dans lequel rechercher les évaluations pertinentes. Applicable seulement pour le filtre « all ». La valeur maximale est de 365.
cursor	string	✔	Les évaluations sont retournées par lots de 20. Passez « * » pour le premier ensemble, puis la valeur de « cursor » retournée dans la réponse pour le suivant, etc. Remarque : les valeurs de « cursor » peuvent contenir des caractères qui doivent être encodés avec le symbole % pour pouvoir être utilisés dans la chaine de requête.
review_type	string	✔	all (valeur par défaut) : toutes les évaluations. positive : seulement les évaluations positives. negative : seulement les évaluations négatives.
purchase_type	string	✔	all : toutes les évaluations. non_steam_purchase : évaluations écrites par les personnes qui n'ont pas acheté le produit sur Steam. steam (valeur par défaut) : évaluations écrites par les personnes qui ont acheté le produit sur Steam.
num_per_page	string	✔	Par défaut, 20 évaluations sont retournées au maximum. Ce paramètre permet de spécifier un nombre d'évaluations plus élevé (limité à 100).
filter_offtopic_activity	number		Par défaut, les évaluations hors sujet (issues de « matraquage d'évaluations ») sont filtrées et ne sont pas renvoyées par cette API. Passez 0 comme valeur de ce paramètre pour les inclure. Pour plus d'informations sur les matraquages d'évaluation, consultez la section dédiée de l'article sur les évaluations de la communauté.

Éléments renvoyés

Une liste d'évaluations au format JSON correspondant aux paramètres, avec des champs d'informations. Les chaines de caractères dans le JSON peuvent contenir des séquences d'échappement, et vous devrez peut-être nettoyer les données renvoyées pour pouvoir les utiliser.

Réponse

success : vaut 1 si la requête a réussi
query_summary : renvoyé lors de la première requête
- num_reviews : nombre d'évaluations renvoyées dans cette réponse
- review_score : moyenne des évaluations
- review_score_desc : description de la moyenne des évaluations
- total_positive : nombre total d'évaluations positives
- total_negative : nombre total d'évaluations négatives
- total_reviews : nombre total d'évaluations qui correspondent aux paramètres de recherche
cursor : la valeur à passer pour le paramètre cursor de la prochaine requête pour récupérer le prochain lot d'évaluations
reviews
- recommendationid : ID unique de l'évaluation
- author
  - steamid : SteamID de l'utilisateur ou utilisatrice
  - num_games_owned : nombre de jeux possédés par la personne
  - num_reviews : nombre d'évaluations écrites par la personne
  - playtime_forever : temps de jeu total pour cette application
  - playtime_last_two_weeks : temps de jeu pour cette application pendant les deux dernières semaines
  - playtime_at_review : temps de jeu au moment de la publication de l'évaluation
  - last_played : date de la dernière utilisation
- language : langue indiquée par la personne lors de la rédaction de l'évaluation
- review : texte de l'évaluation
- timestamp_created : date de création de l'évaluation (heure Unix)
- timestamp_updated : date de la dernière mise à jour de l'évaluation (heure Unix)
- voted_up : vaut true s'il s'agit d'une évaluation positive
- votes_up : nombre de personnes qui ont trouvé cette évaluation utile
- votes_funny : nombre de personnes qui ont trouvé cette évaluation amusante
- weighted_vote_score : score de pertinence
- comment_count : nombre de commentaires publiés sur cette évaluation
- steam_purchase : vaut true si la personne a acheté le jeu sur Steam
- received_for_free : vaut true si la case qui indique que l'application a été obtenue gratuitement a été cochée
- written_during_early_access : vaut true si l'utilisateur ou l'utilisatrice a publié cette évaluation pendant la phase d'accès anticipé du jeu
- developer_response : réponse de l'équipe de développement, le cas échéant
- timestamp_dev_responded : heure Unix de la réponse de l'équipe de développement, le cas échéant