翻譯工具 3.0：字典範例

發行項
09/22/2023

提供範例以說明字典中的字詞在內容中的使用方式。此作業會與字典查閱搭配使用。

要求 URL

將 POST 要求傳送至：

https://api.cognitive.microsofttranslator.com/dictionary/examples?api-version=3.0

請參閱虛擬網路翻譯工具服務選取的網路和私人端點組態和支援的支援。

要求參數

在查詢字串上傳遞的要求參數為：

查詢參數	Description
api-version	必要參數。用戶端要求的 API 版本。值必須為 `3.0`。
從	必要參數。指定輸入文字的語言。來源語言必須是 `dictionary` 範圍內包含的支援語言之一。
to	必要參數。指定輸出文字的語言。目標語言必須是 `dictionary` 範圍內包含的支援語言之一。

要求標頭包括：

標題	描述
驗證標頭	必要的要求標頭。請參閱驗證> 可用的驗證選項。
Content-Type	必要的要求標頭。指定承載的內容類型。可能的值為：`application/json`。
Content-Length	必要的要求標頭。要求本文的長度。
X-ClientTraceId	選擇項。用於識別唯一要求的 GUID，由用戶端產生。若您使用名為 `ClientTraceId` 的查詢參數在查詢字串中包含追蹤識別碼，您就可以省略此標頭。

要求本文

要求的本文是 JSON 陣列。每個陣列元素都是具有下列屬性的 JSON 物件：

Text：指定要查閱之字詞的字串。這個屬性應該是上一個 normalizedTextDictionary 查閱要求之反向轉譯的欄位值。它也可以是 normalizedSource 欄位的值。
Translation：一個字串，指定字典查閱作業先前傳回的翻譯文字。這個屬性應該是字典查閱回應清單中欄位 translations 的值 normalizedTarget 。服務會傳回特定來源目標字組的範例。

範例如下：

[
    {"Text":"fly", "Translation":"volar"}
]

適用下列限制：

陣列最多可以有 10 個項目。
陣列專案的文字值不能超過 100 個字元，包括空格。

回應本文

成功的回應是輸入陣列的每個字串各有一個結果的 JSON 陣列。結果物件包含下列屬性：

normalizedSource：一個字串，指定來源字詞的標準化形式。一般而言，這個屬性應該與要求主體中相符清單索引的欄位值 Text 相同。
normalizedTarget：一個字串，指定目標字詞的標準化形式。一般而言，這個屬性應該與要求主體中相符清單索引的欄位值 Translation 相同。
examples：(來源字詞、目標字詞) 配對的範例清單。清單的每個項目是具有下列屬性的物件：
sourcePrefix：要在 sourceTerm 的值之前串連以形成完整範例的字串。請勿新增空白字元，因為它應該已經存在。此值可以是空字串。
sourceTerm：與查閱的實際字詞等同的字串。此字串可透過 sourcePrefix 和 sourceSuffix 來新增，以形成完整範例。其值會分隔，因此可以透過粗體標示在使用者介面中。
- sourceSuffix：要在 sourceTerm 的值之後串連以形成完整範例的字串。請勿新增空白字元，因為它應該已經存在。此值可以是空字串。
- targetPrefix：一個類似於 sourcePrefix 但用於目標的字串。
- targetTerm：一個類似於 sourceTerm 但用於目標的字串。
- targetSuffix：一個類似於 sourceSuffix 但用於目標的字串。
  
  注意
  
  如果字典中沒有範例，回應會是 200 (良好)，但 examples 清單卻是空白清單。

範例

此範例示範如何查閱由英文字詞 fly 及其西班牙文翻譯 volar 所組成的配對範例。

curl -X POST "https://api.cognitive.microsofttranslator.com/dictionary/examples?api-version=3.0&from=en&to=es" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'fly', 'Translation':'volar'}]"

回應本文 (為了清楚緣故已縮減) 如下：

[
    {
        "normalizedSource":"fly",
        "normalizedTarget":"volar",
        "examples":[
            {
                "sourcePrefix":"They need machines to ",
                "sourceTerm":"fly",
                "sourceSuffix":".",
                "targetPrefix":"Necesitan máquinas para ",
                "targetTerm":"volar",
                "targetSuffix":"."
            },
            {
                "sourcePrefix":"That should really ",
                "sourceTerm":"fly",
                "sourceSuffix":".",
                "targetPrefix":"Eso realmente debe ",
                "targetTerm":"volar",
                "targetSuffix":"."
            },
            //
            // ...list abbreviated for documentation clarity
            //
        ]
    }
]

翻譯工具 3.0：字典範例

要求 URL

要求參數

要求本文

回應本文

範例

其他資源