メインコンテンツへスキップ

リファレンス

メニューアイテムのフィールド

メニューアイテムのフィールド

メニューアイテムのすべてのフィールドの完全なリファレンスです。必須フィールドには印が付いています。その他のフィールドはすべて任意ですが、お客様に最良の体験を提供するために入力を推奨します。

フィールド 型 必須 説明
name String はい メニューに表示される料理名。最大 200 文字。
description String いいえ 料理の短い説明。主な食材と調理法に触れてください。二〜三文を推奨します。
price Decimal はい 表示価格 (例: 14.99)。メニュー上でお客様に表示されます。
priceCents Integer 自動 セント単位で保存される価格 (例: 1499)。price フィールドから自動的に計算されます。精度を保つため内部で使用されます。
category String いいえ このアイテムが属するカテゴリ (例: 「前菜」「メイン」「デザート」)。公開メニューでアイテムをグループ化するために使用されます。
photoUrl URL はい アップロードされた写真の URL。アップロードと AI 処理の後に自動的に設定されます。
isActive Boolean いいえ アイテムを公開メニューに表示するかどうか。デフォルトは true です。削除せずに非表示にするには false に設定します。
position Integer いいえ アイテムのカテゴリ内での並び順。数値が小さいほど先に表示されます。position のないアイテムは作成日順に並びます。
restaurantId UUID 自動 このアイテムが属するレストラン。セッションから自動的に設定されます。
createdAt DateTime 自動 アイテムが作成された日時のタイムスタンプ。自動的に設定されます。
updatedAt DateTime 自動 最終更新日時のタイムスタンプ。保存のたびに自動的に更新されます。

3D モデルのフィールド (3D Menu Pro のみ)

3D Menu Pro をご利用の場合、各メニューアイテムには 3D モデルが関連付けられることがあり、次の追加フィールドを持ちます。

フィールド 型 説明
modelUrl URL 最適化された GLB モデルファイルの URL。処理の完了後に設定されます。
status Enum 処理ステータス: PENDING、GENERATING、PROCESSING、READY、または FAILED。
provider String 3D 生成に使用された AI プロバイダー。
providerTaskId String 3D 生成プロバイダーの外部タスク ID。ステータスのポーリングに使用されます。