Translator 3.0: Woordenlijstvoorbeelden

Artikel
09/01/2024

Biedt voorbeelden die laten zien hoe termen in de woordenlijst worden gebruikt in context. Deze bewerking wordt gebruikt in combinatie met opzoeken in woordenlijst.

Aanvraag-URL

Een aanvraag POST versturen naar:

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

Zie Virtual Network Support for Translator service selected network and private endpoint configuration and support.

Aanvraagparameters

Aanvraagparameters die worden doorgegeven aan de queryreeks zijn:

Queryparameter	Beschrijving
api-version	Vereiste parameter. Versie van de API die door de client is aangevraagd. Waarde moet zijn `3.0`.
from	Vereiste parameter. Hiermee geeft u de taal van de invoertekst. De brontaal moet een van de ondersteunde talen in het `dictionary` bereik zijn.
to	Vereiste parameter. Hiermee geeft u de taal van de uitvoertekst. De doeltaal moet een van de ondersteunde talen in het `dictionary` bereik zijn.

Aanvraagheaders zijn onder andere:

Kopteksten	Beschrijving
Verificatieheaders	Vereiste aanvraagheader. Zie beschikbare opties voor verificatie>.
Inhoudstype	Vereiste aanvraagheader. Hiermee geeft u het inhoudstype van de payload op. Mogelijke waarden zijn: `application/json`.
Content-Length	Optioneel. De lengte van de aanvraagtekst.
X-ClientTraceId	Optioneel. Een door de client gegenereerde GUID om de aanvraag op unieke wijze te identificeren. U kunt deze header weglaten als u de tracerings-id in de queryreeks opneemt middels een queryparameter met de naam `ClientTraceId`.

Aanvraagtekst

De hoofdtekst van de aanvraag is een JSON-matrix. Elk matrixelement is een JSON-object met de volgende eigenschappen:

Text: Een tekenreeks die de term aangeeft die moet worden opgezoekd. Deze eigenschap moet de waarde zijn van een normalizedText veld uit de back-vertalingen van een eerdere opzoekaanvraag voor woordenlijst. Dit kan ook de waarde van het normalizedSource veld zijn.
Translation: Een tekenreeks die de vertaalde tekst aangeeft die eerder is geretourneerd door de opzoekbewerking woordenlijst. Deze eigenschap moet de waarde zijn uit het normalizedTarget veld in de translations lijst met het antwoord woordenlijstzoekactie . De service retourneert voorbeelden voor het specifieke woordpaar met brondoel.

Een voorbeeld hiervan is:

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

De volgende beperkingen zijn van toepassing:

De matrix kan maximaal 10 elementen bevatten.
De tekstwaarde van een matrixelement mag niet langer zijn dan 100 tekens, inclusief spaties.

Hoofdtekst van de reactie

Een geslaagd antwoord is een JSON-matrix met één resultaat voor elke tekenreeks in de invoermatrix. Een resultaatobject bevat de volgende eigenschappen:

normalizedSource: Een tekenreeks die de genormaliseerde vorm van de bronterm geeft. Over het algemeen moet deze eigenschap identiek zijn aan de waarde van het Text veld in de overeenkomende lijstindex in de hoofdtekst van de aanvraag.
normalizedTarget: Een tekenreeks die de genormaliseerde vorm van de doelterm geeft. Over het algemeen moet deze eigenschap identiek zijn aan de waarde van het Translation veld in de overeenkomende lijstindex in de hoofdtekst van de aanvraag.
examples: Een lijst met voorbeelden voor het paar (bronterm, doelterm). Elk element van de lijst is een object met de volgende eigenschappen:
sourcePrefix: De tekenreeks die moet worden samengevoegd voordat de waarde van sourceTerm het formulier een volledig voorbeeld vormt. Voeg geen spatieteken toe, omdat het al aanwezig is wanneer het moet zijn. Deze waarde kan een lege tekenreeks zijn.
sourceTerm: Een tekenreeks die gelijk is aan de werkelijke term die is opgezoekd. De tekenreeks wordt toegevoegd met sourcePrefix en sourceSuffix om het volledige voorbeeld te vormen. De waarde ervan wordt gescheiden, zodat deze kan worden gemarkeerd in een gebruikersinterface, bijvoorbeeld door deze vet te maken.
- sourceSuffix: De tekenreeks die moet worden samengevoegd na de waarde van sourceTerm een volledig voorbeeld. Voeg geen spatieteken toe, omdat het al aanwezig is wanneer het moet zijn. Deze waarde kan een lege tekenreeks zijn.
- targetPrefix: Een tekenreeks die vergelijkbaar is met sourcePrefix maar voor het doel.
- targetTerm: Een tekenreeks die vergelijkbaar is met sourceTerm maar voor het doel.
- targetSuffix: Een tekenreeks die vergelijkbaar is met sourceSuffix maar voor het doel.
  
  Notitie
  
  Als er geen voorbeelden in de woordenlijst staan, is het antwoord 200 (OK), maar de examples lijst is een lege lijst.

Voorbeelden

In dit voorbeeld ziet u hoe u voorbeelden kunt opzoeken voor het paar dat bestaat uit de Engelse term fly en de Spaanse vertaling 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'}]"

De antwoordtekst (afgekort voor duidelijkheid) is:

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

Delen via