DeepLIP (Independent Publisher) (Preview)
DeepL Translator is a neural machine translation service.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Contact | |
---|---|
Name | Michal Romiszewski |
URL | https://github.com/mromiszewski |
michal@nbtech.pl |
Connector Metadata | |
---|---|
Publisher | Michal Romiszewski |
DeepL - Plans and pricing | https://docs.microsoft.com/connectors/deeplipip |
Website | https://www.deepl.com/ |
Privacy policy | https://www.deepl.com/privacy/ |
Categories | Data |
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Name | Type | Description | Required |
---|---|---|---|
API Key | securestring | The API Key for this api | True |
Plan | string | The API pricing plan to use; either Free or Pro | True |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Check Document Status |
Retrieve the current status of a document translation process. |
Check Usage and Limits |
Retrieve usage information within the current billing period together with the corresponding account limits. |
Create a Glossary |
Create a Glossary |
Delete a Glossary |
Deletes the specified glossary. |
Download Translated Document |
Once the status of the document translation process is |
List all Glossaries |
List all glossaries and their meta-information, but not the glossary entries. |
List Language Pairs Supported by Glossaries |
Retrieve the list of language pairs supported by the glossary feature. |
Request Translation |
The translate function. |
Retrieve Glossary Details |
Retrieve meta information for a single glossary, omitting the glossary entries. |
Retrieve Glossary Entries |
List the entries of a single glossary in the format specified by the |
Retrieve Supported Languages |
Retrieve the list of languages that are currently supported for translation, either as source or target language, respectively. |
Upload and Translate a Document |
This call uploads a document and queues it for translation. |
Retrieve the current status of a document translation process.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Document ID
|
document_id | True | string |
The document ID was sent to the client when the document was uploaded |
Document Key
|
document_key | True | string |
The encryption key was sent to the client when the document was uploaded |
Returns
Name | Path | Type | Description |
---|---|---|---|
document_id
|
document_id | string |
A unique ID assigned to the uploaded document and the requested translation process. The same ID that was used when requesting the translation status. |
status
|
status | string |
A short description of the state the document translation process is currently in. |
seconds_remaining
|
seconds_remaining | integer |
Estimated number of seconds until the translation is done.
This parameter is only included while |
billed_characters
|
billed_characters | integer |
The number of characters billed to your account. |
error_message
|
error_message | string |
A short description of the error, if available. Note that the content is subject to change. This parameter may be included if an error occurred during translation. |
Retrieve usage information within the current billing period together with the corresponding account limits.
Returns
Name | Path | Type | Description |
---|---|---|---|
character_count
|
character_count | integer |
Characters translated so far in the current billing period. |
character_limit
|
character_limit | integer |
Current maximum number of characters that can be translated per billing period. |
document_limit
|
document_limit | integer |
Documents translated so far in the current billing period. |
document_count
|
document_count | integer |
Current maximum number of documents that can be translated per billing period. |
team_document_limit
|
team_document_limit | integer |
Documents translated by all users in the team so far in the current billing period. |
team_document_count
|
team_document_count | integer |
Current maximum number of documents that can be translated by the team per billing period. |
Create a Glossary
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Name
|
name | True | string |
Name to be associated with the glossary |
Source Language
|
source_lang | True | string |
The language in which the source texts in the glossary are specified |
Target Language
|
target_lang | True | string |
The language in which the target texts in the glossary are specified |
Entries
|
entries | True | string |
The glossary entries in the format specified in the |
Entries Format
|
entries_format | True | string |
|
Returns
- Body
- Glossary
Deletes the specified glossary.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Glossary ID
|
glossary_id | True | string |
A unique ID assigned to the glossary |
Once the status of the document translation process is done
, the result can be downloaded.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Document ID
|
document_id | True | string |
The document ID was sent to the client when the document was uploaded |
Document Key
|
document_key | True | string |
The encryption key was sent to the client when the document was uploaded |
Returns
- response
- binary
List all glossaries and their meta-information, but not the glossary entries.
Returns
Name | Path | Type | Description |
---|---|---|---|
glossaries
|
glossaries | array of Glossary |
Retrieve the list of language pairs supported by the glossary feature.
Returns
Name | Path | Type | Description |
---|---|---|---|
supported_languages
|
supported_languages | array of object |
The list of supported languages |
source_lang
|
supported_languages.source_lang | string |
The language in which the source texts in the glossary are specified. |
target_lang
|
supported_languages.target_lang | string |
The language in which the target texts in the glossary are specified. |
The translate function.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Text to be translated
|
text | True | array |
Text to be translated. Only UTF-8-encoded plain text is supported |
Source Language
|
source_lang | string |
Language of the text to be translated |
|
Target Language
|
target_lang | True | string |
The language into which the text should be translated |
Split Sentences
|
split_sentences | string |
Whether to split the input into sentences |
|
Preserve Formatting
|
preserve_formatting | string |
Whether to respect the original formatting |
|
Formality
|
formality | string |
Whether to lean towards formal or informal language. |
|
Glossary ID
|
glossary_id | string |
Specify the glossary to use for the translation |
|
Tag Handling
|
tag_handling | string |
Sets which kind of tags should be handled |
|
Non Splitting Tags
|
non_splitting_tags | string |
Comma-separated list of XML tags which never split sentences |
|
Outline Detection
|
outline_detection | string |
|
|
Splitting Tags
|
splitting_tags | string |
Comma-separated list of XML tags which always cause splits |
|
Ignore Tags
|
ignore_tags | string |
Comma-separated list of XML tags that indicate text not to be translated |
Returns
Name | Path | Type | Description |
---|---|---|---|
translations
|
translations | array of object | |
detected_source_language
|
translations.detected_source_language | string |
The detected source language. |
text
|
translations.text | string |
The translated text. |
Retrieve meta information for a single glossary, omitting the glossary entries.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Glossary ID
|
glossary_id | True | string |
A unique ID assigned to the glossary |
Returns
- Body
- Glossary
List the entries of a single glossary in the format specified by the Accept
header.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Glossary ID
|
glossary_id | True | string |
A unique ID assigned to the glossary |
Format
|
Accept | string |
Currently, supports only |
Retrieve the list of languages that are currently supported for translation, either as source or target language, respectively.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Type
|
type | string |
Sets whether source or target languages should be listed |
Returns
Name | Path | Type | Description |
---|---|---|---|
|
array of object | ||
language
|
language | string |
The language code of the given language. |
name
|
name | string |
Name of the language in English. |
supports_formality
|
supports_formality | boolean |
Denotes formality support in case of a target language listing. |
This call uploads a document and queues it for translation.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Source Language
|
source_lang | string |
Language of the text to be translated |
|
Target Language
|
target_lang | True | string |
The language into which the text should be translated |
File
|
file | True | file |
The file to be translated (.docx,.pptx,.pdf,.htm,.html,.txt) |
File Name
|
filename | string |
The name of the uploaded file |
|
Formality
|
formality | string |
Whether to lean towards formal or informal language. |
|
Glossary ID
|
glossary_id | string |
A unique ID assigned to a glossary |
Returns
Name | Path | Type | Description |
---|---|---|---|
document_id
|
document_id | string |
A unique ID assigned to the uploaded document and the translation process. |
document_key
|
document_key | string |
A unique key that is used to encrypt the uploaded document as well as the resulting translation on the server side. |
Name | Path | Type | Description |
---|---|---|---|
glossary_id
|
glossary_id | GlossaryId |
A unique ID assigned to a glossary. |
name
|
name | string |
Name associated with the glossary. |
ready
|
ready | boolean |
Indicates if the newly created glossary can already be used in |
source_lang
|
source_lang | GlossarySourceLanguage |
The language in which the source texts in the glossary are specified. |
target_lang
|
target_lang | GlossaryTargetLanguage |
The language in which the target texts in the glossary are specified. |
creation_time
|
creation_time | date-time |
The creation time of the glossary in the ISO 8601-1:2019 format (e.g.: |
entry_count
|
entry_count | integer |
The number of entries in the glossary. |
The language in which the source texts in the glossary are specified.
The language in which the source texts in the glossary are specified.
The language in which the target texts in the glossary are specified.
The language in which the target texts in the glossary are specified.
This is the basic data type 'binary'.