Translator 3.0: Szótárbeli példák

  • Cikk

Példákat tartalmaz, amelyek bemutatják, hogyan használják a szótárban lévő kifejezéseket a kontextusban. Ezt a műveletet a szótárkereséssel együtt használjuk.

URL-cím kérése

POST kérés küldése ide:

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

Lásd Virtual NetworkA Translator szolgáltatás támogatása kiválasztott hálózati és privát végpontok konfigurációját és támogatását.

Kérelemparaméterek

A lekérdezési sztringen átadott kérelemparaméterek a következők:

Lekérdezési paraméter Description
api-version Kötelező paraméter.
Az ügyfél által kért API verziója. Az értéknek kell lennie 3.0.
forrás: Kötelező paraméter.
A bemeneti szöveg nyelvét határozza meg. A forrásnyelvnek a hatókörben dictionary támogatott nyelvek egyikének kell lennie.
felhasználóként a(z) Kötelező paraméter.
A kimeneti szöveg nyelvét határozza meg. A célnyelvnek a hatókör egyik támogatott nyelvénekdictionary kell lennie.

A kérelemfejlécek a következők:

Fejlécek Description
Hitelesítési fejléc(ek) Szükséges kérelemfejléc.
Lásd: A hitelesítéshez elérhető hitelesítési> lehetőségek.
Content-Type Szükséges kérelemfejléc.
Megadja a hasznos adat tartalomtípusát. A lehetséges értékek a következők: application/json.
Tartalomhossz Szükséges kérelemfejléc.
A kérelem törzsének hossza.
X-ClientTraceId Nem kötelező.
Ügyfél által létrehozott GUID a kérés egyedi azonosításához. Ezt a fejlécet kihagyhatja, ha a nyomkövetési azonosítót a lekérdezési sztringbe egy nevű ClientTraceIdlekérdezési paraméterrel adja meg.

A kérés törzse

A kérelem törzse egy JSON-tömb. Minden tömbelem egy JSON-objektum, amely a következő tulajdonságokkal rendelkezik:

  • Text: A keresendő kifejezést meghatározó sztring. Ennek a tulajdonságnak egy mező értékének kell lennie egy normalizedText korábbi szótárkeresési kérelem háttérfordításából. A mező értéke normalizedSource is lehet.

  • Translation: A szótárkeresési művelet által korábban visszaadott lefordított szöveget meghatározó sztring. Ennek a tulajdonságnak a szótárkeresési válasz listájában szereplő translations mező értékének normalizedTarget kell lennie. A szolgáltatás példákat ad vissza az adott forrás-cél szópárra.

Ilyen például a következő:

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

Az alábbi korlátozások érvényesek:

  • A tömb legfeljebb 10 elemet tartalmazhat.
  • Egy tömbelem szöveges értéke nem haladhatja meg a 100 karaktert, szóközökkel együtt.

Választörzs

A sikeres válasz egy JSON-tömb, amely a bemeneti tömb minden sztringjéhez egy eredményt ad. Az eredményobjektumok a következő tulajdonságokat tartalmazzák:

  • normalizedSource: A forráskifejezés normalizált formáját megadó sztring. Ennek a tulajdonságnak általában meg kell egyeznie a Text kérelem törzsében található megfelelő listaindexben lévő mező értékével.

  • normalizedTarget: A célkifejezés normalizált formáját megadó sztring. Ennek a tulajdonságnak általában meg kell egyeznie a Translation kérelem törzsében található megfelelő listaindexben lévő mező értékével.

  • examples: Példák listája a (forráskifejezés, célkifejezés) párra. A lista minden eleme egy objektum, amely a következő tulajdonságokkal rendelkezik:

  • sourcePrefix: Az érték előttsourceTerm összefűzendő sztring teljes példát alkot. Ne adjon hozzá szóközkaraktert, mert már ott van, amikor lennie kell. Ez az érték lehet egy üres sztring.

  • sourceTerm: A tényleges kifejezéssel egyenlő sztring felnézett. A sztring a és sourceSuffix a karakterrel sourcePrefix lesz hozzáadva a teljes példa létrehozásához. Az értéke el van választva, így egy felhasználói felületen is megjelölhető, például félkövérrel.

    • sourceSuffix: Az érték sourceTermután összefűzendő sztring teljes példát alkot. Ne adjon hozzá szóközkaraktert, mert már ott van, amikor lennie kell. Ez az érték lehet egy üres sztring.

    • targetPrefix: A célhoz sourcePrefix hasonló sztring.

    • targetTerm: A célhoz sourceTerm hasonló sztring.

    • targetSuffix: A célhoz sourceSuffix hasonló sztring.

      Megjegyzés

      Ha nincsenek példák a szótárban, a válasz 200 (OK), de a examples lista egy üres lista.

Példák

Ez a példa bemutatja, hogyan kereshet példákat az angol kifejezésből fly és annak spanyol fordításából volarálló párra.

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'}]"

A válasz törzse (rövidítve az érthetőség kedvéért) a következő:

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