概要

オーダーのエンドツーエンド データフィードの構造は、リレーショナル在庫スキーマで定義されます。Ordering End-to-End データフィードは、次の最上位エンティティで構成されています。

次の図は、ServiceRestaurantMenu の各エンティティが 1 つのレストランをどのように表すかを示しています。

レストラン サービス メニュー クラスの関係図
図 1: 注文エンドツーエンド データフィード エンティティ(サービス、レストラン、メニュー)の全体的な関係。

全般的なガイドライン

  • ファイルあたりのレストラン数: 各データファイルは 1 つのレストランを表し、関連する Service エンティティと Menu エンティティを含める必要があります。レストランを検索するときに わかりやすいファイル名を使用します

  • データファイル形式: データファイルは、改行区切りの JSON ファイル(ndjson 形式)にする必要があります。

  • DateTime と Time の値: DateTime または Time の値を必要とするプロパティでは、DateTime と Time の形式で指定されている形式を使用します。たとえば、DateTime2017-05-01T06:30:00+05:30TimeT08:08:00+05:30 です。

  • ID: @id プロパティは、エンティティ タイプ内のすべての一意のエンティティを識別するために使用します。最大文字数は 300 文字です。@id は、そのタイプのエンティティの一意の識別子ですが、エンティティ間で ID が重複することがあります。たとえば、@id プロパティを a16 に設定して Service エンティティを定義するとします。@ida16 の別の Service エンティティを作成することはできません。ただし、Menu エンティティの @id 値として a16 を使用できます。

  • ID の生成: ID を安定させます。UUID を使用したり、フィードのアップロード後に ID を変更したりランダム化したりしないでください。これにより、エンティティ関連の問題のサポートが容易になります。

  • null 値: オブジェクトの代わりに値 null を使用しないでください。省略可能なオブジェクトはフィードから除外する必要があります。

クライアント ライブラリ

[ツール] セクションのクライアント コード生成ツールを使用すると、注文に関するエンドツーエンドのデータフィードを検証できます。