查看 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 否