查看 Feed

查看 Feed 语义

评价 Feed 的语义略有不同:

对于评价概况 Feed:

  • 如果评价 Feed 中的任何服务提供商当前不存在于 LSA 服务提供商数据库中,则不会提取该服务提供商的评价。
  • 如果评价 Feed 中的任何服务提供商目前存在于 LSA 提供商数据库中,则该提供商的评价将按如下方式处理:
    • 对于 Feed 中的任何评价,如果 LSA 存储空间中不存在相应评价,则应创建该评价。
    • 对于 Feed 中的任何评价,如果 LSA 存储空间中存在相应评价,则该评价将使用新信息进行更新。
    • 对于 Feed 中未包含的任何评价,如果 LSA 存储空间中存在相应评价,则该评价将被删除。
  • 如果任何服务提供商不在评价 Feed 中,但目前存在于 LSA 提供商数据库中,则其评价将被删除,并且该提供商将停止提供服务。
  • 请注意,评价数量为 0 的提供商也应在评价 Feed 中有一个条目(而不是被省略),以便他们提供服务(请参阅评价 Feed 示例 - listingId 2)

请注意,评价 Feed 不支持增量更新。每个商家资料 Feed 都需要有相应的评价 Feed。

评价方面的错误处理

如果某个评价 FeedItem 无效,我们会跳过对该 FeedItem 的处理,继续处理其余有效的 FeedItem。

如果评价 Feed 无效(例如不符合架构),我们将停止处理整个评价 Feed。

查看字段

字段名称 类型 说明 示例 必需 限制条件
serviceProviderId 数值 房源(服务提供商)的唯一标识符 12345 必须适合 int64
ratingCount 整数 经过验证的消费者评分数量 10 必须大于或等于零。
作者 字符串 评价的作者名称 “Jack L.”
reviewId 字符串 评价的唯一 ID。如果每条评价没有唯一的 ID,则需要第三方为每条评价生成唯一的 ID(例如评价文本和用户的哈希值),至少在来自同一提供商的所有评价中是唯一的。 “123”
reviewText 字符串 作者撰写的评价文字 “做得好!”
评分 整数 评分(必须是介于 1 到 5 之间的整数) 4 必须是介于 1 到 5 之间的整数。
serviceLocationCity 字符串 提供服务的城市 “纽约”
reviewTimestampMicros 整数 撰写评价时的时间戳,以微秒格式表示。 1.45142E+15
serviceTimestampMicros 整数 服务完成的时间戳(以微秒为单位)。 1.45132E+15
language 字符串 评价文本的语言,采用 ISO 639-1 语言代码(小写,2 个字母)。必须与提供商的定位语言一致。 “en” 必须与关联提供商指定的定位语言一致。如果未指定,则默认为“en”。
类别 对象 类别结构
category->categoryId 枚举 服务的类别(在 LSA 类目中) “garage_door_pro”
category->task 枚举 服务(在 LSA 分类中)的作业类型(任务) “修理车库门”
confirmedCustomer 布尔值 如果评价来自已确认的客户(有潜在客户) TRUE