Skip to main content
Economy v2 现已正式发布。如需支持和反馈,请访问 PlayFab 论坛
本指南将介绍可用于向你的游戏添加评分和评论系统的 API 调用。

评价物品

可以通过从客户端调用 ReviewItem API 来将评分或评论附加到物品。为了让物品可以被评论,它必须在公共目录中对所有玩家可见。评分和评论会附加到调用 API 的玩家身上,且每个玩家只能对一个物品关联一个评论。物品的创建者不能为自己的物品提交评论。每次调用 ReviewItem 时评论都会更新。以下数据是调用必需的
  • Id:要评论的物品的唯一 ID。
  • Rating15 范围的数字评分。
此外,还可以添加可选参数:
  • Title:评论的标题。
  • ReviewText:评论的自由文本字段。
  • IsInstalled:一个标志,指示评论者是否拥有该物品。
  • ItemVersion:所评论物品的版本号。
提交评论时,Submitted 时间戳会自动填充和更新。

获取玩家对物品的评论

你可以通过从客户端调用 GetEntityItemReview API 来获取玩家对物品的评论。必须提供物品的 IdAlternateId。将返回与评论相关联的特定 ReviewId
从未做过评论的玩家调用 GetEntityItemReview 会返回一个值为零的 Review 对象:

获取物品的评论

你可以通过调用 GetItemReviews API 访问物品的所有包含文本的评论。必须提供物品的 IdAlternateId。可以添加可选参数:
  • ContinuationToken:一个不透明令牌,用于检索下一页物品(如有)。
  • Count:要检索的物品数。最大页面大小为 200。如果未指定,默认为 10。
  • OrderBy:用于对查询结果进行排序的 OData orderBy。可能的值为 HelpfulnessRatingSubmitted

为评论提交有用性投票

玩家可以通过调用 SubmitItemReviewVote API 为评论提交有用性投票。提交新的有用性投票将根据 Vote 参数的布尔值增加 HelpfulPositiveHelpfulNegative

举报评论

玩家可以通过从客户端调用 ReportItemReview API 来举报评论。必须提供 ReviewId。可以添加可选ConcernCategory 参数。
如果未指定,ConcernCategory 将默认为 None。有效的 ConcernCategory 值如下:
  • None
  • OffensiveContent
  • ChildExploitation
  • MalwareOrVirus
  • PrivacyConcerns
  • MisleadingApp
  • PoorPerformance
  • ReviewResponse
  • SpamAdvertising
  • Profanity
调用 ReportItemReview 仅会在事件名 item_reported 下触发一个 PlayStream 事件。使用 Game Manager 中的 Data Explorer 进行查询。示例查询如下: 以下查询返回过去 3 天内每个 ItemId 按 ConcernCategory 的举报总数

下架评论

你可以使用 TakedownItemReviews API 提交下架一个或多个评论的请求。此 API 只能由 title entity 调用。此调用接受一组要下架的评论。
由于请求处理,评论下架可能会有长达 24 小时的延迟。

评分设计和缓存

我们有两种获取评分的方法。两条路径的区别在于你是直接与评论交互还是与目录物品交互。
  1. 我们直接提供评分(通过 GetItemReviews 等)
  2. 我们在目录物品中提供评分聚合(通过 SearchItems 等)
两个路径都是异步的,并且有需要理解的时间延迟。

直接评分 (GetItemReviews 等)

所有这些评分和评论都是直接提供的。这里有两类延迟。
  1. 单个评论 - 近实时
    单个评论不会立即可用,但应在几秒钟内出现。我们预计使用退避机制重试足以读取全新的评论。
  2. 聚合评分 - 15 分钟内 聚合有一个缓存

目录物品评分 (SearchItems 等)

所有这些评分都作为目录物品的一部分从我们的已发布目录提供。
  1. 聚合评分 - 8 小时内
    系统聚合评分并将更新推送到目录。更新可能需要 4 到 8 小时。
最后修改于 2026年8月13日