DeepLIP （獨立發行商）（預覽版）

DeepL Translator 是一項神經機器翻譯服務。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	米哈爾·羅米謝夫斯基
URL	https://github.com/mromiszewski
Email	michal@nbtech.pl

連接器中繼資料
Publisher	米哈爾·羅米謝夫斯基
DeepL - 計劃和定價	https://docs.microsoft.com/connectors/deeplipip
網站	https://www.deepl.com/
隱私策略	https://www.deepl.com/privacy/
類別	資料

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	此 API 的 API 金鑰	對
Plan	字串	要使用的 API 定價計劃;免費或專業版	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

上傳和翻譯文件	此呼叫會上傳文件，並將其排入佇列以進行翻譯。
下載翻譯文件	一旦文件翻譯過程的狀態為 `done`，就可以下載結果。
列出所有詞彙表	列出所有詞彙表及其元資訊，但不列出詞彙表項目。
列出詞彙表支援的語言對	擷取詞彙表功能所支援的語言配對清單。
刪除詞彙表	刪除指定的詞彙表。
建立詞彙表	建立詞彙表
擷取支援的語言	擷取目前支援翻譯的語言清單，分別作為來源或目標語言。
擷取詞彙表項目	以標頭指定的 `Accept` 格式列出單一詞彙表的項目。
檢查使用情況和限制	擷取目前計費週期內的使用資訊以及對應的帳戶限制。
檢查文件狀態	擷取文件翻譯程序的目前狀態。
檢索詞彙表詳細信息	擷取單一詞彙表的元資訊，省略詞彙表項目。
請求翻譯	翻譯函數。

上傳和翻譯文件

作業識別碼：: translateDocument

此呼叫會上傳文件，並將其排入佇列以進行翻譯。

參數

名稱	機碼	必要	類型	Description
來源語言	source_lang		string	要翻譯的文字語言
目標語言	target_lang	True	string	文字應翻譯成的語言
檔案	file	True	file	要翻譯的檔案（.docx 、.pptx、.pdf 、.htm、.html 、.txt）
檔案名稱	filename		string	上傳檔案的名稱
禮節	formality		string	是傾向於正式語言還是非正式語言。
詞彙表 ID	glossary_id		string	指派給詞彙表的唯一 ID

傳回

名稱	路徑	類型	Description
document_id	document_id	string	指派給上傳文件和翻譯程序的唯一 ID。
document_key	document_key	string	唯一金鑰，用於加密上傳的文件以及伺服器端產生的翻譯。

下載翻譯文件

作業識別碼：: downloadDocument

一旦文件翻譯過程的狀態為 done，就可以下載結果。

參數

名稱	機碼	必要	類型	Description
文件 ID	document_id	True	string	上傳文件時，文件 ID 已傳送給用戶端
文件金鑰	document_key	True	string	上傳文件時，加密金鑰已傳送至用戶端

傳回

response: binary

列出所有詞彙表

作業識別碼：: listGlossaries

列出所有詞彙表及其元資訊，但不列出詞彙表項目。

傳回

名稱	路徑	類型	Description
詞彙表	glossaries	array of Glossary

列出詞彙表支援的語言對

作業識別碼：: listGlossaryLanguages

擷取詞彙表功能所支援的語言配對清單。

傳回

名稱	路徑	類型	Description
supported_languages	supported_languages	array of object	支援的語言清單
source_lang	supported_languages.source_lang	string	指定詞彙表中來源文字的語言。
target_lang	supported_languages.target_lang	string	指定詞彙表中目標文字的語言。

刪除詞彙表

作業識別碼：: deleteGlossary

刪除指定的詞彙表。

參數

名稱	機碼	必要	類型	Description
詞彙表 ID	glossary_id	True	string	指派給詞彙表的唯一ID

建立詞彙表

作業識別碼：: createGlossary

建立詞彙表

參數

名稱	機碼	必要	類型	Description
名稱	name	True	string	要與詞彙表相關聯的名稱
來源語言	source_lang	True	string	指定詞彙表中來源文字的語言
目標語言	target_lang	True	string	指定詞彙表中目標文字的語言
Entries	entries	True	string	參數中 `Entries Format` 指定格式的詞彙表項目
參賽作品格式	entries_format	True	string	`tsv` （預設值） - 定位點分隔值 - `csv` - 逗號分隔值

傳回

身體: Glossary

擷取支援的語言

作業識別碼：: getLanguages

擷取目前支援翻譯的語言清單，分別作為來源或目標語言。

參數

名稱	機碼	必要	類型	Description
類型	type		string	設定是否應列出來源或目標語言

傳回

名稱	路徑	類型	Description
		array of object
語言	language	string	指定語言的語言代碼。
名稱	name	string	英文語言名稱。
supports_formality	supports_formality	boolean	表示目標語言清單的正式支援。

擷取詞彙表項目

作業識別碼：: getGlossaryEntries

以標頭指定的 Accept 格式列出單一詞彙表的項目。

參數

名稱	機碼	必要	類型	Description
詞彙表 ID	glossary_id	True	string	指派給詞彙表的唯一ID
格式	Accept		string	目前僅支援 `text/tab-separated-values`

檢查使用情況和限制

作業識別碼：: getUsage

擷取目前計費週期內的使用資訊以及對應的帳戶限制。

傳回

名稱	路徑	類型	Description
character_count	character_count	integer	目前計費週期內迄今為止翻譯的字元。
character_limit	character_limit	integer	目前每個計費週期可翻譯的字元數上限。
document_limit	document_limit	integer	目前計費週期內迄今為止翻譯的文件。
document_count	document_count	integer	目前每個計費週期可翻譯的文件數目上限。
team_document_limit	team_document_limit	integer	目前計費週期內團隊中所有使用者迄今為止已翻譯的文件。
team_document_count	team_document_count	integer	目前每個計費週期可由團隊翻譯的文件數目上限。

檢查文件狀態

作業識別碼：: getDocumentStatus

擷取文件翻譯程序的目前狀態。

參數

名稱	機碼	必要	類型	Description
文件 ID	document_id	True	string	上傳文件時，文件 ID 已傳送給用戶端
文件金鑰	document_key	True	string	上傳文件時，加密金鑰已傳送至用戶端

傳回

名稱	路徑	類型	Description
document_id	document_id	string	指派給上傳文件和要求翻譯程序的唯一 ID。請求翻譯狀態時使用的相同ID。
狀態	status	string	文件翻譯流程目前所處狀態的簡短描述。
seconds_remaining	seconds_remaining	integer	翻譯完成之前的預估秒數。此參數僅包含在 is 時`status"translating"`。
billed_characters	billed_characters	integer	計入您帳戶的字元數。
error_message	error_message	string	錯誤的簡短描述（如果有的話）。請注意，內容可能會發生變化。如果在翻譯過程中發生錯誤，則可能會包含此參數。

檢索詞彙表詳細信息

作業識別碼：: getGlossary

擷取單一詞彙表的元資訊，省略詞彙表項目。

參數

名稱	機碼	必要	類型	Description
詞彙表 ID	glossary_id	True	string	指派給詞彙表的唯一ID

傳回

身體: Glossary

請求翻譯

作業識別碼：: translateText

翻譯函數。

參數

名稱	機碼	必要	類型	Description
要翻譯的文字	text	True	array	要翻譯的文字。僅支援 UTF-8 編碼的純文字
來源語言	source_lang		string	要翻譯的文字語言
目標語言	target_lang	True	string	文字應翻譯成的語言
分句	split_sentences		string	是否將輸入拆分為句子
保留格式	preserve_formatting		string	是否尊重原始格式
禮節	formality		string	是傾向於正式語言還是非正式語言。
詞彙表 ID	glossary_id		string	指定要用於翻譯的詞彙表
標籤處理	tag_handling		string	設定應該處理的標籤類型
非分割標籤	non_splitting_tags		string	逗號分隔的 XML 標籤列表，從不拆分句子
輪廓檢測	outline_detection		string	`0` 停用 XML 結構的自動偵測
分割標籤	splitting_tags		string	一律會導致分割的 XML 標籤以逗號分隔的清單
忽略標籤	ignore_tags		string	以逗號分隔的 XML 標籤清單，指出不翻譯的文字

傳回

名稱	路徑	類型	Description
翻譯	translations	array of object
detected_source_language	translations.detected_source_language	string	偵測到的來源語言。
收發簡訊	translations.text	string	翻譯後的文字。

定義

詞彙表Id

指派給詞彙表的唯一 ID。

: string

Glossary

名稱	路徑	類型	Description
glossary_id	glossary_id	GlossaryId	指派給詞彙表的唯一 ID。
名稱	name	string	與詞彙表相關聯的名稱。
䙼	ready	boolean	指出新建立的詞彙表是否已 `translate` 可用於請求。如果建立的詞彙表尚未準備就緒，您必須等待並檢查 `ready` 詞彙表的狀態，然後才能在請求中使用 `translate` 它。
source_lang	source_lang	GlossarySourceLanguage	指定詞彙表中來源文字的語言。
target_lang	target_lang	GlossaryTargetLanguage	指定詞彙表中目標文字的語言。
creation_time	creation_time	date-time	ISO 8601-1：2019 格式的詞彙表的建立時間（例如： `2021-08-03T14:16:18.329Z`）。
entry_count	entry_count	integer	詞彙表中的項目數。

詞彙來源語言

指定詞彙表中來源文字的語言。

: string

詞彙目標語言

指定詞彙表中目標文字的語言。

: string

二進位

這是基本數據類型『binary』。

共用方式為

DeepLIP （獨立發行商） （預覽版）

正在建立連線

預設

節流限制

動作

上傳和翻譯文件

參數

傳回

下載翻譯文件

參數

傳回

列出所有詞彙表

傳回

列出詞彙表支援的語言對

傳回

刪除詞彙表

參數

建立詞彙表

參數

傳回

擷取支援的語言

參數

傳回

擷取詞彙表項目

參數

檢查使用情況和限制

傳回

檢查文件狀態

參數

傳回

檢索詞彙表詳細信息

參數

傳回

請求翻譯

參數

傳回

定義

詞彙表Id

Glossary

詞彙來源語言

詞彙目標語言

二進位

DeepLIP （獨立發行商）（預覽版）