使用者評論 - 取得列表（Steamworks 文獻庫）

Steamworks 文獻庫

使用者評論 - 取得列表

若希望取得 Steam 上一款應用程式的評論傾印，您可將參數傳入以下方法。

參數：

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

名稱	型別	必要	說明
filter	string	✔	recent – 依建立時間排列。 updated – 依最後更新時間排列。 all – （預設）依值得參考的程度排列，並會根據 day_range 設置有效幅度，永遠會傳回結果。如果是以 `cursor` 來分頁評論，那麼請選擇 recent 或 updated 選項，至終會取得空的回應列表。
language	string	✔	請見 https://partner.steamgames.com/documentation/languages （並使用當中的 API 語言碼表）或傳入「all」取得所有評論。
day_range	string	✔	用來尋找從現在到 N 天前這個範圍內值得參考的評論。只適用於 filter 為「all」時。最大值為 365。
cursor	string	✔	評論將以 20 篇為一批傳回，因此第一批傳入「*」，之後下一批將傳回「cursor」的值，以此類推。請注意 cursor 值可能包含一些字元，需要進行 URL 編碼才能用於查詢字串。
review_type	string	✔	all – 所有評論（預設）。 positive – 僅限正面評論。 negative – 僅限負面評論。
purchase_type	string	✔	all – 所有評論 non_steam_purchase – 由並未在 Steam 上購買產品的使用者撰寫。 steam – 由在 Steam 上自行購買產品的使用者撰寫（預設）。
num_per_page	string	✔	預設狀況下，最多可傳回 20 篇評論。利用此參數可傳回更高數量的評論（最高為 100 篇）。
filter_offtopic_activity	number		by default, off-topic reviews (aka "Review Bombs") are filtered out and are not returned in this API. Pass 0 to include them. See here.

傳回

符合參數的 JSON 格式評論列表，並附有以下資訊欄位。 JSON 中的字串可能含有逸出序列，在回應中的資料可能需要在使用前移除逸出部分。

回應：

success - 若查詢成功，則為 1
query_summary - 第一個要求中傳回
- num_reviews - 此回應中傳回的評論數量
- review_score - 評論分數
- review_score_desc - 評論分數說明
- total_positive - 正面評論總數
- total_negative - 負面評論總數
- total_reviews - 符合查詢參數的評論總數
cursor - 為擷取下一批評論而傳入下一個請求的 cursor 的值
reviews
- recommendationid - 推薦的獨特 ID
- author
  - steamid - 使用者的 Steam ID
  - num_games_owned - 使用者擁有的遊戲數量
  - num_reviews - 使用者撰寫的評論數量
  - playtime_forever - 此應用程式紀錄的終身遊玩時數
  - playtime_last_two_weeks - 此應用程式過去兩週紀錄的遊玩時數
  - playtime_at_review - 評論撰寫時的遊玩時數
  - last_played - 玩家最後遊玩的時間
- language - 使用者發表評論時註明的使用語言
- review - 撰寫的評論文本
- timestamp_created - 評論建立日期（Unix 時間戳記）
- timestamp_updated - 評論最後更新日期（Unix 時間戳記）
- voted_up - true 為正面評論
- votes_up - 認為此篇評論值得參考的使用者人數
- votes_funny - 認為此篇評論有趣的使用者人數
- weighted_vote_score - 參考價值分數
- comment_count - 發表於此篇評論之下的留言數
- steam_purchase - true 表示使用者在 Steam 上購買了該產品
- received_for_free - true 表示使用者勾選了產品為免費獲得的方塊
- written_during_early_access - true 表示評論是在遊戲尚處搶先體驗階段發表的
- developer_response - 開發者的回應文字（如有）
- timestamp_dev_responded - 開發者回應的 Unix 時間戳記（如有）