订购端到端数据 Feed 的结构由关系型商品目录架构定义。订购端到端数据 Feed 由以下顶级实体组成:
Restaurant
实体:您为哪些餐厅提供服务。Service
实体:服务的时间、地点和条件。Menu
实体:每家餐厅菜单的详细信息。
下图展示了 Service
、Restaurant
和 Menu
实体如何表示单个餐厅:
常规指南
每个文件包含的餐厅数量:每个数据文件应代表一家餐厅及其相关的
Service
和Menu
实体。使用有助于您搜索餐厅文件的文件名。数据文件格式:数据文件的格式应为以换行符分隔的 JSON 文件(ndjson 格式)。
日期时间和时间值:对于需要
DateTime
或Time
值的媒体资源,请使用日期时间和时间格式中指定的格式。例如,2017-05-01T06:30:00+05:30
对应DateTime
,T08:08:00+05:30
对应Time
。ID:使用
@id
属性来标识实体类型中的所有唯一实体。长度不得超过 300 个字符。@id
是该类型实体的唯一标识符,但在不同实体之间,ID 可能会重叠。例如,假设您定义了一个Service
实体,并将@id
属性设置为a16
。您无法再创建Service
实体,其@id
为a16
。不过,您可以将a16
用作Menu
实体的@id
值。ID 生成:请保持 ID 的稳定性,不要使用 UUID,也不要在上传 Feed 之间更改/随机化 ID。这样,我们就可以更轻松地为与实体相关的问题提供支持。
null 值:请勿使用值
null
来替代对象。如果某个对象是可选的,您必须从 Feed 中省略该对象。
客户端库
您可以使用“工具”部分中的客户端代码生成器验证您的端到端订购数据 Feed。