共用方式為

Translator 3.0：字典範例

  • 發行項

提供範例，示範如何在內容中使用字典中的詞彙。 這項作業會與 字典查閱搭配使用。

要求 URL

將 POST 要求傳送至：

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

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

要求參數

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

查詢參數 描述
api-version 必要參數。
用戶端要求的 API 版本。 值必須為 3.0。
寄件者 必要參數。
指定輸入文字的語言。 來源語言必須是範圍中包含的dictionary其中一種支持語言。
打給 必要參數。
指定輸出文字的語言。 目標語言必須是範圍中包含的dictionary其中一種支持語言。

要求標頭包括：

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

要求本文

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

  • Text：指定要查閱之字詞的字串。 這個屬性應該是上一個normalizedText字典查閱要求的反向翻譯中的欄位值。 它也可以是域的值 normalizedSource 。

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

範例是：

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

適用下列限制：

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

回應本文

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

  • normalizedSource：字串，提供來源字詞的正規化形式。 一般而言，這個屬性應該與要求主體中相符清單索引的域值 Text 相同。

  • normalizedTarget：字串，提供目標字詞的正規化形式。 一般而言，這個屬性應該與要求主體中相符清單索引的域值 Translation 相同。

  • examples:(來源字詞、目標字詞）配對的範例清單。 清單的每個元素都是具有下列屬性的物件：

  • sourcePrefix：要串連的字串，在 的值sourceTerm之前形成完整的範例。 請勿新增空格符，因為它應該已經存在。 這個值可以是空字串。

  • sourceTerm：字串等於查閱的實際字詞。 字串會與 和 sourceSuffix 一起sourcePrefix新增，以形成完整的範例。 其值會分隔，因此可以透過粗體標示在使用者介面中。

    • 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
            //
        ]
    }
]