Translator 3.0: Příklady slovníku

  • Článek

Poskytuje příklady, které ukazují, jak se termíny ve slovníku používají v kontextu. Tato operace se používá společně s vyhledáváním ve slovníku.

Adresa URL požadavku

Odešlete požadavek POST do:

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

VizVirtual Network Podpora pro konfiguraci a podporu vybrané sítě a privátního koncového bodu služby Translator.

Parametry požadavku

Parametry požadavku předávané řetězci dotazu jsou:

Parametr dotazu Description
api-version Povinný parametr.
Verze rozhraní API vyžádaná klientem Hodnota musí být 3.0.
Z Povinný parametr.
Určuje jazyk vstupního textu. Zdrojový jazyk musí být jedním z podporovaných jazyků zahrnutých v dictionary oboru.
na Povinný parametr.
Určuje jazyk výstupního textu. Cílový jazyk musí být jedním z podporovaných jazyků zahrnutých v dictionary oboru.

Mezi hlavičky požadavků patří:

Hlavičky Description
Hlavičky ověřování Požadovaná hlavička požadavku.
Viz Dostupné možnosti ověřování>.
Typ obsahu Požadovaná hlavička požadavku.
Určuje typ obsahu datové části. Možné hodnoty jsou: application/json.
Délka obsahu Požadovaná hlavička požadavku.
Délka textu požadavku.
X-ClientTraceId Volitelné.
Identifikátor GUID vygenerovaný klientem pro jedinečnou identifikaci požadavku. Tuto hlavičku můžete vynechat, pokud do řetězce dotazu zahrnete ID trasování pomocí parametru dotazu s názvem ClientTraceId.

Text požadavku

Text požadavku je pole JSON. Každý prvek pole je objekt JSON s následujícími vlastnostmi:

  • Text: Řetězec určující termín, který se má vyhledat. Tato vlastnost by měla být hodnota normalizedText pole ze zpětného překladu předchozího požadavku na vyhledávání slovníku . Může to být také hodnota normalizedSource pole.

  • Translation: Řetězec určující přeložený text dříve vrácený operací vyhledávání slovníku . Tato vlastnost by měla být hodnota z normalizedTarget pole v translations seznamu vyhledávací odpovědi slovníku . Služba vrátí příklady pro konkrétní dvojici slov zdroj-cíl.

Příklad:

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

Platí následující omezení:

  • Pole může mít maximálně 10 prvků.
  • Textová hodnota prvku pole nesmí překročit 100 znaků včetně mezer.

Text odpovědi

Úspěšná odpověď je pole JSON s jedním výsledkem pro každý řetězec ve vstupním poli. Objekt výsledku obsahuje následující vlastnosti:

  • normalizedSource: Řetězec, který dává normalizovaný tvar zdrojového termínu. Obecně platí, že tato vlastnost by měla být shodná s hodnotou Text pole v indexu odpovídajícího seznamu v textu požadavku.

  • normalizedTarget: Řetězec, který dává normalizovaný tvar cílového termínu. Obecně platí, že tato vlastnost by měla být shodná s hodnotou Translation pole v indexu odpovídajícího seznamu v textu požadavku.

  • examples: Seznam příkladů pro dvojici (zdrojový termín, cílový termín). Každý prvek seznamu je objekt s následujícími vlastnostmi:

  • sourcePrefix: Řetězec, který se má zřetězení před hodnotou zřetězení sourceTerm vytvořit úplný příklad. Nepřidávejte znak mezery, protože už tam je, když by měl být. Tato hodnota může být prázdný řetězec.

  • sourceTerm: Vyhledá se řetězec, který se rovná skutečnému termínu. Řetězec se přidá s sourcePrefix a sourceSuffix , aby se vytvořil úplný příklad. Jeho hodnota je oddělená, aby ji bylo možné označit v uživatelském rozhraní, například pomocí tučného písma.

    • sourceSuffix: Řetězec, který má být zřetězen za hodnotou, sourceTerm aby se vytvořil úplný příklad. Nepřidávejte znak mezery, protože už tam je, když by měl být. Tato hodnota může být prázdný řetězec.

    • targetPrefix: Řetězec podobný sourcePrefix , ale pro cíl.

    • targetTerm: Řetězec podobný sourceTerm , ale pro cíl.

    • targetSuffix: Řetězec podobný sourceSuffix , ale pro cíl.

      Poznámka

      Pokud slovník neobsahuje žádné příklady, odpověď je 200 (OK), ale examples seznam je prázdný seznam.

Příklady

Tento příklad ukazuje, jak vyhledat příklady pro dvojici tvořenou anglickým termínem fly a jeho španělským překladem 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'}]"

Text odpovědi (zkráceně pro srozumitelnost) je:

[
    {
        "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
            //
        ]
    }
]