DynamicTranslation : client
L’API DynamicTranslation fournit des méthodes qui traduisent le texte, en temps réel, en plusieurs langues à l’aide de fournisseurs de services de traduction. Cette API est disponible à la fois pour les clients standard et les clients basés sur Portail de services Angular.
En outre, vous pouvez utiliser cette API pour détecter la langue d’une chaîne spécifique et vérifier si les méthodes DynamicTranslation sont activées pour un service de traduction. Utilisez cette API pour créer une expérience de localisation transparente pour votre interface utilisateur, permettant à une interface de desservir plusieurs pays.
Actuellement, cette API prend en charge deux fournisseurs de services de traduction : Microsoft Azure Translator Service et Google Cloud Translator Service. Vous pouvez également configurer d’autres services de traduction au sein de votre instance, puis utiliser l’API DynamicTranslation pour traduire votre texte.
Pour utiliser cette API, vous devez activer le module d’extension Traduction dynamique. Pour plus d’informations sur ce module d’extension et des informations supplémentaires sur la traduction dynamique, reportez-vous à la section Présentation de la traduction dynamique. En outre, pour utiliser cette API dans un Portail de services widget, vous devez injecter le service dynamicTranslation dans la fonction de script client du widget.
DynamicTranslation - getDetectedLanguage(String text, Object parms)
Détecte la langue du texte transmis.
Si vous transmettez un traducteur, la méthode utilise ce service de traduction pour détecter la langue source. Dans le cas contraire, la détection est effectuée par le service de traduction par défaut. Assurez-vous que les chaînes de texte que vous fournissez contiennent suffisamment de verbiage pour permettre une détection correcte de la langue.
En plus de la langue détectée, la réponse contient un niveau de confiance de la détection, ainsi que d’autres alternatives linguistiques possibles. Si un traducteur n’est pas transmis, la méthode renvoie également le service de traduction par défaut utilisé pour détecter la langue.
| Nom | Type | Description |
|---|---|---|
| Texte | Chaîne | Texte à utiliser pour détecter la langue. |
| Parms | Objet | Facultatif. Objet JSON contenant des paramètres de traduction supplémentaires. |
| parms.translator | Chaîne | Service de traduction à utiliser pour détecter la langue d’une chaîne. Les services de traduction sont configurés dans le menu Configuration du traducteur et se trouvent dans la table Configuration du traducteur [sn_dt_translator_configuration]. Valeurs possibles - insensibles à la casse :
Remarque :
Pour utiliser des services de traduction personnalisés, vous devez d’abord configurer le service de traduction dans votre instance. Pour plus d’informations, voir Intégrer à un fournisseur de service de traduction. Par défaut : service de traduction configuré dans la table Configuration du traducteur [sn_dt_translator_configuration]. |
| Type | Description |
|---|---|
| alternatives | Tableau d’objets qui décrivent d’autres langues qui peuvent également concorder. Type de données : tableau |
| alternatives.code | Code de langue de l’autre langue. Type de données : chaîne |
| alternatives.confiance | Valeur flottante indiquant le niveau de confiance de l’autre langue. La valeur se situe entre zéro et un. Plus la valeur est faible, plus le niveau de fiabilité est faible. Type de données : chaîne |
| alternatives.name | Code de langue de l’autre langue. Type de données : chaîne |
| detectedLanguage | Description de la langue détectée. Type de données : objet |
| detectedLanguage.code | Code de langue de la langue détectée. Type de données : chaîne |
| detectedLanguage.confidence | Valeur flottante indiquant le niveau de confiance de l’autre langue. La valeur se situe entre zéro et un. Plus la valeur est faible, plus le niveau de fiabilité est faible. Type de données : chaîne |
| detectedLanguage.name | Code de langue de la langue détectée. Type de données : chaîne |
| traducteur | Service de traduction utilisé pour détecter la langue. Type de données : chaîne |
| Messages d'erreur | Vous trouverez ci-dessous des messages d’erreur que la méthode peut renvoyer et des indications quant à la cause première de l’erreur.
|
Cet exemple montre le code qui détecte une chaîne en anglais à l’aide du service de traduction d’IBM dans un script client standard.
var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
Sortie :
detectedResponse {
detectedLanguage:
{ "code": "en", "confidence": "1", "name": "en" }
alternatives:
[
{ "code": "vi", "confidence": "0.86", "name": "vi" },
{ "code": "id", "confidence": "0.86", "name": "id" }
]
}
Cet exemple montre un script client qui génère une erreur lorsqu’un service de traduction non valide est transmis.
var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );Sortie :{"code":"40003","message":"Translator (\"translator\" field) is invalid"}
Cet exemple montre le code qui détecte une chaîne en anglais à l’aide du service de traduction d’IBM dans un Portail de services script client widget. Notez que le nom de la classe est dynamicTranslation et non DynamicTranslation.
var detectedResponse = dynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );Sortie :detectedResponse {
detectedLanguage:
{ "code": "en", "confidence": "1", "name": "en" }
alternatives:
[
{ "code": "vi", "confidence": "0.86", "name": "vi" },
{ "code": "id", "confidence": "0.86", "name": "id" }
]
}
Cet exemple montre un Portail de services script client de widget qui génère une erreur lorsqu’un service de traduction non valide est transmis.
var detectedResponse = dynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );Sortie :{"code":"40003","message":"Translator (\"translator\" field) is invalid"}
DynamicTranslation : getDetectedLanguages(Array texts, Object parms)
Détecte les langues des chaînes de texte transmises.
Si vous transmettez un traducteur, la méthode utilise ce service de traduction pour détecter la langue source. Dans le cas contraire, la détection est effectuée par le service de traduction par défaut. Assurez-vous que les chaînes de texte que vous fournissez contiennent suffisamment de verbiage pour permettre une détection correcte de la langue.
En plus de la langue détectée, la réponse contient un niveau de confiance de la détection, ainsi que d’autres alternatives linguistiques possibles. Si un traducteur n’est pas transmis, la méthode renvoie également le service de traduction par défaut utilisé pour détecter la langue.
Lors de l’appel de cette méthode à partir d’un script client du portail, utilisez le nom de classe dynamicTranslation ; tels que dynamicTranslation.getTranslations(). Lorsque vous l’appelez à partir d’un script client de plateforme, utilisez le nom de classe DynamicTranslation ; tels que DynamicTranslation.getTranslations().
| Nom | Type | Description |
|---|---|---|
| Parms | Objet | Facultatif. Objet JSON contenant des paramètres de traduction supplémentaires. |
| parms.translator | Chaîne | Service de traduction à utiliser pour détecter la langue d’une chaîne. Les services de traduction sont configurés dans le menu Configuration du traducteur et se trouvent dans la table Configuration du traducteur [sn_dt_translator_configuration]. Valeurs possibles - insensibles à la casse :
Remarque :
Pour utiliser des services de traduction personnalisés, vous devez d’abord configurer le service de traduction dans votre instance. Pour plus d’informations, voir Intégrer à un fournisseur de service de traduction. Par défaut : service de traduction configuré dans la table Configuration du traducteur [sn_dt_translator_configuration]. |
| textes | Tableau | Liste des chaînes de texte à utiliser pour détecter la ou les langues. |
| Type | Description |
|---|---|
| détections | Détection de la langue des chaînes de texte. Type de données : objet |
| détections.alternatives | Tableau d’objets qui décrivent d’autres langues qui peuvent également concorder. Type de données : tableau |
| détections.alternatives.code | Code de langue de l’autre langue. Type de données : chaîne |
| détections.alternatives.fiabilité | Valeur flottante indiquant le niveau de confiance de l’autre langue. La valeur se situe entre zéro et un. Plus la valeur est faible, plus le niveau de fiabilité est faible. Type de données : chaîne |
| detections.alternatives.name | Code de langue de l’autre langue. Type de données : chaîne |
| détections.detectedLanguage | Description de la langue détectée. Type de données : objet |
| détections.detectedLanguage.code | Code de langue de la langue détectée. Type de données : chaîne |
| détections.languedetected.confidence | Valeur flottante indiquant le niveau de confiance de l’autre langue. La valeur se situe entre zéro et un. Plus la valeur est faible, plus le niveau de fiabilité est faible. Type de données : chaîne |
| detections.detectedLanguage.name | Code de langue de la langue détectée. Type de données : chaîne |
| détections.isError | Marqueur indiquant si la détection de la langue du texte a entraîné une erreur. Valeurs valides :
Type de données : booléennes |
| statut | État de la réponse à l’appel de méthode. Valeurs possibles :
Type de données : chaîne |
| traducteur | Service de traduction utilisé pour détecter la langue. Type de données : chaîne |
| Messages d'erreur | Vous trouverez ci-dessous des messages d’erreur que la méthode peut renvoyer et des indications quant à la cause première de l’erreur.
|
Cet exemple montre le code provenant d’un script client du portail qui détecte l’anglais comme langue des chaînes transmises à l’aide du service de traduction Microsoft.
var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "Microsoft"}).then(function(res) {console.log(res);}, function(res) {console.log(res);});
gs.info(JSON.stringify(detectedResponse));
Sortie
{
"translator":"Microsoft",
"status":"Success",
"detections":[
{
"isError":false,
"detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
"alternatives":[
{"name":"id", "code":"id", "confidence":"0.83"},
{"name":"ms", "code":"ms", "confidence":"0.83"}
]
},
{
"isError":false,
"detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
"alternatives":[
{"name":"fr", "code":"fr", "confidence":"0.83"},
{"name":"id", "code":"id", "confidence":"0.83"}
]
}
]
}
Cet exemple montre le code d’un script client du portail qui renvoie un état Partiel lorsque deux chaînes de texte sont transmises et que l’une d’elles n’est pas valide. Pour utiliser cet exemple de code dans un script client de plateforme, remplacez dynamicTranslation.getDetectedLanguages par DynamicTranslation.getDetectedLanguages.
var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", ""], {"translator": "Microsoft"}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
gs.info(JSON.stringify(detectedResponse));
Sortie
{
"translator":"Microsoft",
"status":"Partial",
"detections":[
{
"isError":false,
"detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
"alternatives":[
{"name":"id", "code":"id", "confidence":"0.83"},
{"name":"ms", "code":"ms", "confidence":"0.83"}
]
},
{
"isError":true,
"code":"40000",
"message":"Text is missing or invalid"
}
]
}
Cet exemple montre le code d’un script client du portail qui génère une erreur lorsqu’un service de traduction non valide est transmis. Pour utiliser cet exemple de code pour un script client de plateforme, remplacez dynamicTranslation.getDetectedLanguages par DynamicTranslation.getDetectedLanguages.
var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "123"}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
gs.info(JSON.stringify(detectedResponse));
Sortie
{"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}
DynamicTranslation : getTranslation(String textToTranslate, Object parms)
Traduit le texte transmis vers une ou plusieurs langues.
La méthode utilise des services de traduction, tels que Microsoft Azure Translator Service et Google Cloud Translator Service, pour effectuer la traduction. Si vous ne transmettez pas de paramètres de traduction, la méthode utilise la valeur système par défaut.
| Nom | Type | Description |
|---|---|---|
| textToTranslate (en anglais seulement) | Chaîne | Texte à traduire. |
| Parms | Objet | Facultatif. Objet JSON contenant des paramètres de traduction supplémentaires. |
| parms.additionalParameters | Objet | Facultatif. Tableau d’objets JSON. Chaque objet contient des paires clé-valeur qui fournissent des informations supplémentaires sur l’exécution de la traduction. |
| parms.additionalParameters.parameterName | Chaîne | Facultatif. Nom de la clé. Valeurs valides : textype : Type de texte à traduire. Pour Microsoft Azure Translator Service uniquement. |
| parms.additionalParameters.parameterValue | Chaîne | Facultatif. Valeur de la clé associée. Valeurs valides :
Par défaut : brut |
| parms.sourceLanguage | Chaîne | Facultatif. Code de langue du texte source. Par défaut : le service de traduction détecte la langue source. |
| parms.targetLanguages | Tableau | Facultatif. Liste des codes de langue à utiliser pour traduire. La méthode renvoie du texte traduit pour chaque code de langue. Par défaut : langue préférée de l’utilisateur. |
| parms.translator | Chaîne | Facultatif. Service de traduction à utiliser pour traduire le texte (insensible à la casse). Valeurs valides :
Remarque :
Pour utiliser des services de traduction personnalisés, vous devez d’abord configurer le service de traduction dans votre instance. Pour plus d’informations, voir Intégrer à un fournisseur de service de traduction. Par défaut : service de traduction configuré dans la table Configuration du traducteur [sn_dt_translator_configuration]. |
| Type | Description |
|---|---|
| detectedLanguage | Description de la langue détectée. Type de données : objet |
| detectedLanguage.code | Code de langue de la langue détectée. Type de données : chaîne |
| detectedLanguage.name | Code de langue de la langue détectée. Type de données : chaîne |
| traductions | Tableau d’objets décrivant les traductions. Type de données : tableau |
| traductions.targetLanguage | Code de la langue vers laquelle le texte source a été traduit. Type de données : chaîne |
| translations.translatedText | Texte traduit. Type de données : chaîne |
| traducteur | Service de traduction utilisé pour détecter la langue. Type de données : chaîne |
| Messages d'erreur | Vous trouverez ci-dessous des messages d’erreur que la méthode peut renvoyer et des indications quant à leur cause profonde.
|
Cet exemple montre la traduction d’un contenu en texte brut de l’anglais (détecté) vers le français et l’italien à l’aide du service de traduction de Microsoft dans un script client standard.
DynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Réponse :
{"translations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre questo testo utilizzando la piattaforma dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire ce texte en utilisant la plate-forme du client"
}
],
"translator":"Microsoft",
"detectedLanguage":{"code":"en","name":"en"}
}
Cet exemple montre un script client qui génère une erreur lorsqu’une langue cible non valide est transmise.
DynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": ["123"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Réponse :
{"code":"40054","message":"Target language is invalid"}
Cet exemple montre la traduction d’un contenu en texte brut de l’anglais (détecté) vers le français et l’italien à l’aide du service de traduction de Microsoft dans un Portail de services script client widget. Notez que le nom de la classe est dynamicTranslation et non DynamicTranslation.
dynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Réponse :
{"translations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre questo testo utilizzando la piattaforma dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire ce texte en utilisant la plate-forme du client"
}
],
"translator":"Microsoft",
"detectedLanguage":{"code":"en","name":"en"}
}
Cet exemple montre un Portail de services script client de widget qui lève une erreur lorsqu’une langue cible non valide est transmise
dynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": [123],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Réponse :
{"code":"40054","message":"Target language is invalid"}
DynamicTranslation - getTranslations(Tableau de textes, Objet parms)
Traduit les chaînes de texte transmises dans une ou plusieurs langues.
La méthode utilise des services de traduction, tels que Microsoft Azure Translator Service et Google Cloud Translator Service, pour effectuer la traduction. Si vous ne transmettez pas de paramètres de traduction, la méthode utilise la valeur système par défaut.
Lors de l’appel de cette méthode à partir d’un script client du portail, utilisez le nom de classe dynamicTranslation ; tels que dynamicTranslation.getTranslations(). Lorsque vous l’appelez à partir d’un script client de plateforme, utilisez le nom de classe DynamicTranslation ; tels que DynamicTranslation.getTranslations().
| Nom | Type | Description |
|---|---|---|
| textes | Tableau | Liste des piqûres de texte à traduire. |
| Parms | Objet | Facultatif. Objet JSON contenant des paramètres de traduction supplémentaires. |
| parms.additionalParameters | Objet | Facultatif. Tableau d’objets JSON. Chaque objet contient des paires clé-valeur qui fournissent des informations supplémentaires sur l’exécution de la traduction. |
| parms.additionalParameters.parameterName | Chaîne | Facultatif. Nom de la clé. Valeurs valides : textype : Type de texte à traduire. Pour Microsoft Azure Translator Service uniquement. |
| parms.additionalParameters.parameterValue | Chaîne | Facultatif. Valeur de la clé associée. Valeurs valides :
Par défaut : brut |
| parms.sourceLanguage | Chaîne | Facultatif. Code de langue du texte source. Par défaut : le service de traduction détecte la langue source. |
| parms.targetLanguages | Tableau | Facultatif. Liste des codes de langue à utiliser pour traduire. La méthode renvoie du texte traduit pour chaque code de langue. Par défaut : langue préférée de l’utilisateur. |
| parms.translator | Chaîne | Facultatif. Service de traduction à utiliser pour traduire le texte (insensible à la casse). Valeurs valides :
Remarque :
Pour utiliser des services de traduction personnalisés, vous devez d’abord configurer le service de traduction dans votre instance. Pour plus d’informations, voir Intégrer à un fournisseur de service de traduction. Par défaut : service de traduction configuré dans la table Configuration du traducteur [sn_dt_translator_configuration]. |
| Type | Description |
|---|---|
| statut | État de la réponse à l’appel de méthode. Valeurs possibles :
Type de données : chaîne |
| traductions | Tableau d’objets décrivant les traductions. Type de données : tableau |
| translations.isError | Marqueur indiquant si la traduction du texte a entraîné une erreur. Valeurs valides :
Type de données : booléennes |
| traductions.detectedLanguage | Description de la langue détectée. Type de données : objet |
| traductions.detectedLanguage.code | Code de langue de la langue détectée. Type de données : chaîne |
| translations.detectedLanguage.name | Code de langue de la langue détectée. Type de données : chaîne |
| textTranlations | Tableau d’objets. Description de la langue utilisée pour traduire la chaîne de texte. |
| textTranslations.targetLanguage | Code de la langue vers laquelle le texte source a été traduit. Type de données : chaîne |
| textTranslations.translatedText | Texte traduit. Type de données : chaîne |
| traducteur | Service de traduction utilisé pour traduire le texte. Type de données : chaîne |
| Messages d'erreur | Vous trouverez ci-dessous des messages d’erreur que la méthode peut renvoyer et des indications quant à leur cause profonde.
|
Cet exemple montre le code dans un script client du portail qui traduit une liste de chaînes de texte en français et en italien à l’aide du service de traduction Microsoft.
dynamicTranslation.getTranslations(["Translate first text using portal from client", "Translate second text using portal from client"], {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Réponse :
{
"translations":[
{
"isError":false,
"textTranslations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre il primo testo utilizzando il portale dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire le premier texte à l'aide du portail à partir du client"
}
],
"detectedLanguage": {"name":"en", "code":"en"}
},
{
"isError":false,
"textTranslations":[
{
"targetLanguage":"it",
"translatedText":"Traduci il secondo testo utilizzando il portale dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire le deuxième texte à l'aide du portail à partir du client"
}
],
"detectedLanguage": {"name":"en", "code":"en"}
}
],
"translator":"Microsoft",
"status":"Success"
}
Cet exemple montre un script client du portail qui renvoie un état Partiel lorsque l’une des deux chaînes de texte transmises n’est pas valide. Pour utiliser cet exemple de code pour un script client de plateforme, remplacez dynamicTranslation.getTranslations par DynamicTranslation.getTranslations.
dynamicTranslation.getTranslations(["Translate first text using portal from client", ""], {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Réponse :
{
"translations":[
{
"isError":false,
"textTranslations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre il primo testo utilizzando il portale dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire le premier texte à l'aide du portail à partir du client"
}
],
"detectedLanguage":{"name":"en", "code":"en"}
},
{
"isError":true,
"code":"40000",
"message":"Text is missing or invalid"
}
],
"translator":"Microsoft",
"status":"Partial"
}
Cet exemple montre un script client du portail qui génère une erreur lorsqu’un service de traduction non valide est transmis. Pour utiliser cet exemple de code pour un script client de plateforme, remplacez dynamicTranslation.getTranslations par DynamicTranslation.getTranslations.
dynamicTranslation.getTranslations(["Translate first text using portal from client", "Translate second text using portal from client"], {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": 123
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Réponse :
{"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}
DynamicTranslation : isEnabled (traducteur de chaînes)
Détermine si les différentes méthodes de l’API DynamicTranslation sont activées pour un service de traduction.
Si vous transmettez un service de traduction spécifique, la méthode vérifie l’activation de la méthode pour ce service de traduction ; Dans le cas contraire, la méthode vérifie le service de traduction par défaut.
Lors de l’appel de cette méthode à partir d’un script client du portail, utilisez le nom de classe dynamicTranslation ; tels que dynamicTranslation.isEnabled(). Lorsque vous l’appelez à partir d’un script client de plateforme, utilisez le nom de classe DynamicTranslation ; tels que DynamicTranslation.isEnabled().
| Nom | Type | Description |
|---|---|---|
| traducteur | Chaîne | Facultatif. Service de traduction à utiliser pour vérifier si les méthodes sont actives. Les services de traduction sont configurés dans le menu Configuration du traducteur. Valeurs possibles - insensibles à la casse :
Remarque :
Pour utiliser des services de traduction personnalisés, vous devez d’abord configurer le service de traduction dans votre instance. Pour plus d’informations, voir Intégrer à un fournisseur de service de traduction. Par défaut : service de traduction par défaut. |
| Type | Description |
|---|---|
| batchDetection (détection par lots) | Marqueur indiquant si la méthode getDetectedLanguages() est activée. Valeurs possibles :
Type de données : booléennes |
| Traduction par lots | Marqueur indiquant si la méthode getTranslations() est activée. Valeurs possibles :
Type de données : booléennes |
| détection | Marqueur indiquant si la méthode getDetectedLanguage() est activée. Valeurs possibles :
Type de données : booléennes |
| traduction | Marqueur indiquant si la méthode getTranslation() est activée. Valeurs possibles :
Type de données : booléennes |
| Messages d'erreur | Vous trouverez ci-dessous les messages d’erreur que l’API peut renvoyer et des indications quant à leur cause première.
|
Cet exemple montre un script client qui vérifie si les méthodes DynamicTranslation sont activées pour le service de traduction Microsoft. Pour utiliser cet exemple de code pour un script client de plateforme, remplacez DynamicTranslation.getTranslations par dynamicTranslation.getTranslations.
DynamicTranslation.isEnabled('Microsoft').then(function(res){console.log(res);}, function(res){console.log(res);});
Sortie :
{"detection":true,"batchTranslation":true,"batchDetection":true,"translation":true}
Cet exemple montre un script client qui génère une erreur lorsqu’un service de traduction non valide est transmis. Pour utiliser cet exemple de code pour un script client de plateforme, remplacez DynamicTranslation.getTranslations par dynamicTranslation.getTranslations.
DynamicTranslation.isEnabled(123).then(function(res){console.log(res);}, function(res){console.log(res);});
Sortie :
{"code":"40003","message":"Translator (\"translator\" field) is invalid"}