DeepLIP (独立した発行元) (プレビュー)
DeepL Translator は、ニューラル機械翻訳サービスです。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Michal Romiszewski |
| URL | https://github.com/mromiszewski |
| michal@nbtech.pl |
| コネクタ メタデータ | |
|---|---|
| Publisher | Michal Romiszewski |
| DeepL - プランと価格 | https://docs.microsoft.com/connectors/deeplipip |
| Website | https://www.deepl.com/ |
| プライバシー ポリシー | https://www.deepl.com/privacy/ |
| カテゴリ | データ |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API キー | securestring | この API の API キー | 正しい |
| Plan | 文字列 | 使用する API 価格プラン。Free または Pro | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| すべての用語集を一覧表示する |
用語集とそのメタ情報をすべて一覧表示しますが、用語集のエントリは一覧表示しません。 |
| サポートされている言語を取得する |
翻訳で現在サポートされている言語の一覧を、それぞれソース言語またはターゲット言語として取得します。 |
| ドキュメントのアップロードと翻訳 |
この呼び出しはドキュメントをアップロードし、翻訳のためにキューに入れます。 |
| ドキュメントの状態を確認する |
ドキュメント翻訳プロセスの現在の状態を取得します。 |
| 使用状況と制限を確認する |
現在の請求期間内の使用状況情報を、対応するアカウント制限と共に取得します。 |
| 用語集でサポートされている言語ペアを一覧表示する |
用語集機能でサポートされている言語ペアの一覧を取得します。 |
| 用語集のエントリを取得する |
1 つの用語集のエントリを、 |
| 用語集の詳細を取得する |
用語集のエントリを省略して、1 つの用語集のメタ情報を取得します。 |
| 用語集を作成する |
用語集を作成する |
| 用語集を削除する |
指定した用語集を削除します。 |
| 翻訳された文書をダウンロードする |
ドキュメント翻訳プロセスの状態が |
| 翻訳の要求 |
translate 関数。 |
すべての用語集を一覧表示する
用語集とそのメタ情報をすべて一覧表示しますが、用語集のエントリは一覧表示しません。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
用語 集
|
glossaries | array of Glossary |
サポートされている言語を取得する
翻訳で現在サポートされている言語の一覧を、それぞれソース言語またはターゲット言語として取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タイプ
|
type | string |
ソース言語とターゲット言語のどちらを一覧表示するかを設定します |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
言語
|
language | string |
指定された言語の言語コード。 |
|
名前
|
name | string |
英語の言語の名前。 |
|
supports_formality
|
supports_formality | boolean |
ターゲット言語リストの場合の形式のサポートを示します。 |
ドキュメントのアップロードと翻訳
この呼び出しはドキュメントをアップロードし、翻訳のためにキューに入れます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース言語
|
source_lang | string |
翻訳するテキストの言語 |
|
|
目標言語
|
target_lang | True | string |
テキストを翻訳する言語 |
|
File
|
file | True | file |
翻訳するファイル (.docx,.pptx,.pdf,.htm ,.html,.txt) |
|
ファイル名
|
filename | string |
アップロードされたファイルの名前 |
|
|
公式
|
formality | string |
正式または非公式の言語に傾くかどうか。 |
|
|
用語集 ID
|
glossary_id | string |
用語集に割り当てられた一意の ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
document_id
|
document_id | string |
アップロードされたドキュメントと翻訳プロセスに割り当てられた一意の ID。 |
|
document_key
|
document_key | string |
アップロードされたドキュメントの暗号化に使用される一意のキーと、サーバー側での結果の翻訳。 |
ドキュメントの状態を確認する
ドキュメント翻訳プロセスの現在の状態を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント ID
|
document_id | True | string |
ドキュメント ID は、ドキュメントのアップロード時にクライアントに送信されました |
|
ドキュメント キー
|
document_key | True | string |
暗号化キーは、ドキュメントのアップロード時にクライアントに送信されました |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
document_id
|
document_id | string |
アップロードされたドキュメントと要求された翻訳プロセスに割り当てられた一意の ID。 翻訳状態を要求するときに使用されたのと同じ ID。 |
|
状態
|
status | string |
ドキュメント翻訳プロセスが現在行っている状態の簡単な説明。 |
|
seconds_remaining
|
seconds_remaining | integer |
翻訳が完了するまでの推定秒数。
このパラメーターは、 |
|
billed_characters
|
billed_characters | integer |
アカウントに請求される文字数。 |
|
error_message
|
error_message | string |
エラーの簡単な説明 (使用可能な場合)。 コンテンツは変更される可能性があることに注意してください。 このパラメーターは、翻訳中にエラーが発生した場合に含まれる場合があります。 |
使用状況と制限を確認する
現在の請求期間内の使用状況情報を、対応するアカウント制限と共に取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |
請求期間ごとにチームが翻訳できるドキュメントの現在の最大数。 |
用語集でサポートされている言語ペアを一覧表示する
用語集機能でサポートされている言語ペアの一覧を取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
supported_languages
|
supported_languages | array of object |
サポートされている言語の一覧 |
|
source_lang
|
supported_languages.source_lang | string |
用語集のソース テキストが指定されている言語。 |
|
target_lang
|
supported_languages.target_lang | string |
用語集のターゲット テキストが指定されている言語。 |
用語集のエントリを取得する
1 つの用語集のエントリを、 Accept ヘッダーで指定された形式で一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
|
Format
|
Accept | string |
現在、サポートされているのは |
用語集の詳細を取得する
用語集のエントリを省略して、1 つの用語集のメタ情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
戻り値
- Body
- Glossary
用語集を作成する
用語集を作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
用語集に関連付ける名前 |
|
ソース言語
|
source_lang | True | string |
用語集のソース テキストが指定されている言語 |
|
目標言語
|
target_lang | True | string |
用語集のターゲット テキストが指定されている言語 |
|
Entries
|
entries | True | string |
|
|
エントリの形式
|
entries_format | True | string |
|
戻り値
- Body
- Glossary
用語集を削除する
指定した用語集を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
翻訳された文書をダウンロードする
ドキュメント翻訳プロセスの状態が doneされると、結果をダウンロードできます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント ID
|
document_id | True | string |
ドキュメント ID は、ドキュメントのアップロード時にクライアントに送信されました |
|
ドキュメント キー
|
document_key | True | string |
暗号化キーは、ドキュメントのアップロード時にクライアントに送信されました |
戻り値
- response
- binary
翻訳の要求
translate 関数。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
翻訳するテキスト
|
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 |
|
|
|
タグの分割
|
splitting_tags | string |
常に分割を引き起こす XML タグのコンマ区切りリスト |
|
|
タグを無視する
|
ignore_tags | string |
翻訳しないテキストを示す XML タグのコンマ区切りリスト |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
翻訳
|
translations | array of object | |
|
detected_source_language
|
translations.detected_source_language | string |
検出されたソース言語。 |
|
SMS 送信
|
translations.text | string |
翻訳されたテキスト。 |
定義
GlossaryId
用語集
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
glossary_id
|
glossary_id | GlossaryId |
用語集に割り当てられた一意の ID。 |
|
名前
|
name | string |
用語集に関連付けられている名前。 |
|
準備完了
|
ready | boolean |
新しく作成された用語集を |
|
source_lang
|
source_lang | GlossarySourceLanguage |
用語集のソース テキストが指定されている言語。 |
|
target_lang
|
target_lang | GlossaryTargetLanguage |
用語集のターゲット テキストが指定されている言語。 |
|
creation_time
|
creation_time | date-time |
ISO 8601-1:2019 形式の用語集の作成時刻 (例: |
|
entry_count
|
entry_count | integer |
用語集内のエントリの数。 |
GlossarySourceLanguage
GlossaryTargetLanguage
binary
これは基本的なデータ型 'binary' です。