食譜 (Recipe、HowTo、ItemList) 結構化資料

URL 或 ImageObject

完成菜餚的圖片。

其他圖片規範：

• 圖片網址必須可供檢索和建立索引。如要測試 Google 能否存取您的網址，請使用網址檢查工具。
• 圖片內容與您標記的內容必須相符。
• 圖片檔案必須使用 Google 圖片支援的格式。
• 為了獲得最佳結果，建議您使用以下長寬比，提供多張高解析度圖片 (寬度和高度相乘時至少 50K 像素)：16x9、4x3 和 1x1。

例如：

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]

Text

菜餚的名稱。

AggregateRating

表示項目所獲得平均評分的屬性。請遵循評論摘錄規範，以及必要和建議的 AggregateRating 屬性清單。

如果 Recipe 結構化資料包含單一評論，則評論者的名稱必須是有效的個人或機構組織。舉例來說，「食材半價」即不是有效的評論者名稱。

Person 或 Organization

撰寫食譜的人員姓名或機構的名稱。為了讓 Google 更瞭解不同內容的作者，建議您遵循作者標記最佳做法。

Duration

實際烹調菜餚花費的時間，採 ISO 8601 格式 (如適用)。

一律與 prepTime 搭配使用。

Date

食譜的發布日期，採 ISO 8601 格式 (如適用)。

Text

簡短的菜餚介紹。

Text

有關食譜的其他字詞，例如季節 (「夏天」)、節日 (「萬聖節」) 或其他描述形容詞 (「快速」、「簡易」、「道地」)。

其他規範

• 使用逗號分隔關鍵字清單中的多個項目。
• 請勿使用其實是 recipeCategory 或 recipeCuisine 的標記。
  

  不建議使用：

  "keywords": "dessert, American"

  建議使用：

  "keywords": "winter apple pie, nutmeg crust"

Energy

由這份食譜製作的料理中所含的卡路里數。如果已定義 nutrition.calories，則 recipeYield 須以料理的數量來定義。

Duration

前置備料加上準備工作空間所需的時間長度，採 ISO 8601 格式 (如適用)。

一律與 cookTime 搭配使用。

Text

食譜適合當做哪一餐或適合當做主菜/開胃菜/配菜類。例如：「晚餐」、「主菜」或「甜點」、「零食」。

Text

食譜所介紹的是哪個地區的料理。例如：「法國」、「地中海」或「美國」。

Text

食譜使用的食材。

例如：

"recipeIngredient": [
  "1 (15 ounce) package double crust ready-to-use pie crust",
  "6 cups thinly sliced, peeled apples (6 medium)",
  "3/4 cup sugar",
  "2 tablespoons all-purpose flour",
  "3/4 teaspoon ground cinnamon",
  "1/4 teaspoon salt",
  "1/8 teaspoon ground nutmeg",
  "1 tablespoon lemon juice"
]

其他指南：

• 僅包含製作食品所需的食材文字。
• 請勿加入非必要的資訊，例如食材的定義。

HowToStep、HowToSection 或 Text

菜餚烹調步驟。

以下提供幾種設定 recipeInstructions 值的方式。為求明確，我們建議您使用 HowToStep。食譜有其他區段時，也可使用 HowToSection 將 HowToStep 分組。

• HowToStep：使用 HowToStep 指定這份食譜的烹調步驟。

  "recipeInstructions": [
    {
      "@type": "HowToStep",
      "name": "Preheat",
      "text": "Heat oven to 425°F.",
      "url": "https://example.com/recipe#step1",
      "image": "https://example.com/photos/recipe/step1.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Prepare crust",
      "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom.",
      "url": "https://example.com/recipe#step2",
      "image": "https://example.com/photos/recipe/step2.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Make filling",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate.",
      "url": "https://example.com/recipe#step3",
      "image": "https://example.com/photos/recipe/step3.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Cover",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust.",
      "url": "https://example.com/recipe#step4",
      "image": "https://example.com/photos/recipe/step4.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Bake",
      "text": "Bake 40 to 45 minutes. The pie is ready when the apples are tender and the crust is golden brown.",
      "url": "https://example.com/recipe#step5",
      "image": "https://example.com/photos/recipe/step5.jpg"
    }, {
      "@type": "HowToStep",
      "name": "Cool",
      "text": "Cool on cooling rack at least 2 hours before serving.",
      "url": "https://example.com/recipe#step6",
      "image": "https://example.com/photos/recipe/step6.jpg"
    }
  ]

• HowToSection (僅適用於分成多個區段的食譜)：用於將步驟分組為多個區段。如需範例，請參閱 HowToSection。
• 單一或重複的文字屬性：包含一或多個步驟的文字區塊。Google 會將所有步驟視為一個區段，並將重複的屬性值串連為單一文字區塊。接著 Google 會嘗試自動將單一文字區塊分成個別的步驟。Google 會嘗試尋找並移除區段名稱、步驟編號、關鍵字，以及可能以錯誤方式顯示於食譜步驟文字中的其他任何內容。為獲得最佳結果，建議您使用 HowToStep 明確指定步驟。

  "recipeInstructions": [
    "In large bowl, gently mix filling ingredients; spoon into crust-lined pie
  plate. Top with second crust. Cut slits or shapes in several places in top
  crust. Bake 40 to 45 minutes. The pie is ready when the or until apples are
  tender and the crust is golden brown. Cool on cooling rack at least 2 hours
  before serving."
  ]

其他規範

• 請勿加入屬於其他位置的中繼資料。具體來說，請使用 author 屬性指定作者、使用 recipeCuisine 指定料理種類、使用 recipeCategory 指定類別，並使用 keywords 指定其他關鍵字。
• 您只能加入如何製作食譜的相關文字，請不要加入「指示」、「觀看影片」、「步驟 1」等其他文字，因為這些詞組不應列在結構化資料中。

  不建議使用：

  "recipeInstructions": [{
    "@type": "HowToStep",
    "text": "Step 1. Heat oven to 425°F."
  }]

  建議使用：

  "recipeInstructions": [{
    "@type": "HowToStep",
    "text": "Heat oven to 425°F."
  }]

Text 或 Integer

按照食譜可烹調出的份量 (如適用)。指定這道食譜可製作幾人份的料理。只能使用數字，如果想使用其他單位 (例如幾「個」)，您也可以加入其他份量單位。如果您為每人份的菜餚指定了任何營養資訊 (例如 nutrition.calories)，就必須提供這項資訊。

範例

"recipeYield": [
  "6",
  "24 cookies"
]

Duration

前置備料加上實際烹調所需的總時間長度，採 ISO 8601 格式 (如適用)。

請使用 totalTime，或同時使用 cookTime 和 prepTime。

說明菜餚烹調步驟的影片。接在必要和建議的影片屬性清單之後。

這個區段和/或子區段的詳細步驟清單。比方說，在一份披薩食譜中，製作外皮、準備配料以及搭配組合和烘焙等步驟可能分別屬於三個不同區段。

範例：

{
  "@type": "HowToSection",
  "name": "Assemble the pie",
  "itemListElement": [
    {
      "@type": "HowToStep",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate."
    }, {
      "@type": "HowToStep",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust."
    }
  ]
}

環節名稱。

詳細子步驟清單，包括指示或提示。

如果已使用 text，這個屬性則變成選用屬性。

這個步驟的指示全文。

如果已使用 itemListElement，這個屬性則變成選用屬性。其他規範：

• 只能加入操作說明文字，不可包含「指引」、「觀看影片」、「步驟 1」等其他文字，因為這些詞組不應列在已加上標記的屬性中。
  

  不建議使用：

  {
    "@type": "HowToStep",
    "text": "Step 1. Heat oven to 425°F."
  }

  建議使用：

  {
    "@type": "HowToStep",
    "text": "Heat oven to 425°F."
  }

步驟圖片。其他圖片規範：

• 圖片網址必須可供檢索和建立索引。
• 圖片必須代表加上標記的內容。
• 圖片必須採 .jpg、.png 或 .gif 格式。

說明步驟摘要的文字或詞組，例如「排列派皮」。請勿使用非敘述性的文字 (例如「步驟 1：<文字>」) 或其他形式的步驟編號 (例如「1. <文字>」)。

步驟的直接連結 URL (如果有的話)，例如錨定連結片段。

這個步驟的影片或影片片段。

如要使用 VideoObject，請遵循必要和建議的影片或剪輯屬性清單。

指示或提示文字。

ListItem

單一項目頁面的註解。

Integer

項目頁面在清單中的序數位置。例如：

"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]

URL

項目頁面的標準網址。每個項目都必須有一個專屬網址。