共用方式為

Foundry Tools 3.0 中的 Azure Translator：字典範例

提供範例，顯示字典中的術語在上下文中的使用方式。 此作業會與 字典查閱搭配使用。

請求 URL

將請求傳送 POST 至：

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

請參閱翻譯器選擇的網路與私有端點配置與支援的虛擬網路支援。

要求參數

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

查詢參數 Description
api 版本 必要參數。
用戶端要求的 API 版本。 值必須為 3.0。
從 必要參數。
指定輸入文字的語言。 來源語言必須是範圍中包含的dictionary。
打給 必要參數。
指定輸出文字的語言。 目標語言必須是範圍中包含的dictionary。

請求標頭包括：

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

請求主體

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

  • Text：指定要查閱的字詞的字串。 此屬性應該是先前字normalizedText要求的反向翻譯中的欄位值。 它也可以是欄位的 normalizedSource 值。

  • Translation：指定字 典查閱 作業先前傳回的翻譯文字的字串。 此屬性應該是normalizedTarget回應清單中translations欄位的值。 服務會傳回特定來源-目標字組的範例。

範例如下：

[
    {"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
            //
        ]
    }
]
  • Last updated on