概览

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

下图显示了 ServiceRestaurantMenu 实体如何表示一家餐馆:

餐馆服务菜单类关系图
图 1:订购端到端数据 Feed 实体(Service、Restaurant 和 Menu)的总体关系。

通用指南

  • 每个文件中的餐馆数量:每个数据文件应表示一家餐馆及其相关的 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。您不能创建另一个 @ida16Service 实体。但是,您可以将 a16 用作 Menu 实体的 @id 值。

  • ID 生成:保持 ID 稳定,不要在 Feed 上传之间使用 UUID 或以其他方式更改/随机化 ID。这样可以更轻松地支持实体相关问题。

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

客户端库

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