跳轉到主要內容
Economy v2 現已正式推出。如需支援與意見反應,請前往 PlayFab 論壇。
本指南將介紹可用來為您的遊戲新增評分與評論系統的 API 呼叫。

評論項目

從用戶端呼叫 ReviewItem API,即可將評分或評論附加至項目。項目必須在公用目錄中對所有玩家可見,才能接受評論。評分與評論會附加至呼叫 API 的玩家,且每位玩家只能為一個項目建立一則評論。項目的建立者無法為自己的項目提交評論。每次呼叫 ReviewItem 時,評論都會更新。此呼叫必須提供下列資料:
  • Id:要評論之項目的唯一 ID。
  • Rating:以 1 到 5 等級表示的數值評分。
此外,也可以新增下列選用參數:
  • Title:評論的標題。
  • ReviewText:評論的自由文字欄位。
  • IsInstalled:指出評論者是否擁有該項目的旗標。
  • ItemVersion:所評論項目的版本號碼。
提交評論時,系統會自動填入並更新 Submitted 時間戳記。

取得玩家對項目的評論

您可以從用戶端呼叫 GetEntityItemReview API,以取得玩家對項目的評論。必須提供項目的 Id 或 AlternateId。系統會傳回與該評論相關聯的特定 ReviewId。
由尚未撰寫評論的玩家呼叫 GetEntityItemReview 時,會傳回值皆為零的 Review 物件:

取得項目的評論

您可以呼叫 GetItemReviews API,存取項目所有包含文字的評論。必須提供項目的 Id 或 AlternateId。可以新增下列選用參數:
  • ContinuationToken:用來擷取下一頁項目 (如果有) 的不透明權杖。
  • Count:要擷取的項目數。頁面大小上限為 200。如果未指定,預設為 10。
  • OrderBy:用來排序查詢結果的 OData orderBy。可能的值為 Helpfulness、Rating 和 Submitted。

提交評論的實用性投票

玩家可以呼叫 SubmitItemReviewVote API,提交評論的實用性投票。提交新的實用性投票時,會依據 Vote 參數的布林值遞增 HelpfulPositive 或 HelpfulNegative。

檢舉評論

玩家可以從用戶端呼叫 ReportItemReview API 來檢舉評論。必須提供 ReviewId。可以新增選用的 ConcernCategory 參數。
如果未指定,ConcernCategory 預設為 None。有效的 ConcernCategory 值如下:
  • None
  • OffensiveContent
  • ChildExploitation
  • MalwareOrVirus
  • PrivacyConcerns
  • MisleadingApp
  • PoorPerformance
  • ReviewResponse
  • SpamAdvertising
  • Profanity
呼叫 ReportItemReview 只會引發事件名稱為 item_reported 的 PlayStream 事件。請使用 Game Manager 中的資料總管進行查詢。範例查詢如下: 下列查詢會傳回過去 3 天內每個 ItemId 依 ConcernCategory 分類的檢舉總數

下架評論

您可以使用 TakedownItemReviews API 提交下架一或多則評論的要求。此 API 只能由遊戲實體呼叫。此呼叫會接受一組要下架的評論。
由於要求處理的關係,評論可能最多需要 24 小時才會下架

評分設計與快取

我們提供兩種取得評分的方法。兩種途徑的差異在於您是直接與評論互動,還是與目錄項目互動。
  1. 我們直接提供評分 (透過 GetItemReviews 等)
  2. 我們在目錄項目中提供評分彙總 (透過 SearchItems 等)
這兩種途徑都是非同步的,且具有必須了解的時間延遲。

直接評分 (GetItemReviews 等)

所有這些評分與評論都會直接提供。這裡有兩種延遲類別。
  1. 個別評論 - 近乎即時
    個別評論不會立即可用,但應會在幾秒內出現。我們預期以退避方式重試即足以讀取全新的評論。
  2. 彙總評分 - 15 分鐘以內 彙總有快取

目錄項目評分 (SearchItems 等)

所有這些評分都會作為我們已發佈目錄中目錄項目的一部分提供。
  1. 彙總評分 - 8 小時以內
    系統會彙總評分,並將更新推送至目錄。更新可能需要 4 到 8 小時。
最後修改於 2026年10月6日