Skip to content

DeepLWrite - DeepL

← DeepL Add-On Übersicht

The DeepLWrite step improves and rewrites the given text in the specified writing style and tone without changing its original meaning and returns the optimized version in the target language.


Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name Datentyp Beschreibung Pflichtfeld Werte
account ACCOUNT Nein
InputSpreadsheet SPREADSHEET A Spreadsheet containing the texts to be improved. Ja
mappingdefinition STRING The mapping definition JSON String Ja
Folgende Felder sind zu konfigurieren:

Feld Datentyp Beschreibung Pflichtfeld Standardwert
id SINGLE A unique identifier of the record to be translated. Can be used to match the translation with the source text (e.g. datastore record). Ja
input_text SINGLE The text to be translated. Ja
target_lang SINGLE The language into which the text should be translated. Leave empty to use the target_lang option of the Step Nein en-GB
Limit STRING Limits the number of rows for the translation. Use small values for testing to save DeepL API-Calls. Nein
target_lang STRING The language of the improved text. The language of the source texts sent in the 'input_text' parameter must match the target language (translating and improving text simultaneously is not yet supported). The language can also be set via the 'target_lang' column in the input spreadsheet. In this case, the option is ignored. Nein
  • German
  • British English
  • American English
  • Spanish
  • French
  • Italian
  • Brazilian Portuguese
  • Portuguese
writing_style STRING Changes the writing style of your improvements. Using the 'default' value behaves the same as not sending a 'writing_style'. Not supported for every target_language (see DeepL API Docs). Styles prefixed with 'prefer_' will fall back to the 'default' style when used with a language that does not support styles (this is recommended for cases where no 'target_lang' is set), the non-prefixed writing styles (except 'default') will return a HTTP 400 error in that case. It’s not possible to include both 'writing_style' and 'tone' in a request; only one or the other can be included. Nein
  • default
  • academic
  • business
  • casual
  • simple
  • prefer_academic
  • prefer_business
  • prefer_casual
  • prefer_simple
tone STRING Changes the tone of your improvements. Using the 'default' value behaves the same as not sending a tone. Not supported for every target_language (see DeepL API Docs). Tones prefixed with 'prefer_' will fall back to the 'default' tone when used with a language that does not support tones (this is recommended for cases where no 'target_lang' is set), the non-prefixed tones (except 'default') will return a HTTP 400 error in that case. It’s not possible to include both 'writing_style' and 'tone' in a request; only one or the other can be included. Nein
  • default
  • confident
  • enthusiastic
  • diplomatic
  • friendly
  • prefer_confident
  • prefer_diplomatic
  • prefer_enthusiastic
  • prefer_friendly

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name Datentyp Beschreibung Werte
ImprovedItems SPREADSHEET
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Standardwert
identifier SINGLE
input_text SINGLE
target_lang SINGLE
detected_source_language SINGLE
improvement_text SINGLE
invalidItems SPREADSHEET
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Standardwert
identifier SINGLE
id SINGLE
input_text SINGLE
failedItems SPREADSHEET
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Standardwert
identifier SINGLE
method SINGLE
host SINGLE
requestBody SINGLE
statusCode SINGLE
statusMessage SINGLE
responseHeaders SINGLE
responseFilename SINGLE
error SINGLE
source_id SINGLE
source_input_text SINGLE
responseContent SINGLE
errorMessage SINGLE