DynamicTranslation – Client
Die DynamicTranslation Die API bietet Methoden, die Text mithilfe von Übersetzungsservice Providern in Echtzeit in mehrere Sprachen übersetzen. Diese API ist sowohl für Standard-Clients als auch für angular-basierte verfügbar Serviceportal Clients.
Darüber hinaus können Sie diese API verwenden, um die Sprache einer bestimmten Zeichenfolge zu erkennen und zu überprüfen, ob der verwendet wird DynamicTranslation Methoden sind für einen Übersetzungsservice aktiviert. Verwenden Sie diese API, um eine nahtlose Lokalisierungs-Experience für Ihre Anwenderoberfläche zu erstellen, mit der eine Schnittstelle mehrere Länder bedienen kann.
Derzeit unterstützt diese API zwei Übersetzungsservice Provider: Microsoft Azure Translator Service und Google Cloud Translator Service. Sie können auch andere Übersetzungsservices in Ihrer Instanz konfigurieren und dann verwenden DynamicTranslation API zum Übersetzen Ihres Texts.
Zur Verwendung dieser API müssen Sie das Plugin „dynamische Übersetzung“ aktivieren. Informationen zu diesem Plugin und zusätzliche Informationen zu dynamischer Übersetzung finden Sie unter Dynamische Übersetzungsübersicht . Auch zur Verwendung dieser API in einem Serviceportal Widget müssen Sie den dynamischen Translation-Service in die Widget-Client-Skriptfunktion einfügen.
DynamicTranslation – getDetectedLanguage(Zeichenfolgentext, Objektparameter)
Erkennt die Sprache des übergebenen Texts.
Wenn Sie einen Übersetzer übergeben, verwendet die Methode diesen Übersetzungsservice, um die Ausgangssprache zu erkennen. Andernfalls wird die Erkennung vom standardmäßigen Übersetzungsservice durchgeführt. Stellen Sie sicher, dass die von Ihnen angegebenen Textzeichenfolgen genügend Formulierungen enthalten, um eine ordnungsgemäße Spracherkennung zu ermöglichen.
Zusätzlich zur erkannten Sprache enthält die Antwort ein Konfidenzniveau der Erkennung zusammen mit anderen möglichen Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den Standardübersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.
| Name | Typ | Beschreibung |
|---|---|---|
| text | Zeichenfolge | Text, der zum Erkennen der Sprache verwendet werden soll. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| Parameter.Übersetzer | Zeichenfolge | Übersetzungsservice, der zum Erkennen der Sprache einer Zeichenfolge verwendet werden soll. Übersetzungsservices werden unter konfiguriert Übersetzerkonfiguration Menü. Mögliche Werte – Groß-/Kleinschreibung wird nicht beachtet:
Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider . Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist. Tabelle: Übersetzerkonfiguration [sn_dt_Translator_Configuration] |
| Typ | Beschreibung |
|---|---|
| Alternativen | Array von Objekten, die andere Sprachen beschreiben, die ebenfalls übereinstimmen könnten. Datentyp: Array |
| Alternativen.Code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| Alternativen.Konfidenz | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| alternatives.name | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| ErkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| ErkannteSprache.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| ErkannteSprache.Konfidenz | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zum Erkennen der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, sowie Hinweise auf die Fehlerursache.
|
Dieses Beispiel zeigt Code, der eine Zeichenfolge in Englisch mithilfe des Übersetzungsservice von IBM in einem Standard-Client-Skript erkennt.
var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );Ausgabe:
detectedResponse {
detectedLanguage:
{ "code": "en", "confidence": "1", "name": "en" }
alternatives:
[
{ "code": "vi", "confidence": "0.86", "name": "vi" },
{ "code": "id", "confidence": "0.86", "name": "id" }
]
}Dieses Beispiel zeigt ein Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.
var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );{"code":"40003","message":"Translator (\"translator\" field) is invalid"}Dieses Beispiel zeigt Code, der eine Zeichenfolge auf Englisch mithilfe des Übersetzungsservice von IBM in erkennt Serviceportal Widget-Client-Skript. Beachten Sie, dass der Name der Klasse lautet Dynamische Übersetzung Nicht 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); } );detectedResponse {
detectedLanguage:
{ "code": "en", "confidence": "1", "name": "en" }
alternatives:
[
{ "code": "vi", "confidence": "0.86", "name": "vi" },
{ "code": "id", "confidence": "0.86", "name": "id" }
]
}Dieses Beispiel zeigt einen Serviceportal Widget-Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.
var detectedResponse = dynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );{"code":"40003","message":"Translator (\"translator\" field) is invalid"}DynamicTranslation – getDetectedLanguages (Array-Texte, Objektparameter)
Erkennt die Sprachen der übergebenen Textzeichenfolgen.
Wenn Sie einen Übersetzer übergeben, verwendet die Methode diesen Übersetzungsservice, um die Ausgangssprache zu erkennen. Andernfalls wird die Erkennung vom standardmäßigen Übersetzungsservice durchgeführt. Stellen Sie sicher, dass die von Ihnen angegebenen Textzeichenfolgen genügend Formulierungen enthalten, um eine ordnungsgemäße Spracherkennung zu ermöglichen.
Zusätzlich zur erkannten Sprache enthält die Antwort ein Konfidenzniveau der Erkennung zusammen mit anderen möglichen Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den Standardübersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.
Wenn Sie diese Methode über ein Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen Dynamische Übersetzung ; Z. B. DynamicTranslation.getTranslations() . Verwenden Sie beim Aufrufen über ein Plattform-Client-Skript den Klassennamen DynamicTranslation ; Z. B. DynamicTranslation.getTranslations() .
| Name | Typ | Beschreibung |
|---|---|---|
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| Parameter.Übersetzer | Zeichenfolge | Übersetzungsservice, der zum Erkennen der Sprache einer Zeichenfolge verwendet werden soll. Übersetzungsservices werden unter konfiguriert Übersetzerkonfiguration Menü. Mögliche Werte – Groß-/Kleinschreibung wird nicht beachtet:
Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider . Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist. Tabelle: Übersetzerkonfiguration [sn_dt_Translator_Configuration] |
| Texte | Array | Liste der Textzeichenfolgen, die zum Erkennen der Sprache(n) verwendet werden sollen. |
| Typ | Beschreibung |
|---|---|
| Erkennungen | Spracherkennung von Textzeichenfolgen. Datentyp: Objekt |
| Erkennungen.Alternativen | Array von Objekten, die andere Sprachen beschreiben, die ebenfalls übereinstimmen könnten. Datentyp: Array |
| Erkennungen.Alternativen.Code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| Erkennungen.Alternativen.Konfidenz | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| detections.alternatives.name | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| detections.detectedLanguage | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| detections.detectedLanguage.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| detections.detectedLanguage.confidence | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| detections.detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Erkennungen.isFehler | Kennzeichnung, die angibt, ob die Erkennung der Sprache für den Text zu einem Fehler geführt hat. Gültige Werte:
Datentyp: Boolesch |
| status | Status der Antwort auf den Methodenaufruf. Mögliche Werte:
Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zum Erkennen der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, sowie Hinweise auf die Fehlerursache.
|
Dieses Beispiel zeigt Code aus einem Portal-Client-Skript, das Englisch als Sprache der übergebenen Zeichenfolgen mit dem Microsoft-Übersetzungsservice erkennt.
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));
Ausgabe
{
"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"}
]
}
]
}Dieses Beispiel zeigt Code in einem Portal-Client-Skript, das einen Teilstatus zurückgibt, wenn zwei Textzeichenfolgen übergeben werden und eine davon ungültig ist. Um dieses Codebeispiel in einem Plattform-Client-Skript zu verwenden, ändern Sie es DynamicTranslation.getDetectedSprachen Bis DynamicTranslation.getDetectedSprachen .
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));Ausgabe
{
"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"
}
]
}Dieses Beispiel zeigt Code aus einem Portal-Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie es DynamicTranslation.getDetectedSprachen Bis DynamicTranslation.getDetectedSprachen .
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));Ausgabe
{"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}DynamicTranslation – getTranslation(Zeichenfolge textToTranslate, Objektparameter)
Übersetzt den übergebenen Text in eine oder mehrere Sprachen.
Die Methode verwendet Übersetzungsservices wie Microsoft Azure Translator Service und Google Cloud Translator Service, um die Übersetzung durchzuführen. Wenn Sie Übersetzungsparameter nicht übergeben, verwendet die Methode den Systemstandard.
| Name | Typ | Beschreibung |
|---|---|---|
| Textzu übersetzen | Zeichenfolge | Zu übersetzender Text. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| Parameter.additionalParameter | Objekt | Optional. Array von JSON-Objekten. Jedes Objekt enthält Schlüssel-Wert-Paare, die zusätzliche Informationen für die Durchführung der Übersetzung bereitstellen. |
| Parameter.additionalParameter.parameterName | Zeichenfolge | Optional. Schlüsselname. Gültige Werte: Texttyp: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Service. |
| Parameter.additionalParameter.parameterWert | Zeichenfolge | Optional. Wert des zugeordneten Schlüssels. Gültige Werte:
Standard: Nur |
| Parms.sourceSprache | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| Parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die zum Übersetzen des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück. Standard: Bevorzugte Sprache des Anwenders. |
| Parameter.Übersetzer | Zeichenfolge | Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung nicht beachten). Gültige Werte:
Hinweis:
Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider . Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist. |
| Typ | Beschreibung |
|---|---|
| ErkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| ErkannteSprache.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Übersetzungen | Liste, die die Sprachübersetzungen beschreibt. Datentyp: Array von Objekten |
| Übersetzungen.Zielsprache | Sprachcode, in den der Quelltext übersetzt wurde. Datentyp: Zeichenfolge |
| Übersetzungen.übersetztText | Übersetzter Text. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zum Erkennen der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, und Hinweise auf die Ursache.
|
Dieses Beispiel zeigt die Übersetzung von nur-Text-Inhalten aus dem Englischen (erkannt) ins Französische und Italienische mit dem Übersetzungsservice von Microsoft in einem Standard-Client-Skript.
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);});
Antwort:
{"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"}
}Dieses Beispiel zeigt ein Clientskript, das einen Fehler auslöst, wenn eine ungültige Zielsprache übergeben wird.
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);});
Antwort:
{"code":"40054","message":"Target language is invalid"}Dieses Beispiel zeigt die Übersetzung von nur-Text-Inhalten aus dem Englischen (erkannt) ins Französische und Italienische mit dem Übersetzungsservice von Microsoft in einem Serviceportal Widget-Client-Skript. Beachten Sie, dass der Name der Klasse lautet Dynamische Übersetzung Nicht 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);});
Antwort:
{"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"}
}Dieses Beispiel zeigt einen Serviceportal Widget-Client-Skript, das einen Fehler auslöst, wenn eine ungültige Zielsprache übergeben wird
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);});
Antwort:
{"code":"40054","message":"Target language is invalid"}DynamicTranslation – getTranslations (Array-Texte, Objektparameter)
Übersetzt die übergebenen Textzeichenfolgen in eine oder mehrere Sprachen.
Die Methode verwendet Übersetzungsservices wie Microsoft Azure Translator Service und Google Cloud Translator Service, um die Übersetzung durchzuführen. Wenn Sie Übersetzungsparameter nicht übergeben, verwendet die Methode den Systemstandard.
Wenn Sie diese Methode über ein Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen Dynamische Übersetzung ; Z. B. DynamicTranslation.getTranslations() . Verwenden Sie beim Aufrufen über ein Plattform-Client-Skript den Klassennamen DynamicTranslation ; Z. B. DynamicTranslation.getTranslations() .
| Name | Typ | Beschreibung |
|---|---|---|
| Texte | Array | Liste der zu übersetzenden Textstiche. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| Parameter.additionalParameter | Objekt | Optional. Array von JSON-Objekten. Jedes Objekt enthält Schlüssel-Wert-Paare, die zusätzliche Informationen für die Durchführung der Übersetzung bereitstellen. |
| Parameter.additionalParameter.parameterName | Zeichenfolge | Optional. Schlüsselname. Gültige Werte: Texttyp: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Service. |
| Parameter.additionalParameter.parameterWert | Zeichenfolge | Optional. Wert des zugeordneten Schlüssels. Gültige Werte:
Standard: Nur |
| Parms.sourceSprache | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| Parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die zum Übersetzen des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück. Standard: Bevorzugte Sprache des Anwenders. |
| Parameter.Übersetzer | Zeichenfolge | Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung nicht beachten). Gültige Werte:
Hinweis:
Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider . Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist. |
| Typ | Beschreibung |
|---|---|
| status | Status der Antwort auf den Methodenaufruf. Mögliche Werte:
Datentyp: Zeichenfolge |
| Übersetzungen | Liste, die die Sprachübersetzungen beschreibt. Datentyp: Array |
| Übersetzungen.isFehler | Kennzeichnung, die angibt, ob die Übersetzung des Texts zu einem Fehler geführt hat. Gültige Werte:
Datentyp: Boolesch |
| translations.detectedLanguage | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| translations.detectedLanguage.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| translations.detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Textübersetzungen | Beschreibung der Sprache, die zum Übersetzen der Textzeichenfolge verwendet wird. Datentyp: Array von Objekten |
| Textübersetzungen.Zielsprache | Sprachcode, in den der Quelltext übersetzt wurde. Datentyp: Zeichenfolge |
| Textübersetzungen.übersetztText | Übersetzter Text. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zum Übersetzen des Texts verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, und Hinweise auf die Ursache.
|
Dieses Beispiel zeigt Code in einem Portal-Client-Skript, das eine Liste von Textzeichenfolgen mit dem Microsoft-Übersetzungsservice ins Französische und Italienische übersetzt.
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);});Antwort:
{
"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"
}Dieses Beispiel zeigt ein Portal-Client-Skript, das einen Teilstatus zurückgibt, wenn eine der beiden übergebenen Textzeichenfolgen ungültig ist. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie es DynamicTranslation.getÜbersetzungen Bis DynamicTranslation.getÜbersetzungen .
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);});Antwort:
{
"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"
}Dieses Beispiel zeigt ein Portal-Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie es DynamicTranslation.getÜbersetzungen Bis DynamicTranslation.getÜbersetzungen .
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);});Antwort:
{"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}DynamicTranslation – isEnabled(Zeichenfolgenübersetzer)
Bestimmt, ob die verschiedenen Methoden in der DynamicTranslation API ist für einen Übersetzungsservice aktiviert.
Wenn Sie einen bestimmten Übersetzungsservice übergeben, überprüft die Methode die Methodenaktivierung für diesen Übersetzungsservice. Andernfalls überprüft die Methode den standardmäßigen Übersetzungsservice.
Wenn Sie diese Methode über ein Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen Dynamische Übersetzung ; Z. B. DynamicTranslation.isEnabled() . Verwenden Sie beim Aufrufen über ein Plattform-Client-Skript den Klassennamen DynamicTranslation ; Z. B. DynamicTranslation.isEnabled() .
| Name | Typ | Beschreibung |
|---|---|---|
| Übersetzer | Zeichenfolge | Optional. Übersetzungsservice, der verwendet werden soll, um zu überprüfen, ob die Methoden aktiv sind. Übersetzungsservices werden im Menü Übersetzerkonfiguration konfiguriert. Mögliche Werte – Groß-/Kleinschreibung wird nicht beachtet:
Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider . Standard: Standard-Übersetzungsservice. |
| Typ | Beschreibung |
|---|---|
| BatchDetection | Kennzeichnung, die angibt, ob GetDetectedLanguages() Methode ist aktiviert. Mögliche Werte:
Datentyp: Boolesch |
| BatchTranslation | Kennzeichnung, die angibt, ob GetTranslations() Methode ist aktiviert. Mögliche Werte:
Datentyp: Boolesch |
| Erkennung | Kennzeichnung, die angibt, ob GetDetectedLanguage() Methode ist aktiviert. Mögliche Werte:
Datentyp: Boolesch |
| Übersetzung | Kennzeichnung, die angibt, ob GetTranslation() Methode ist aktiviert. Mögliche Werte:
Datentyp: Boolesch |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die API zurückgeben kann, und Hinweise auf die Ursache.
|
Dieses Beispiel zeigt ein Client-Skript, das überprüft, ob der DynamicTranslation Methoden sind für den Microsoft-Übersetzungsservice aktiviert. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie es DynamicTranslation.getÜbersetzungen Bis DynamicTranslation.getÜbersetzungen .
DynamicTranslation.isEnabled('Microsoft').then(function(res){console.log(res);}, function(res){console.log(res);});Ausgabe:
{"detection":true,"batchTranslation":true,"batchDetection":true,"translation":true}Dieses Beispiel zeigt ein Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie es DynamicTranslation.getÜbersetzungen Bis DynamicTranslation.getÜbersetzungen .
DynamicTranslation.isEnabled(123).then(function(res){console.log(res);}, function(res){console.log(res);});Ausgabe:
{"code":"40003","message":"Translator (\"translator\" field) is invalid"}