概览

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

• Restaurant 实体：您为哪些餐厅提供服务。
• Service 实体：服务的时间、地点和条件。
• Menu 实体：每家餐厅菜单的详细信息。

下图展示了 Service、Restaurant 和 Menu 实体如何表示单个餐厅：

图 1：订餐端到端数据 Feed 实体（服务、餐厅和菜单）的整体关系。

注意 ：如需了解如何为 Feed 生成客户端库，请参阅“工具”页面的生成客户端库部分。

常规指南

• 每个文件包含的餐厅数量：每个数据文件应代表一家餐厅及其相关的 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。