Translator 3.0 : Recherche dans le dictionnaire

Article
09/01/2024

Fournit des traductions alternatives pour un mot et quelques expressions idiomatiques. Pour chaque terme, vous trouverez des informations sur la nature grammaticale ainsi qu’une liste de traductions inverses. Les traductions inverses sont utiles pour comprendre la traduction dans son contexte. L’opération Dictionary Example inclut des exemples d’utilisations de chaque paire de traductions.

URL de la demande

Envoyez une demande POST à :

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

Consultez Réseau virtuel prise en charge du service Translator sélectionné pour la configuration et la prise en charge du réseau et du point de terminaison privé sélectionnés.

Paramètres de la demande

Les paramètres de demande transmis à la chaîne de requête sont les suivants :

Paramètre de requête	Description
api-version	Paramètre obligatoire. Version de l’API demandée par le client. La valeur doit être `3.0`
de	Paramètre obligatoire. Spécifie la langue du texte d’entrée. La langue source doit être l’une des langues prises en charge incluses dans l’étendue `dictionary`.
to	Paramètre obligatoire. Spécifie la langue du texte de sortie. La langue cible doit être l’une des langues prises en charge incluses dans l’étendue `dictionary`.

Les en-têtes de demande sont les suivants :

headers	Description
En-têtes d’authentification	En-tête de demande obligatoire. Voir Authentification.
Content-Type	En-tête de demande obligatoire. Spécifie le type de contenu de la charge utile. Les valeurs possibles sont les suivantes : `application/json`.
Content-Length	Facultatif. Longueur du corps de la demande.
X-ClientTraceId	Facultatif. GUID généré par le client pour identifier de façon unique la demande. Vous pouvez omettre cet en-tête si vous incluez l’ID de trace dans la chaîne de requête à l’aide d’un paramètre de requête appelé `ClientTraceId`.

Corps de la demande

Le corps de la demande est un tableau JSON. Chaque élément du tableau est un objet JSON avec une propriété de chaîne nommée Text, qui représente le terme à rechercher.

[
    {"Text":"fly"}
]

Les limites suivantes s'appliquent :

Le tableau ne peut pas compter plus de 10 éléments.
La valeur texte d’un élément de tableau ne peut pas dépasser 100 caractères, espaces compris.

Response body

Une réponse correcte est un tableau JSON avec un résultat pour chaque chaîne dans le tableau d’entrée. Un objet de résultat inclut les propriétés suivantes :

normalizedSource: chaîne indiquant la forme normalisée du terme source. Par exemple, si la requête est JOHN, la forme normalisée est john. Le contenu de ce champ devient l’entrée des exemples de recherche.
displaySource: chaîne affichant le terme source sous une forme mieux adaptée à l’affichage à l’utilisateur final. Par exemple, si l’entrée est JOHN, la forme d’affichage reflète l’orthographe habituel du nom : John.
translations: liste des traductions du terme source. Chaque élément de la liste est un objet dont les propriétés sont les suivantes :
normalizedTarget: chaîne indiquant la forme normalisée de ce terme dans la langue cible. Cette valeur doit être utilisée comme entrée pour les exemples de recherche.
displayTarget: chaîne affichant le terme dans la langue cible et sous une forme mieux adaptée à l’affichage à l’utilisateur final. En règle générale, la propriété diffère avec le normalizedTarget réside au niveau de la mise en majuscules. Par exemple, un nom propre tel que Juan a normalizedTarget = "juan" et displayTarget = "Juan".

posTag: chaîne associant ce terme à une balise morphosyntaxique.

Nom de la balise	Description
`ADJ`	Adjectifs
`ADV`	Adverbes
`CONJ`	Conjonctions
`DET`	Déterminants
`MODAL`	Verbes et adverbes
`NOUN`	Substantifs
`PREP`	Prépositions
`PRON`	Pronoms
`VERB`	Verbes et adverbes
`OTHER`	Other

En tant que note d’implémentation, ces balises font partit du balisage morphosyntaxique de l’anglais, puis en prenant la balise la plus fréquente pour chaque paire source/cible. Ainsi, si les gens traduisent fréquemment un mot espagnol en une autre balise de reconnaissance vocale en anglais, les balises cab finissent par être incorrectes (par rapport au mot espagnol).

confidence : Une valeur comprise entre 0,0 et 1,0 représentant la « confiance » (ou pour être plus précis la « probabilité dans les données d’entraînement ») de cette paire source-traduction. La somme des scores de confiance pour un mot source peut ou ne peut pas être additionner à 1,0.
prefixWord: chaîne indiquant le mot à afficher en préfixe de la traduction. Actuellement, cette propriété est le déterminateur de sexe des noms, dans les langues qui ont des déterminants de sexe. Par exemple, le préfixe du mot espagnol mosca est la, car mosca est un nom féminin en espagnol. Cette valeur dépend uniquement de la traduction, et non pas de la source. S’il n’y a pas de préfixe, il s’agit de la chaîne vide.
backTranslations: liste des « traductions inverses » de la cible. Par exemple, les mots source pouvant être traduits dans la langue cible. La liste est garantie de contenir le mot source qui a été demandé (par exemple, si le mot source recherché est fly, puis fly est inclus dans la backTranslations liste). Toutefois, il n’est pas garanti que le terme arrive en première position. Chaque élément de la liste backTranslations est un objet décrit par les propriétés suivantes :
- normalizedText: chaîne indiquant la forme normalisée du terme source qui est une traduction inverse de la cible. Cette valeur doit être utilisée comme entrée pour les exemples de recherche.
- displayText: chaîne indiquant le terme source qui est une traduction inverse de la cible sous une forme mieux adaptée à l’affichage à l’utilisateur final.
- numExamples: nombre entier représentant le nombre d’exemples disponibles pour cette paire source-traduction. Les exemples réels doivent être récupérés avec un appel séparé aux exemples de recherche. Le nombre est principalement destiné à faciliter l’affichage dans une expérience utilisateur. Par exemple, une interface utilisateur peut ajouter un lien hypertexte à la traduction arrière si le nombre d’exemples est supérieur à zéro. Ensuite, la traduction arrière est affichée sous forme de texte brut s’il n’y a pas d’exemples. Le nombre réel d’exemples retournés par un appel à des exemples de recherche peut être inférieur à , car plus de filtrage peuvent être appliqués numExamplesà la volée pour supprimer des exemples « incorrects ».
- frequencyCount: nombre entier représentant la fréquence de cette paire source-traduction dans les données. L’objectif principal de ce champ est de fournir une interface utilisateur dans laquelle il est possible de trier les traductions inverses afin que les termes les plus fréquents apparaissent en premier.
  
  Notes
  
  Si le terme recherché ne figure pas dans le dictionnaire, la réponse est 200 (OK), mais la liste translations est vide.

Exemples

Cet exemple montre comment rechercher d’autres traductions en espagnol du terme anglais fly.

curl -X POST "https://api.cognitive.microsofttranslator.com/dictionary/lookup?api-version=3.0&from=en&to=es" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'fly'}]"

Le corps de la réponse (abrégé pour plus de clarté) est :

[
    {
        "normalizedSource":"fly",
        "displaySource":"fly",
        "translations":[
            {
                "normalizedTarget":"volar",
                "displayTarget":"volar",
                "posTag":"VERB",
                "confidence":0.4081,
                "prefixWord":"",
                "backTranslations":[
                    {"normalizedText":"fly","displayText":"fly","numExamples":15,"frequencyCount":4637},
                    {"normalizedText":"flying","displayText":"flying","numExamples":15,"frequencyCount":1365},
                    {"normalizedText":"blow","displayText":"blow","numExamples":15,"frequencyCount":503},
                    {"normalizedText":"flight","displayText":"flight","numExamples":15,"frequencyCount":135}
                ]
            },
            {
                "normalizedTarget":"mosca",
                "displayTarget":"mosca",
                "posTag":"NOUN",
                "confidence":0.2668,
                "prefixWord":"",
                "backTranslations":[
                    {"normalizedText":"fly","displayText":"fly","numExamples":15,"frequencyCount":1697},
                    {"normalizedText":"flyweight","displayText":"flyweight","numExamples":0,"frequencyCount":48},
                    {"normalizedText":"flies","displayText":"flies","numExamples":9,"frequencyCount":34}
                ]
            },
            //
            // ...list abbreviated for documentation clarity
            //
        ]
    }
]

Cet exemple montre ce qui se passe lorsque le terme recherché n’existe pas pour la paire de dictionnaire valide.

curl -X POST "https://api.cognitive.microsofttranslator.com/dictionary/lookup?api-version=3.0&from=en&to=es" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'fly123456'}]"

Étant donné que le terme ne figure pas dans le dictionnaire, le corps de réponse inclut une liste translations vide.

[
    {
        "normalizedSource":"fly123456",
        "displaySource":"fly123456",
        "translations":[]
    }
]

Partager via