DeepLIP (nezávislý vydavatel) (Preview)

DeepL Translator je neurální služba strojového překladu.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících:      – Oblasti Azure Government      – Oblasti Azure China      - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)

Kontakt
Název	Michal Romiszewski
URL	https://github.com/mromiszewski
Email	michal@nbtech.pl

Metadata konektoru
Vydavatel	Michal Romiszewski
DeepL – Plány a ceny	https://www.deepl.com/pro?cta=header-prices/
Internetová stránka	https://www.deepl.com/
Zásady ochrany osobních údajů	https://www.deepl.com/privacy/
Kategorie	Data

Vytvoření připojení

Konektor podporuje následující typy ověřování:

výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Klíč rozhraní API	securestring	Klíč rozhraní API pro toto rozhraní API	Pravdivé
Plán	řetězec	Cenový plán rozhraní API, který se má použít; Free nebo Pro	Pravdivé

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund

Akce

Kontrola stavu dokumentu	Načtení aktuálního stavu procesu překladu dokumentu
Kontrola využití a omezení	Načtěte informace o využití v aktuálním fakturačním období společně s odpovídajícími limity účtu.
Nahrání a překlad dokumentu	Toto volání nahraje dokument a zařadí ho do fronty pro překlad.
Načtení podporovaných jazyků	Načtěte seznam jazyků, které jsou aktuálně podporovány pro překlad, buď jako zdrojový nebo cílový jazyk, v uvedeném pořadí.
Načtení podrobností glosáře	Načtěte meta informace pro jeden glosář a vynecháte položky glosáře.
Načtení položek glosáře	Zobrazí seznam položek jednoho glosáře ve formátu určeném záhlavím Accept .
Odstranění glosáře	Odstraní zadaný glosář.
Požádat o překlad	Funkce translate.
Stáhnout přeložený dokument	Jakmile je donestav procesu překladu dokumentu , můžete si stáhnout výsledek.
Vytvoření glosáře	Vytvoření glosáře
Výpis jazykových párů podporovaných glosáři	Načtěte seznam párů jazyků podporovaných funkcí glosáře.
Výpis všech glosářů	Uveďte všechny glosáře a jejich metainformací, ale ne položky glosáře.

Kontrola stavu dokumentu

ID operace:

getDocumentStatus

Načtení aktuálního stavu procesu překladu dokumentu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID dokumentu	document_id	True	string	ID dokumentu se odeslalo klientovi při nahrání dokumentu.
Klíč dokumentu	document_key	True	string	Šifrovací klíč byl odeslán klientovi při nahrání dokumentu.

Návraty

Name	Cesta	Typ	Description
document_id	document_id	string	Jedinečné ID přiřazené nahranému dokumentu a požadovanému procesu překladu. Stejné ID, které se použilo při vyžádání stavu překladu.
stav	status	string	Stručný popis stavu procesu překladu dokumentu.
seconds_remaining	seconds_remaining	integer	Odhadovaný počet sekund, než se překlad dokončí. Tento parametr je zahrnut pouze v době, kdy status je "translating".
billed_characters	billed_characters	integer	Počet znaků fakturovaných na váš účet
error_message	error_message	string	Stručný popis chyby, pokud je k dispozici. Všimněte si, že obsah se může změnit. Tento parametr může být zahrnut, pokud během překladu došlo k chybě.

Kontrola využití a omezení

ID operace:

getUsage

Načtěte informace o využití v aktuálním fakturačním období společně s odpovídajícími limity účtu.

Návraty

Name	Cesta	Typ	Description
character_count	character_count	integer	Znaky se zatím překládají v aktuálním fakturačním období.
character_limit	character_limit	integer	Aktuální maximální počet znaků, které lze přeložit na fakturační období.
document_limit	document_limit	integer	Dokumenty se zatím překládají v aktuálním fakturačním období.
document_count	document_count	integer	Aktuální maximální počet dokumentů, které lze přeložit na fakturační období.
team_document_limit	team_document_limit	integer	Dokumenty přeložené všemi uživateli v týmu zatím v aktuálním fakturačním období
team_document_count	team_document_count	integer	Aktuální maximální počet dokumentů, které může tým přeložit na fakturační období

Nahrání a překlad dokumentu

ID operace:

translateDocument

Toto volání nahraje dokument a zařadí ho do fronty pro překlad.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Zdrojový jazyk	source_lang		string	Jazyk textu, který se má přeložit
Cílový jazyk	target_lang	True	string	Jazyk, do kterého má být text přeložen
File	file	True	file	Soubor, který se má přeložit (.docx,.pptx,.pdf,.htm,.html,.txt)
Název souboru	filename		string	Název nahraného souboru
Formalita	formality		string	Zda se chcete přiklonit k formálnímu nebo neformálnímu jazyku.
ID glosáře	glossary_id		string	Jedinečné ID přiřazené glosáři

Návraty

Name	Cesta	Typ	Description
document_id	document_id	string	Jedinečné ID přiřazené nahranému dokumentu a procesu překladu.
document_key	document_key	string	Jedinečný klíč, který slouží k šifrování nahraného dokumentu a výsledného překladu na straně serveru.

Načtení podporovaných jazyků

ID operace:

getLanguages

Načtěte seznam jazyků, které jsou aktuálně podporovány pro překlad, buď jako zdrojový nebo cílový jazyk, v uvedeném pořadí.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ	type		string	Nastaví, jestli mají být uvedeny zdrojové nebo cílové jazyky.

Návraty

Name	Cesta	Typ	Description
		array of object
jazyk	language	string	Kód jazyka daného jazyka.
název	name	string	Název jazyka v angličtině.
supports_formality	supports_formality	boolean	Označuje formální podporu v případě výpisu cílového jazyka.

Načtení podrobností glosáře

ID operace:

getGlossary

Načtěte meta informace pro jeden glosář a vynecháte položky glosáře.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID glosáře	glossary_id	True	string	Jedinečné ID přiřazené glosáři

Návraty

Body

Glossary

Načtení položek glosáře

ID operace:

getGlossaryEntries

Zobrazí seznam položek jednoho glosáře ve formátu určeném záhlavím Accept .

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID glosáře	glossary_id	True	string	Jedinečné ID přiřazené glosáři
Formát	Accept		string	V současné době podporuje pouze text/tab-separated-values

Odstranění glosáře

ID operace:

deleteGlossary

Odstraní zadaný glosář.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID glosáře	glossary_id	True	string	Jedinečné ID přiřazené glosáři

Požádat o překlad

ID operace:

translateText

Funkce translate.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Text, který se má přeložit	text	True	array	Text, který se má přeložit. Podporuje se pouze prostý text s kódováním UTF-8.
Zdrojový jazyk	source_lang		string	Jazyk textu, který se má přeložit
Cílový jazyk	target_lang	True	string	Jazyk, do kterého má být text přeložen
Rozdělení vět	split_sentences		string	Zda se má vstup rozdělit na věty
Zachování formátování	preserve_formatting		string	Zda se má respektovat původní formátování
Formalita	formality		string	Zda se chcete přiklonit k formálnímu nebo neformálnímu jazyku.
ID glosáře	glossary_id		string	Zadejte glosář, který se má použít pro překlad.
Zpracování značek	tag_handling		string	Nastaví, jaký druh značek se má zpracovat.
Nerozdělování značek	non_splitting_tags		string	Čárkami oddělený seznam značek XML, které nikdy nerozdělují věty
Detekce osnovy	outline_detection		string	0 zakáže automatickou detekci struktury XML.
Rozdělení značek	splitting_tags		string	Čárkami oddělený seznam značek XML, které vždy způsobují rozdělení
Ignorovat značky	ignore_tags		string	Čárkami oddělený seznam značek XML, které označují text, který se nemá přeložit

Návraty

Name	Cesta	Typ	Description
překlady	translations	array of object
detected_source_language	translations.detected_source_language	string	Zjištěný zdrojový jazyk.
poslat SMS	translations.text	string	Přeložený text.

Stáhnout přeložený dokument

ID operace:

downloadDocument

Jakmile je donestav procesu překladu dokumentu , můžete si stáhnout výsledek.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID dokumentu	document_id	True	string	ID dokumentu se odeslalo klientovi při nahrání dokumentu.
Klíč dokumentu	document_key	True	string	Šifrovací klíč byl odeslán klientovi při nahrání dokumentu.

Návraty

response

binary

Vytvoření glosáře

ID operace:

createGlossary

Vytvoření glosáře

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název	name	True	string	Název, který se má přidružit ke glosáři
Zdrojový jazyk	source_lang	True	string	Jazyk, ve kterém jsou uvedeny zdrojové texty v glosáři
Cílový jazyk	target_lang	True	string	Jazyk, ve kterém jsou určeny cílové texty v glosáři
Položky	entries	True	string	Položky glosáře ve formátu zadaném v parametru Entries Format
Formát položek	entries_format	True	string	tsv (výchozí) – hodnoty oddělené tabulátorem – csv – – hodnoty oddělené čárkami

Návraty

Body

Glossary

Výpis jazykových párů podporovaných glosáři

ID operace:

listGlossaryLanguages

Načtěte seznam párů jazyků podporovaných funkcí glosáře.

Návraty

Name	Cesta	Typ	Description
supported_languages	supported_languages	array of object	Seznam podporovaných jazyků
source_lang	supported_languages.source_lang	string	Jazyk, ve kterém jsou zadány zdrojové texty v glosáři.
target_lang	supported_languages.target_lang	string	Jazyk, ve kterém jsou zadány cílové texty v glosáři.

Výpis všech glosářů

ID operace:

listGlossaries

Uveďte všechny glosáře a jejich metainformací, ale ne položky glosáře.

Návraty

Name	Cesta	Typ	Description
Glosáře	glossaries	array of Glossary

Definice

GlosářId

Jedinečné ID přiřazené glosáři.

Jedinečné ID přiřazené glosáři.

string

Glosář

Name	Cesta	Typ	Description
glossary_id	glossary_id	GlossaryId	Jedinečné ID přiřazené glosáři.
název	name	string	Název přidružený ke glosáři
připravený	ready	boolean	Označuje, jestli se nově vytvořený glosář už dá použít v translate požadavcích. Pokud vytvořený glosář ještě není připravený, musíte před použitím v ready požadavku počkat a zkontrolovat translate stav glosáře.
source_lang	source_lang	GlossarySourceLanguage	Jazyk, ve kterém jsou zadány zdrojové texty v glosáři.
target_lang	target_lang	GlossaryTargetLanguage	Jazyk, ve kterém jsou zadány cílové texty v glosáři.
creation_time	creation_time	date-time	Čas vytvoření glosáře ve formátu ISO 8601-1:2019 (např.: 2021-08-03T14:16:18.329Z).
entry_count	entry_count	integer	Počet položek v glosáři

GlosářSourceLanguage

Jazyk, ve kterém jsou zadány zdrojové texty v glosáři.

Jazyk, ve kterém jsou zadány zdrojové texty v glosáři.

string

GlosářTargetLanguage

Jazyk, ve kterém jsou zadány cílové texty v glosáři.

Jazyk, ve kterém jsou zadány cílové texty v glosáři.

string

binární

Toto je základní datový typ Binary.