概览

订购端到端数据 Feed 的结构由关系型商品目录架构定义。订购端到端数据 Feed 由以下顶级实体组成:

下图展示了 ServiceRestaurantMenu 实体如何表示单个餐厅:

餐厅服务菜单类关系图
图 1:订餐端到端数据 Feed 实体(服务、餐厅和菜单)的整体关系。

常规指南

  • 每个文件包含的餐厅数量:每个数据文件应代表一家餐厅及其相关的 ServiceMenu 实体。使用有助于您搜索餐厅文件的文件名。

  • 数据文件格式:数据文件的格式应为以换行符分隔的 JSON 文件(ndjson 格式)。

  • 日期时间和时间值:对于需要 DateTimeTime 值的媒体资源,请使用日期时间和时间格式中指定的格式。例如,2017-05-01T06:30:00+05:30 对应 DateTimeT08:08:00+05:30 对应 Time

  • ID:使用 @id 属性来标识实体类型中的所有唯一实体。长度不得超过 300 个字符。@id 是该类型实体的唯一标识符,但在不同实体之间,ID 可能会重叠。例如,假设您定义了一个 Service 实体,并将 @id 属性设置为 a16。您无法再创建 Service 实体,其 @ida16。不过,您可以将 a16 用作 Menu 实体的 @id 值。

  • ID 生成:请保持 ID 的稳定性,不要使用 UUID,也不要在上传 Feed 之间更改/随机化 ID。这样,我们就可以更轻松地为与实体相关的问题提供支持。

  • null 值:请勿使用值 null 来替代对象。如果某个对象是可选的,您必须从 Feed 中省略该对象。

客户端库

您可以使用“工具”部分中的客户端代码生成器验证您的端到端订购数据 Feed。