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