Käyttäjäarvioinnit – Get List -metodi (Steamworks-dokumentaatio)

Steamworks-dokumentaatio

Käyttäjäarvioinnit – Get List -metodi

Steamworks-dokumentaatio > Kaupan ulkoasu > Käyttäjäarvioinnit – Get List -metodi

Jos haluat ottaa vedoksen Steamissä olevista sovelluksen arvioinneista, voit käyttää seuraavaa metodia oheisilla parametreillä.

Parametrit

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

Nimi	Tyyppi	Pakollinen	Kuvaus
filter	string	✔	recent – lajiteltu luontiajan mukaan updated – lajiteltu viimeisimmän päivitysajan mukaan all – (oletus) lajiteltu hyödyllisyyden mukaan, jossa liukuva ikkuna perustuu day_range-parametriin, joka löytää aina palautettavia tuloksia. Jos selaat arviointeja `cursor`-parametrillä, valitse joko "recent"- tai "updated"-vaihtoehto, kunnes saat lopulta tyhjän vastauslistan.
language	string	✔	Katso https://partner.steamgames.com/documentation/languages (ja käytä ohjelmointirajapinnan kielikoodiluetteloa) tai hae kaikki arvioinnit “all”-valinnalla.
day_range	string	✔	Jakso tästä hetkestä n päivää sitten olleeseen ajankohtaan hyödyllisten arvostelujen hakemista varten. Saatavilla vain "all"-suodattimelle. Enimmäismäärä on 365.
cursor	string	✔	Arvioinnit palautetaan 20 arvioinnin erissä, joten anna "*" ensimmäiselle sarjalle ja anna sitten cursor-muuttujan arvo, joka palautettiin seuraavan sarjan vastauksena jne. Huomaa, että cursor-parametrin arvot saattavat sisältää merkkejä, jotka pitää URL-enkoodata kyselyn merkkijonossa.
review_type	string	✔	all – kaikki arvostelut (oletus) positive – kaikki positiiviset arvostelut negative – kaikki negatiiviset arvostelut
purchase_type	string	✔	all – kaikki arviot non_steam_purchase – arvioinnit käyttäjiltä, jotka eivät maksaneet tuotteesta Steamissä steam – arvioinnit käyttäjiltä, jotka maksoivat tuotteesta Steamissä (oletus)
num_per_page	string	✔	Oletuksena palautetaan jopa 20 arviointia. Tämän parametrin avulla voidaan palauttaa useampia arviointeja (enintään 100).
filter_offtopic_activity	number		Oletuksena (arvosteluvääristymän aiheuttavat) arvostelut, jotka eivät liity aiheeseen, suodatetaan pois, eikä niitä palauteta ohjelmointirajapintaan. Jos parametrin arvo on 0, ne lasketaan mukaan. Lisätietoja täältä.

Paluuarvot

JSON-muotoinen lista arvioinneista, jotka vastaavat parametrejä sekä niiden tietokentät. JSON-tiedoston merkkijonot saattavat sisältää ohjausmerkkejä, ja ne pitää ehkä muuntaa todellisiksi vastauksen datassa ennen vastauksen käyttöä.

Vastaus:

success – 1, jos kysely oli onnistunut
query_summary – palautettu ensimmäisessä pyynnössä
- num_reviews – palautettujen arviointien lukumäärä vastauksessa
- review_score – arviointipisteet
- review_score_desc – arviointipisteiden kuvaus
- total_positive – positiivisten arviointien kokonaismäärä
- total_negative – negatiivisten arviointien kokonaismäärä
- total_reviews – kyselyn parametrejä vastaavien arviointien kokonaismäärä
cursor – seuraavaan pyyntöön siirrettävä arvo, kun cursor palauttaa seuraavan erän arvioinnit
reviews
- recommendationid – arvioinnin uniikki ID
- author
  - steamid – käyttäjän SteamID
  - num_games_owned – käyttäjän omistamien pelien lukumäärä
  - num_reviews – käyttäjän kirjoittamien arviointien lukumäärä
  - playtime_forever – sovelluksen kokonaispeliaika
  - playtime_last_two_weeks – sovelluksen viimeisen kahden viikon aikainen peliaika
  - playtime_at_review – peliaika yhteensä arvioinnin kirjoittamishetkellä
  - last_played – aika, jolloin käyttäjä pelasi viimeksi
- language – käyttäjän arvioinnin kirjoittamisen aikaan määrittämä kieli
- review – kirjoitetun arvioinnin teksti
- timestamp_created – päivä, jolloin arviointi on luotu (UNIX-aikaleima)
- timestamp_updated – päivä, jolloin arviointia on viimeksi päivitetty (UNIX-aikaleima)
- voted_up – true tarkoittaa, että kyseessä oli positiivinen suositus
- votes_up – käyttäjien lukumäärä, joiden mielestä arviointi oli hyödyllinen
- votes_funny – käyttäjien lukumäärä, joiden mielestä arviointi oli hauska
- weighted_vote_score – hyödyllisyyspisteet
- comment_count – arvioinnin julkaistujen kommenttien lukumäärä
- steam_purchase – true, jos käyttäjä osti pelin Steamissä
- received_for_free – true, jos käyttäjä ilmoitti saaneensa sovelluksen ilmaiseksi
- written_during_early_access – true, jos käyttäjä julkaisi arvioinnin, kun peli oli Early Access -vaiheessa
- developer_response – kehittäjän vastausteksti, jos sellainen on
- timestamp_dev_responded – kehittäjän vastauksen UNIX-aikaleima, jos saatavilla