端到端订购数据 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
。您不能创建另一个@id
为a16
的Service
实体。但是,您可以将a16
用作Menu
实体的@id
值。ID 生成:保持 ID 稳定,不要在 Feed 上传之间使用 UUID 或以其他方式更改/随机化 ID。这样可以更轻松地支持实体相关问题。
Null 值:请勿使用值
null
代替对象。如果某个对象是可选的,则必须从 Feed 中省略。
客户端库
“工具”部分中的客户端代码生成器可用于验证您的订购端到端数据 Feed。