數學解題工具 (`MathSolver`) 結構化資料

您可以藉由新增結構化資料來標示數學問題的題型以及特定數學題目逐步解題說明的連結，幫助學生、老師和其他人解開數學問題。以下舉例說明數學解題工具在 Google 搜尋結果中的可能外觀 (實際外觀會視情況而變動)：

$數學解題工具複合式搜尋結果範例$

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
Using a CMS? It may be easier to use a plugin that's integrated into your CMS.
Using JavaScript? Learn how to generate structured data with JavaScript.
Follow the guidelines.
Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
Note: Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it.
To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

範例

一個解題工具動作

以下是含有一個解題工具動作的數學解題工具首頁範例，其中的解題工具動作能夠解開多項式方程式和導數問題，且支援英文和西班牙文。

<html>
<head>
<title>An awesome math solver</title>
</head>
<body>
<script type="application/ld+json">
[
  {
    "@context": "https://schema.org",
    "@type": ["MathSolver", "LearningResource"],
    "name": "An awesome math solver",
    "url": "https://www.mathdomain.com/",
    "usageInfo": "https://www.mathdomain.com/privacy",
    "inLanguage": "en",
    "potentialAction": [{
      "@type": "SolveMathAction",
      "target": "https://mathdomain.com/solve?q={math_expression_string}",
      "mathExpression-input": "required name=math_expression_string",
      "eduQuestionType": ["Polynomial Equation","Derivative"]
     }],
    "learningResourceType": "Math solver"
  },
  {
    "@context": "https://schema.org",
    "@type": ["MathSolver", "LearningResource"],
    "name": "Un solucionador de matemáticas increíble",
    "url": "https://es.mathdomain.com/",
    "usageInfo": "https://es.mathdomain.com/privacy",
    "inLanguage": "es",
    "potentialAction": [{
      "@type": "SolveMathAction",
      "target": "https://es.mathdomain.com/solve?q={math_expression_string}",
      "mathExpression-input": "required name=math_expression_string",
      "eduQuestionType": ["Polynomial Equation","Derivative"]
     }],
    "learningResourceType": "Math solver"
  }
]
</script>
</body>
</html>

<html>
<head>
<title>An awesome math solver</title>
</head>
<body>
<script type="application/ld+json">
[
  {
    "@context": "https://schema.org",
    "@type": ["MathSolver", "LearningResource"],
    "name": "An awesome math solver",
    "url": "https://www.mathdomain.com/",
    "usageInfo": "https://www.mathdomain.com/privacy",
    "inLanguage": "en",
    "potentialAction": [{
      "@type": "SolveMathAction",
      "target": "https://mathdomain.com/solve?q={math_expression_string}",
      "mathExpression-input": "required name=math_expression_string",
      "eduQuestionType": ["Polynomial Equation","Derivative"]
     }],
    "learningResourceType": "Math solver"
  },
  {
    "@context": "https://schema.org",
    "@type": ["MathSolver", "LearningResource"],
    "name": "Un solucionador de matemáticas increíble",
    "url": "https://es.mathdomain.com/",
    "usageInfo": "https://es.mathdomain.com/privacy",
    "inLanguage": "es",
    "potentialAction": [{
      "@type": "SolveMathAction",
      "target": "https://es.mathdomain.com/solve?q={math_expression_string}",
      "mathExpression-input": "required name=math_expression_string",
      "eduQuestionType": ["Polynomial Equation","Derivative"]
     }],
    "learningResourceType": "Math solver"
  }
]
</script>
</body>
</html>

您可以直接對 https://es.mathdomain.com/ 加上西班牙文標記，不必和英文版的數學解題工具標記放在一起。

兩個解題工具動作

以下是含有兩個解題工具端點的數學解題工具首頁範例：其中一個端點可以解析多項式方程式，另一個端點則能解開三角方程式。這項範例的內容僅提供英文版。

<html>
<head>
<title>An awesome math solver</title>
</head>
<body>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": ["MathSolver", "LearningResource"],
  "name": "An awesome math solver",
  "url": "https://www.mathdomain.com/",
  "usageInfo": "https://www.mathdomain.com/privacy",
  "inLanguage": "en",
  "potentialAction": [{
     "@type": "SolveMathAction",
     "target": "https://mathdomain.com/solve?q={math_expression_string}",
     "mathExpression-input": "required name=math_expression_string",
     "eduQuestionType": "Polynomial Equation"
   },
   {
     "@type": "SolveMathAction",
     "target": "https://mathdomain.com/trig?q={math_expression_string}",
     "mathExpression-input": "required name=math_expression_string",
     "eduQuestionType": "Trigonometric Equation"
   }],
  "learningResourceType": "Math solver"
}
</script>
</body>
</html>

指南規範

您必須遵守以下指南規範，才能讓網頁採用數學解題工具複合式搜尋結果：

技術指南

請將 MathSolver 結構化資料加在網站的首頁。
確認 Googlebot 能夠有效檢索網站。
如果有多個不同網址都包含相同數學解題工具，請在每個網頁的標記中使用標準網址。
我們嚴禁將數學解題工具完全隱藏在登入機制或付費牆後。當使用者在 Google 上透過這項功能前往您的網站後，必須要能存取原始查詢題目的解題方法和逐步解題說明，其他內容則可以要求登入或採用付費牆。

內容指南

我們制定數學解題工具內容指南的目的，在於確保使用者能找到確實相關的學習資源。如果我們發現有內容違反這些政策，將會以適當的方式回應這些內容，包括採取專人介入處理，並從 Google 顯示的數學解題工具功能中移除您的網頁。

我們嚴禁偽裝成數學解題工具的宣傳內容，例如由聯盟計畫等第三方張貼的內容。
透過這項功能呈現數學解題工具內容時，您有責任確保內容正確無誤且品質優良。如果我們根據品質審查程序，發現您資料中的錯誤達到一定數量，可能會依照嚴重程度移除您的解題工具，直到問題解決。判斷錯誤的條件包括：
- 您的解題工具是否確實能夠解決該類型的問題。
- 解題工具所宣告的解法是否確實能解開該數學問題。

結構化資料類型定義

您必須加入內容所需要的屬性，才能以複合式搜尋結果的形式呈現。您也可以加入建議屬性，為結構化資料補充更多資訊，打造更優質的使用者體驗。

MathSolver

MathSolver 這項工具能提供逐步解法說明，協助學生、教師和其他人解決數學問題。請將 MathSolver 結構化資料用於網站首頁。

schema.org/MathSolver 內提供 MathSolver 的完整定義。

Google 支援的屬性如下：

必要屬性
`potentialAction`	`SolveMathAction` 這個動作會導向數學運算式的說明，例如逐步解題方法或圖表。 { "@type": "MathSolver", "potentialAction": [{ "@type": "SolveMathAction", "target": "https://mathdomain.com/solve?q={math_expression_string}", "mathExpression-input": "required name=math_expression_string", "eduQuestionType": "Polynomial Equation" }] }
`potentialAction.mathExpression-input`	`Text` Google 傳送至您網站的數學運算式 (例如：x^2-3x=0) 的預留位置。接著您就可以「解答」數學運算式，其中可能涉及簡化、轉換或解析特定變數。這個字串可以採用多種格式，例如 LaTeX、Ascii-Math 或是任何可透過鍵盤撰寫的數學運算式。 `mathExpression-input` 屬於加註的屬性，詳情請參閱 `Potential Actions` 頁面。在某些問題類型中，`math_expression_string` 同時代表問題類型以及問題類型的參數。以下列舉一些較為複雜的問題類型，協助您準確預測及剖析問題。導數 Google 會以下列兩種形式之一傳送 `math_expression_string`： (`math_expression`)' d/d`variable` `math_expression` Examples: `(x^2+x)'` `d/dx (x^2+x)` `d/dy y^2+y` Integrals Google will send a `math_expression_string` in one of two forms: \int `math_expression` \int_{`from`}^{`to`} `math_expression` 範例如下： `\int x^2+x` `\int_{0}^{2} x^2+x` 限制 Google 會以下列兩種形式之一傳送 `math_expression_string`： \lim `math_expression` \lim_{`variable`\rightarrow`value`} `math_expression` 範例如下： `\lim_{x\rightarrow0} sin(x)/x` `\lim_{y\rightarrow\infty} sin(y)/y` `\lim sin(x)/x`
`url`	`URL` `MathSolver` 的網址。
`usageInfo`	`URL` 您的數學問題解題網站所適用的隱私權政策。 { "@type": "MathSolver", "usageInfo": "https://www.mathdomain.com/privacy" }
`potentialAction.target`	`EntryPoint` 點擊動作的網址目標進入點。您在 `potentialAction.target` 屬性值使用的字串，代表點擊動作要解決的數學運算式。 { "@type": "MathSolver", "potentialAction": [{ "@type": "SolveMathAction", "target": "https://mathdomain.com/solve?q={math_expression_string}" }] }

建議屬性

建議屬性
`inLanguage`	`Text` 數學問題解題網站所支援的語言。如要查看可支援的語言清單，請參閱這份表格。 { "@type": "MathSolver", "inLanguage": "es" }
`assesses`	問題類型定義的 `Text` 清單 `HowTo` 所解決的問題類型。如果您同時使用 `MathSolver` 標記和 `HowTo` 標記，那麼也請使用 `assesses` 屬性。 { "@type": "MathSolver", "assesses": "Polynomial Equation" }
`potentialAction.eduQuestionType`	問題類型定義的 `Text` 清單可透過 `potentialAction.target` 屬性解決的問題類型。 { "@type": "SolveMathAction", "eduQuestionType": "Polynomial Equation" }

inLanguage

Text

數學問題解題網站所支援的語言。如要查看可支援的語言清單，請參閱這份表格。

{
  "@type": "MathSolver",
  "inLanguage": "es"
}

assesses

問題類型定義的 Text 清單

HowTo 所解決的問題類型。如果您同時使用 MathSolver 標記和 HowTo 標記，那麼也請使用 assesses 屬性。

{
  "@type": "MathSolver",
  "assesses": "Polynomial Equation"
}

potentialAction.eduQuestionType

問題類型定義的 Text 清單

可透過 potentialAction.target 屬性解決的問題類型。

{
  "@type": "SolveMathAction",
  "eduQuestionType": "Polynomial Equation"
}

LearningResource

LearningResource 表示標記主體為一項資源，可以用來協助學生、教師和其他教育學習人士。請將 LearningResource 用於網站首頁。

schema.org/LearningResource 內提供 LearningResource 的完整定義。

Google 支援的屬性如下：

必要屬性

必要屬性
`learningResourceType`	`Text` 這個學習資源的類型。請使用 `Math Solver` 這個固定值。 { "@type": ["MathSolver", "LearningResource"], "learningResourceType": "Math Solver" }

learningResourceType