Economy v2 現已正式推出。如需支援與意見反應,請前往 PlayFab 論壇。
評論項目
從用戶端呼叫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 值如下:
NoneOffensiveContentChildExploitationMalwareOrVirusPrivacyConcernsMisleadingAppPoorPerformanceReviewResponseSpamAdvertisingProfanity
ReportItemReview 只會引發事件名稱為 item_reported 的 PlayStream 事件。請使用 Game Manager 中的資料總管進行查詢。範例查詢如下:
下列查詢會傳回過去 3 天內每個 ItemId 依 ConcernCategory 分類的檢舉總數
下架評論
您可以使用TakedownItemReviews API 提交下架一或多則評論的要求。此 API 只能由遊戲實體呼叫。此呼叫會接受一組要下架的評論。
由於要求處理的關係,評論可能最多需要 24 小時才會下架
評分設計與快取
我們提供兩種取得評分的方法。兩種途徑的差異在於您是直接與評論互動,還是與目錄項目互動。- 我們直接提供評分 (透過
GetItemReviews等) - 我們在目錄項目中提供評分彙總 (透過
SearchItems等)
直接評分 (GetItemReviews 等)
所有這些評分與評論都會直接提供。這裡有兩種延遲類別。- 個別評論 - 近乎即時
個別評論不會立即可用,但應會在幾秒內出現。我們預期以退避方式重試即足以讀取全新的評論。 - 彙總評分 - 15 分鐘以內 彙總有快取
目錄項目評分 (SearchItems 等)
所有這些評分都會作為我們已發佈目錄中目錄項目的一部分提供。- 彙總評分 - 8 小時以內
系統會彙總評分,並將更新推送至目錄。更新可能需要 4 到 8 小時。
