DeepLIP (Editora Independente) (Pré-visualização)

DeepL Translator é um serviço de tradução automática neural.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Michal Romiszewski
URL	https://github.com/mromiszewski
Email	michal@nbtech.pl

Metadados do conector
Editora	Michal Romiszewski
DeepL - Planos e preços	https://docs.microsoft.com/connectors/deeplipip
Sítio Web	https://www.deepl.com/
Política de privacidade	https://www.deepl.com/privacy/
Categorias	Data

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Chave de API	securestring	A chave de API para esta api	Verdade
Plan	cadeia (de caracteres)	O plano de preços da API a ser usado; Gratuito ou Pro	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Carregar e traduzir um documento	Esta chamada carrega um documento e coloca-o em fila para tradução.
Criar um glossário	Criar um glossário
Download do Documento Traduzido	Uma vez que o status do processo de tradução de documentos é done, o resultado pode ser baixado.
Eliminar um glossário	Exclui o glossário especificado.
Listar pares de idiomas suportados por glossários	Recupere a lista de pares de idiomas suportados pelo recurso de glossário.
Listar todos os glossários	Liste todos os glossários e suas meta-informações, mas não as entradas do glossário.
Pedir Tradução	A função de tradução.
Recuperar detalhes do glossário	Recupere meta-informações para um único glossário, omitindo as entradas do glossário.
Recuperar entradas do glossário	Liste as entradas de um único glossário no formato especificado pelo Accept cabeçalho.
Recuperar idiomas suportados	Recupere a lista de idiomas atualmente suportados para tradução, como idioma de origem ou de destino, respectivamente.
Verificar o status do documento	Recupere o status atual de um processo de tradução de documentos.
Verificar Utilização e Limites	Recupere informações de uso dentro do período de faturamento atual, juntamente com os limites de conta correspondentes.

Carregar e traduzir um documento

ID da Operação:

translateDocument

Esta chamada carrega um documento e coloca-o em fila para tradução.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Língua de partida	source_lang		string	Língua do texto a traduzir
Língua de chegada	target_lang	True	string	A língua para a qual o texto deve ser traduzido
Ficheiro	file	True	file	O arquivo a ser traduzido (.docx,.pptx,.pdf,.htm,.html,.txt)
Nome do arquivo	filename		string	O nome do ficheiro carregado
Formalidade	formality		string	Seja para se inclinar para uma linguagem formal ou informal.
ID do glossário	glossary_id		string	Um ID exclusivo atribuído a um glossário

Devoluções

Name	Caminho	Tipo	Description
document_id	document_id	string	Um ID exclusivo atribuído ao documento carregado e ao processo de tradução.
document_key	document_key	string	Uma chave exclusiva que é usada para criptografar o documento carregado, bem como a tradução resultante no lado do servidor.

Criar um glossário

ID da Operação:

createGlossary

Criar um glossário

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome	name	True	string	Nome a associar ao glossário
Língua de partida	source_lang	True	string	A língua em que são especificados os textos-fonte do glossário
Língua de chegada	target_lang	True	string	A língua em que são especificados os textos-alvo do glossário
Entradas	entries	True	string	As entradas do glossário no formato especificado no Entries Format parâmetro
Formato das Entradas	entries_format	True	string	tsv (padrão) - valores separados por tabulação - csv - valores separados por vírgulas

Devoluções

Body

Glossary

Download do Documento Traduzido

ID da Operação:

downloadDocument

Uma vez que o status do processo de tradução de documentos é done, o resultado pode ser baixado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do documento	document_id	True	string	O ID do documento foi enviado para o cliente quando o documento foi carregado
Chave do documento	document_key	True	string	A chave de encriptação foi enviada para o cliente quando o documento foi carregado

Devoluções

response

binary

Eliminar um glossário

ID da Operação:

deleteGlossary

Exclui o glossário especificado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do glossário	glossary_id	True	string	Um ID exclusivo atribuído ao glossário

Listar pares de idiomas suportados por glossários

ID da Operação:

listGlossaryLanguages

Recupere a lista de pares de idiomas suportados pelo recurso de glossário.

Devoluções

Name	Caminho	Tipo	Description
supported_languages	supported_languages	array of object	A lista de idiomas suportados
source_lang	supported_languages.source_lang	string	A língua em que são especificados os textos-fonte do glossário.
target_lang	supported_languages.target_lang	string	A língua em que são especificados os textos-alvo do glossário.

Listar todos os glossários

ID da Operação:

listGlossaries

Liste todos os glossários e suas meta-informações, mas não as entradas do glossário.

Devoluções

Name	Caminho	Tipo	Description
Glossários	glossaries	array of Glossary

Pedir Tradução

ID da Operação:

translateText

A função de tradução.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Texto a traduzir	text	True	array	Texto a traduzir. Somente texto sem formatação codificado em UTF-8 é suportado
Língua de partida	source_lang		string	Língua do texto a traduzir
Língua de chegada	target_lang	True	string	A língua para a qual o texto deve ser traduzido
Frases divididas	split_sentences		string	Se a entrada deve ser dividida em frases
Preservar formatação	preserve_formatting		string	Se a formatação original deve ser respeitada
Formalidade	formality		string	Seja para se inclinar para uma linguagem formal ou informal.
ID do glossário	glossary_id		string	Especificar o glossário a utilizar para a tradução
Tratamento de tags	tag_handling		string	Define que tipo de tags devem ser manipuladas
Tags sem divisão	non_splitting_tags		string	Lista separada por vírgulas de marcas XML que nunca dividem frases
Deteção de contorno	outline_detection		string	0 desativa a deteção automática da estrutura XML
Dividindo tags	splitting_tags		string	Lista separada por vírgulas de marcas XML que sempre causam divisões
Ignorar tags	ignore_tags		string	Lista separada por vírgulas de marcas XML que indicam que o texto não deve ser traduzido

Devoluções

Name	Caminho	Tipo	Description
traduções	translations	array of object
detected_source_language	translations.detected_source_language	string	O idioma de origem detetado.
enviar SMS	translations.text	string	O texto traduzido.

Recuperar detalhes do glossário

ID da Operação:

getGlossary

Recupere meta-informações para um único glossário, omitindo as entradas do glossário.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do glossário	glossary_id	True	string	Um ID exclusivo atribuído ao glossário

Devoluções

Body

Glossary

Recuperar entradas do glossário

ID da Operação:

getGlossaryEntries

Liste as entradas de um único glossário no formato especificado pelo Accept cabeçalho.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do glossário	glossary_id	True	string	Um ID exclusivo atribuído ao glossário
Formato	Accept		string	Atualmente, suporta apenas text/tab-separated-values

Recuperar idiomas suportados

ID da Operação:

getLanguages

Recupere a lista de idiomas atualmente suportados para tradução, como idioma de origem ou de destino, respectivamente.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Tipo	type		string	Define se os idiomas de origem ou de destino devem ser listados

Devoluções

Name	Caminho	Tipo	Description
		array of object
linguagem	language	string	O código linguístico da língua dada.
nome	name	string	Nome da língua em inglês.
supports_formality	supports_formality	boolean	Indica o apoio à formalidade no caso de uma listagem na língua de chegada.

Verificar o status do documento

ID da Operação:

getDocumentStatus

Recupere o status atual de um processo de tradução de documentos.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do documento	document_id	True	string	O ID do documento foi enviado para o cliente quando o documento foi carregado
Chave do documento	document_key	True	string	A chave de encriptação foi enviada para o cliente quando o documento foi carregado

Devoluções

Name	Caminho	Tipo	Description
document_id	document_id	string	Um ID exclusivo atribuído ao documento carregado e ao processo de tradução solicitado. O mesmo ID que foi usado ao solicitar o status da tradução.
estado	status	string	Uma breve descrição do estado em que se encontra atualmente o processo de tradução de documentos.
seconds_remaining	seconds_remaining	integer	Número estimado de segundos até a tradução ser feita. Este parâmetro só está incluído enquanto status é "translating".
billed_characters	billed_characters	integer	O número de caracteres cobrados na sua conta.
error_message	error_message	string	Uma breve descrição do erro, se disponível. Tenha em atenção que o conteúdo está sujeito a alterações. Este parâmetro pode ser incluído se ocorrer um erro durante a tradução.

Verificar Utilização e Limites

ID da Operação:

getUsage

Recupere informações de uso dentro do período de faturamento atual, juntamente com os limites de conta correspondentes.

Devoluções

Name	Caminho	Tipo	Description
character_count	character_count	integer	Caracteres traduzidos até agora no período de faturamento atual.
character_limit	character_limit	integer	Número máximo atual de caracteres que podem ser traduzidos por período de faturamento.
document_limit	document_limit	integer	Documentos traduzidos até agora no período de faturamento atual.
document_count	document_count	integer	Número máximo atual de documentos que podem ser traduzidos por período de faturação.
team_document_limit	team_document_limit	integer	Documentos traduzidos por todos os usuários da equipe até agora no período de faturamento atual.
team_document_count	team_document_count	integer	Número máximo atual de documentos que podem ser traduzidos pela equipa por período de faturação.

Definições

GlossárioId

Um ID exclusivo atribuído a um glossário.

Um ID exclusivo atribuído a um glossário.

string

Glossário

Name	Caminho	Tipo	Description
glossary_id	glossary_id	GlossaryId	Um ID exclusivo atribuído a um glossário.
nome	name	string	Nome associado ao glossário.
pronto	ready	boolean	Indica se o glossário recém-criado já pode ser usado em translate solicitações. Se o glossário criado ainda não estiver pronto, você terá que esperar e verificar o ready status do glossário antes de usá-lo em uma translate solicitação.
source_lang	source_lang	GlossarySourceLanguage	A língua em que são especificados os textos-fonte do glossário.
target_lang	target_lang	GlossaryTargetLanguage	A língua em que são especificados os textos-alvo do glossário.
creation_time	creation_time	date-time	O tempo de criação do glossário no formato ISO 8601-1:2019 (por exemplo: 2021-08-03T14:16:18.329Z).
entry_count	entry_count	integer	O número de entradas no glossário.

GlossárioSourceLanguage

A língua em que são especificados os textos-fonte do glossário.

A língua em que são especificados os textos-fonte do glossário.

string

GlossárioTargetLanguage

A língua em que são especificados os textos-alvo do glossário.

A língua em que são especificados os textos-alvo do glossário.

string

binário

Este é o tipo de dados básico 'binário'.