Translator 3.0: Příklady slovníku
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 hodnotanormalizedText
pole ze zpětného překladu předchozího požadavku na vyhledávání slovníku . Může to být také hodnotanormalizedSource
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 znormalizedTarget
pole vtranslations
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 hodnotouText
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 hodnotouTranslation
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á ssourcePrefix
asourceSuffix
, 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
//
]
}
]