メニューアイテムのフィールド
メニューアイテムのすべてのフィールドの完全なリファレンスです。必須フィールドには印が付いています。その他のフィールドはすべて任意ですが、お客様に最良の体験を提供するために入力を推奨します。
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
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。ステータスのポーリングに使用されます。 |