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