FoodMenus

供應餐點的商家菜單。

JSON 表示法
{
  "name": string,
  "menus": [
    {
      object (FoodMenu)
    }
  ]
}
欄位
name

string

必要欄位。這個地點的 Google ID,格式為:accounts/{accountId}/locations/{locationId}/foodMenus

menus[]

object (FoodMenu)

選用設定。一系列食物菜單。

FoodMenu

供應餐點的商家菜單。

JSON 表示法
{
  "labels": [
    {
      object (MenuLabel)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (FoodMenuSection)
    }
  ],
  "cuisines": [
    enum (Cuisine)
  ]
}
欄位
labels[]

object (MenuLabel)

必要欄位。選單的語言標記標籤。例如「菜單」、「午餐特餐」。顯示名稱的長度不得超過 140 個半形字元,說明不得超過 1,000 個半形字元。至少須指定一組標籤。

sourceUrl

string

選用設定。有要前往的選單來源網址。

sections[]

object (FoodMenuSection)

必要欄位。選單的各個部分。

cuisines[]

enum (Cuisine)

選用設定。餐點菜單料理資訊。強烈建議您提供這個欄位。

FoodMenuSection

選單部分。當中可能包含多項商品/食物。

JSON 表示法
{
  "labels": [
    {
      object (MenuLabel)
    }
  ],
  "items": [
    {
      object (FoodMenuItem)
    }
  ]
}
欄位
labels[]

object (MenuLabel)

必要欄位。這個選單區的語言標記標籤。顯示名稱的長度不得超過 140 個半形字元,說明不得超過 1,000 個半形字元。至少須指定一組標籤。

items[]

object (FoodMenuItem)

必要欄位。章節項目。每個版面至少要有一個項目。

FoodMenuItem

章節項目。這可以是料理本身,也可以包含多個 FoodMenuItemOption。

JSON 表示法
{
  "labels": [
    {
      object (MenuLabel)
    }
  ],
  "attributes": {
    object (FoodMenuItemAttributes)
  },
  "options": [
    {
      object (FoodMenuItemOption)
    }
  ]
}
欄位
labels[]

object (MenuLabel)

必要欄位。這個選單項目的語言標記標籤。顯示名稱的長度不得超過 140 個半形字元,說明不得超過 1,000 個半形字元。至少須指定一組標籤。

attributes

object (FoodMenuItemAttributes)

必要欄位。商品的詳細屬性。指定商品選項後,系統會將其視為基本屬性,並填入各個選項。

options[]

object (FoodMenuItemOption)

選用設定。這個選項適用於提供多個不同選項的商品,使用者必須做出選擇。例如「一般」和「大」披薩。指定選項後,項目層級的標籤和屬性會自動成為第一個選項的標籤和屬性。客戶只需要在此欄位中指定其他食物選項。

FoodMenuItemAttributes

食品/甜點的屬性。

JSON 表示法
{
  "price": {
    object (Money)
  },
  "spiciness": enum (Spiciness),
  "allergen": [
    enum (Allergen)
  ],
  "dietaryRestriction": [
    enum (DietaryRestriction)
  ],
  "nutritionFacts": {
    object (NutritionFacts)
  },
  "ingredients": [
    {
      object (Ingredient)
    }
  ],
  "servesNumPeople": integer,
  "preparationMethods": [
    enum (PreparationMethod)
  ],
  "portionSize": {
    object (PortionSize)
  },
  "mediaKeys": [
    string
  ]
}
欄位
price

object (Money)

必要欄位。食物的價格。

spiciness

enum (Spiciness)

選用設定。食物的辣度水平。

allergen[]

enum (Allergen)

選用設定。與食物相關的過敏原。強烈建議您提供這個欄位。

dietaryRestriction[]

enum (DietaryRestriction)

選用設定。食物的飲食資訊。強烈建議您提供這個欄位。

nutritionFacts

object (NutritionFacts)

選用設定。食物選項的營養資訊。強烈建議您提供這個欄位。

ingredients[]

object (Ingredient)

選用設定。餐點選擇的食材。

servesNumPeople

integer

選用設定。這個餐點選項可供應人數。

preparationMethods[]

enum (PreparationMethod)

選用設定。餐點選項準備方法。

portionSize

object (PortionSize)

選用設定。訂單大小,以商品單位表示。(例如 4 個「肉串」、6 件「罐子」)

mediaKeys[]

string

選用設定。菜餚相關媒體的媒體鍵。僅支援相片媒體,如果有多個相關相片,系統會將第一張相片視為首選相片。

辣度

食品的辣度。

列舉
SPICINESS_UNSPECIFIED 未指定等級
MILD 輕微辣度的象徵。
MEDIUM 中度鼓勵。
HOT 表示熱辣。最高最高峰。

過敏原

食品的過敏資訊。

列舉
ALLERGEN_UNSPECIFIED 未指定過敏原
DAIRY 乳製品相關的過敏原
EGG 蛋相關的過敏原
FISH 魚類的過敏原
PEANUT 花生相關的過敏原
SHELLFISH 貝類相關過敏原
SOY 大豆相關過敏原
TREE_NUT 樹木堅果相關的過敏原
WHEAT 小麥相關過敏原

DietaryRestriction

食品的飲食資訊。

列舉
DIETARY_RESTRICTION_UNSPECIFIED 未指定飲食類型
HALAL 將食物定義為清真料理。
KOSHER 以猶太料理的形式呈現。
ORGANIC 將食物描述為有機料理。
VEGAN 將食物定義為純素餐點。
VEGETARIAN 將食物定義為素食料理。

NutritionFacts

這則訊息代表食物的營養成分。

JSON 表示法
{
  "calories": {
    object (CaloriesFact)
  },
  "totalFat": {
    object (NutritionFact)
  },
  "cholesterol": {
    object (NutritionFact)
  },
  "sodium": {
    object (NutritionFact)
  },
  "totalCarbohydrate": {
    object (NutritionFact)
  },
  "protein": {
    object (NutritionFact)
  }
}
欄位
calories

object (CaloriesFact)

選用設定。菜餚的卡路里。

totalFat

object (NutritionFact)

選用設定。特定食物的脂肪資訊。

cholesterol

object (NutritionFact)

選用設定。特定食物的膽固醇資訊。

sodium

object (NutritionFact)

選用設定。特定食物的鈉資訊。

totalCarbohydrate

object (NutritionFact)

選用設定。特定食物的碳水化合物資訊。

protein

object (NutritionFact)

選用設定。特定食物的蛋白質資訊。

CaloriesFact

此訊息表示卡路里資訊,使用範圍上限和下限。必須指定較低的金額。下限與上限皆為非負數。

JSON 表示法
{
  "lowerAmount": integer,
  "upperAmount": integer,
  "unit": enum (EnergyUnit)
}
欄位
lowerAmount

integer

必要欄位。卡路里較少

upperAmount

integer

選用設定。卡路里上限

unit

enum (EnergyUnit)

必要欄位。指定卡路里資訊的單位。

EnergyUnit

可能的食物能量單位 (卡路里)。

列舉
ENERGY_UNIT_UNSPECIFIED 未指定能源單位
CALORIE 卡路里
JOULE 焦耳

NutritionFact

此訊息表示營養資訊,包含上限和下限範圍,能以質量單位表示。必須指定較低的金額。下限與上限皆為非負數。

JSON 表示法
{
  "lowerAmount": number,
  "upperAmount": number,
  "unit": enum (MassUnit)
}
欄位
lowerAmount

number

必要欄位。營養量較低

upperAmount

number

選用設定。營養含量上限

unit

enum (MassUnit)

必要欄位。特定營養資訊的單位。

MassUnit

可能的質量單位。

列舉
MASS_UNIT_UNSPECIFIED 未指定質量單位
GRAM Gram
MILLIGRAM 毫克

食材

這則訊息代表食物的食材資訊。

JSON 表示法
{
  "labels": [
    {
      object (MenuLabel)
    }
  ]
}
欄位
labels[]

object (MenuLabel)

必要欄位。用於說明食材的標籤。顯示名稱的長度不得超過 140 個半形字元,說明不得超過 1,000 個半形字元。至少須指定一組標籤。

PreparationMethod

食物的製備方式。

列舉
PREPARATION_METHOD_UNSPECIFIED 未指定準備方法
BAKED 烘焙法
BARBECUED 烤肉方法
BASTED 烘焙法
BLANCHED 傾斜法
BOILED 沸化方法
BRAISED 宣揚法務
CODDLED 已編碼的方法
FERMENTED 發酵方法
FRIED 收尾法
GRILLED 燒烤方法
KNEADED Kneaded 方法
MARINATED 邊界方法
PAN_FRIED 平移方法
PICKLED 所選方法
PRESSURE_COOKED 施壓加壓方式
ROASTED 旋轉方法
SAUTEED 理想方法
SEARED 密封方法
SIMMERED 模擬方法
SMOKED 煙燻方法
STEAMED 蒸汽化方法
STEEPED 陡峭的方法
STIR_FRIED 熱炒
OTHER_METHOD 其他方式

PortionSize

餐點份量大小。

JSON 表示法
{
  "quantity": integer,
  "unit": [
    {
      object (MenuLabel)
    }
  ]
}
欄位
quantity

integer

必要欄位。段落的數量。

unit[]

object (MenuLabel)

必要欄位。重複的 nameInfo 欄位適用於多種語言的單位。

FoodMenuItemOption

商品的選項。必須明確選取使用者。

JSON 表示法
{
  "labels": [
    {
      object (MenuLabel)
    }
  ],
  "attributes": {
    object (FoodMenuItemAttributes)
  }
}
欄位
labels[]

object (MenuLabel)

必要欄位。這個選單項目選項的語言標記標籤。E.g.: 「牛肉麵」、「素食河粉」、「小披薩」、「大披薩」。顯示名稱的長度不得超過 140 個半形字元,說明不得超過 1,000 個半形字元。至少須指定一組標籤。

attributes

object (FoodMenuItemAttributes)

必要欄位。商品選項的詳細屬性。未指定的個別屬性則會繼承商品層級的屬性,但屬性為基本屬性。

料理

餐廳的飲食資訊。

列舉
CUISINE_UNSPECIFIED 未指定料理
AMERICAN 美式餐廳
ASIAN 亞洲料理
BRAZILIAN 巴西料理
BREAK_FAST 早餐
BRUNCH 早午餐
CHICKEN
CHINESE 中式餐點
FAMILY 家庭式料理
FAST_FOOD 速食
FRENCH 法式餐廳
GREEK 希臘料理
GERMAN 德國料理
HAMBURGER 漢堡
INDIAN 印度餐廳
INDONESIAN 印尼料理
ITALIAN 義式餐廳
JAPANESE 日式餐廳
KOREAN 韓式餐廳
LATIN_AMERICAN 拉丁美洲餐廳
MEDITERRANEAN 地中海料理
MEXICAN 墨西哥餐廳
PAKISTANI 巴基斯坦料理
PIZZA 披薩
SEAFOOD 海鮮
SPANISH 西班牙料理
SUSHI 壽司
THAI 泰式料理
TURKISH 土耳其料理
VEGETARIAN 素食料理
VIETNAMESE 越南料理
OTHER_CUISINE 其他美食