Translator 3.0: Příklady slovníku

Článek
09/01/2024

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 slovníku.

Adresa URL požadavku

Odešlete požadavek POST do:

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

Viz Podpora virtuální sítě pro vybranou službu Translator a konfiguraci a podporu privátního koncového bodu.

Parametry požadavku

Parametry požadavku předané v řetězci dotazu jsou:

Parametr dotazu	Popis
api-version	Povinný parametr. Verze rozhraní API požadovaného klientem Hodnota musí být `3.0`.
from	Povinný parametr. Určuje jazyk vstupního textu. Zdrojový jazyk musí být jedním z podporovaných jazyků zahrnutých `dictionary` v 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 `dictionary` v oboru.

Hlavičky požadavku zahrnují:

Hlavičky	Popis
Hlavičky ověřování	Požadovaná hlavička požadavku. Informace o možnostech ověřování>najdete v tématu 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	Volitelné. 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 hodnotou normalizedText pole z back-translationů předchozího požadavku vyhledávání slovníku. Může to být také hodnota normalizedSource pole.
Translation: Řetězec určující přeložený text, který dříve vrátil vyhledávací operace slovníku. Tato vlastnost by měla být hodnota z pole v translations seznamu vyhledávací odpovědi slovníku.normalizedTarget Služba vrátí příklady pro konkrétní dvojici slov cíle zdroje.

Příkladem je:

[
    {"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. Výsledný objekt obsahuje následující vlastnosti:

normalizedSource: Řetězec s normalizovanou formou 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 s normalizovaným tvarem 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ím před hodnotou 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: Řetězec, který se rovná skutečnému výrazu, vyhledal. Řetězec se přidá s úplným sourcePrefix příkladem a sourceSuffix vytvoří ho. Jeho hodnota je oddělená, aby ji bylo možné označit v uživatelském rozhraní, například tučným písmem.
- sourceSuffix: Řetězec, který se má zřetězení za hodnotou sourceTerm vytvoření kompletního příkladu. 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 cíli.
- targetTerm: Řetězec podobný sourceTerm cíli.
- targetSuffix: Řetězec podobný sourceSuffix cíli.
  
  Poznámka:
  
  Pokud ve slovníku nejsou žádné příklady, odpověď je 200 (OK), ale examples seznam je prázdný.

Příklady

Tento příklad ukazuje, jak vyhledat příklady pro dvojici tvořený anglickým termínem fly a jeho španělský překlad 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 přehlednost) 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
            //
        ]
    }
]

Sdílet prostřednictvím