DeepL (プレビュー)
DeepL コネクタは、DeepL の機械翻訳テクノロジーへのプログラムによるアクセスを提供し、高品質の翻訳機能を Web サイトやアプリケーションに直接提供できるようにします。 CAT ツール用の DeepL プラグインを開発したい場合は、お問い合わせください。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | ティム カデンバック |
| [URL] | https://github.com/deejaytc |
| メール | tim.cadenbach@deepl.com |
| Connector Metadata | |
|---|---|
| 発行者 | DeepL |
| Web サイト | https://www.deepl.com/ |
| プライバシー ポリシー | https://www.deepl.com/privacy/ |
| カテゴリー | 日付 |
DeepL のミッションは、言語の壁を乗り越え、文化をより近づけることです。 そのミッションを達成するために、人工知能とニューラル ネットワークに関する専門知識を活用して、コミュニケーションをより速く、より良く、より簡単にするテクノロジーを作成します。
DeepL API コネクタを使用すると、フローで DeepL API を使用できるようになります。 テキストやドキュメントをその場で翻訳したり、用語集を管理したりできます。 DeepL API で提供される機能はすべて Power Automate でも使用できます。
前提条件と資格情報
コネクタを使用するには、DeepL API Free または Pro のサブスクリプションが必要です。 ここからサインアップできます。 サインアップ後、DeepL API アカウントの [アカウント] タブで認証キーを見つけることができます。
フローの作成中に、Free プランと Pro プランのどちらを使用するかを指定するよう求められます。 これは適宜選択する必要があります。
コネクタの使用を開始する
通常どおり新しいフローの追加を開始し、利用可能な DeepL アクションのいずれかを選択します。 これを初めて行う場合は、以下に示すように、接続の詳細を追加するよう求められます: 
適宜、料金プランを選択し、API キーを追加します。 名前は何でも構いません。 「作成」で手順を確認すると、接続を他のすべての利用可能なアクションに使用することができます。
既知の問題と制限事項
料金プランを自動検出することはできません。 初めてフローを設定するときは、Free か Pro のどちらかを自分で選択する必要があります。
一部のエンドポイントは JSON をサポートせず、URLFormEncoded コンテンツでのみ機能します。コネクタには内部回避策がありますが、これが常にすべての人に機能するとは限りません。
一般的なエラーと解決策
HTTP 429 - 429 エラーは複数の問題によって発生する可能性があります: API を頻繁に呼び出そうとしたか、当方の側で一時的な問題が発生した可能性があります。 一般的に推奨されるのは、指数バックオフ アプローチを使用して呼び出しを再試行することです。 指数バックオフは、コネクタ自体によって実装されません。
HTTP 400 - 使用された呼び出し、ペイロード、またはパラメーターに問題がありました。
HTTP 456 - クォータを超えました。 456 エラーが発生した場合は、アカウントのキャラクター制限に達しているため、次の使用期間まで待つか、アカウントをアップグレードする必要があります。 Free API ユーザーの場合は、アカウントの [プラン] タブで アップグレードできます。
よくあるご質問
- DeepL API Free と Pro のプランの違いは何ですか?
DeepL API Free は、DeepL API Pro のプランの一種で、毎月最大 500,000 文字を無料で翻訳できます。
より高度なニーズに対して、DeepL API Pro プランは以下のような追加の利点を提供しています:
最大限のデータ セキュリティ (テキストは翻訳後すぐに削除されます)
月当たりに翻訳できる文字数にボリューム制限はありません (月額 €4.99 の固定価格 + 翻訳された文字あたり €0.00002 の使用量ベースのコストに基づく請求モデル)
翻訳リクエストの優先実行
- Free プランで文字数制限に達した場合はどうなりますか?
Deepl API Free の月間文字数制限に達した場合、API を再び使用できるようになるまで、次の使用期間 (つまり月) まで待つ必要があります。 あるいは、アカウントの [プラン] タブで Pro API サブスクリプションへのアップグレードを検討することもできます。
- Pro サブスクライバーとして、使用量ベースのコストを制限する方法はありますか?
はい、プロ アカウントの [プラン] タブから コスト管理機能を有効にできます。 コスト管理について詳しくは、ヘルプ センター をご覧ください。
- コネクタを使用すると、どの機能が利用できますか?
現在 API で実行できることはすべて、コネクタを使用しても実行できます。 ここ では、サポートされているすべての機能と、パラメーターと詳細に関する追加ドキュメントを確認できます。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| API Key | securestring | 自分の API キーは、アカウント ダッシュボードにあります。 無料ユーザーおよび Pro ユーザーに必要となります。 | True |
| プラン選択 | string | API の無料ユーザーか Pro ユーザーかを選択してください | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| すべての用語集を一覧表示する |
すべての用語集とそのメタ情報を一覧表示しますが、用語集のエントリは一覧表示しません。 |
| サポートされている言語を取得する |
ソース言語またはターゲット言語として、現在翻訳がサポートされている言語のリストを取得します。 |
| テキストを翻訳して、これを一般的なテキスト翻訳に使用します |
翻訳する 1 つまたは複数のテキスト エントリを追加します。複数使用されている場合、それらは同じコンテキストであると見なされます。 |
| ドキュメントのアップロードと翻訳 |
この呼び出しは、ドキュメントをアップロードし、翻訳のためにキューに入れます。 |
| ドキュメントの状態をチェックする |
ドキュメント翻訳プロセスの現在のステータスを取得します。 |
| 使用と制限を確認する |
現在の請求期間内の使用状況情報と、対応するアカウント制限を取得します。 |
| 用語集でサポートされている言語ペアの一覧表示 |
用語集機能でサポートされている言語ペアのリストを取得します。 |
| 用語集の削除 |
指定した用語集を削除します。 |
| 用語集の詳細を取得する |
用語集のエントリを省略して、単一の用語集のメタ情報を取得します。 |
| 用語集を作成 |
用語集を作成 |
| 用語集エントリーを取得する |
単一の用語集のエントリを、 |
| 翻訳されたドキュメントのダウンロード |
ドキュメント翻訳プロセスのステータスが |
すべての用語集を一覧表示する
すべての用語集とそのメタ情報を一覧表示しますが、用語集のエントリは一覧表示しません。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
用語集
|
glossaries | array of Glossary |
サポートされている言語を取得する
ソース言語またはターゲット言語として、現在翻訳がサポートされている言語のリストを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タイプ
|
type | string |
ソース言語またはターゲット言語をリストするかどうかを設定します |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
language
|
language | string |
与えられた言語の言語コード。 |
|
名称
|
name | string |
英語での言語の名前。 |
|
supports_formality
|
supports_formality | boolean |
ターゲット言語リストの場合の形式サポートを示します。 |
テキストを翻訳して、これを一般的なテキスト翻訳に使用します
翻訳する 1 つまたは複数のテキスト エントリを追加します。複数使用されている場合、それらは同じコンテキストであると見なされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
翻訳するテキスト
|
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 |
検出されたソース言語。 |
|
text
|
translations.text | string |
翻訳済みのテキスト。 |
ドキュメントのアップロードと翻訳
この呼び出しは、ドキュメントをアップロードし、翻訳のためにキューに入れます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース言語
|
source_lang | string |
翻訳するテキストの言語 |
|
|
ターゲット言語
|
target_lang | True | string |
テキストを翻訳する言語 |
|
File
|
file | True | file |
翻訳するファイル (.docx、.pptx、.pdf、.htm、.html、.txt) |
|
File Name
|
filename | string |
アップロードされたファイルの名前 |
|
|
形式
|
formality | string |
公式または非公式の言語に傾くかどうか。 |
|
|
用語集 ID
|
glossary_id | string |
用語集に割り当てられた一意の ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
document_id
|
document_id | string |
アップロードされたドキュメントと翻訳プロセスに割り当てられた一意の ID。 |
|
document_key
|
document_key | string |
アップロードされたドキュメントとサーバー側での結果の翻訳を暗号化するために使用される一意のキー。 |
ドキュメントの状態をチェックする
ドキュメント翻訳プロセスの現在のステータスを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Document 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 |
用語集のターゲット テキストが指定されている言語。 |
用語集の削除
指定した用語集を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
用語集の詳細を取得する
用語集のエントリを省略して、単一の用語集のメタ情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
戻り値
- Body
- Glossary
用語集を作成
用語集を作成
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
件名
|
name | True | string |
用語集に関連付ける名前 |
|
ソース言語
|
source_lang | True | string |
用語集のソース テキストが指定されている言語 |
|
ターゲット言語
|
target_lang | True | string |
用語集のターゲット テキストが指定されている言語 |
|
エントリ
|
entries | True | string |
|
|
エントリ フォーマット
|
entries_format | True | string |
|
戻り値
- Body
- Glossary
用語集エントリーを取得する
単一の用語集のエントリを、Accept ヘッダーによって指定されるフォーマットで一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
|
Format
|
Accept | string |
現在。 |
翻訳されたドキュメントのダウンロード
ドキュメント翻訳プロセスのステータスが done になると、結果をダウンロードできます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Document ID
|
document_id | True | string |
ドキュメント ID は、ドキュメントのアップロード時にクライアントに送信されました |
|
ドキュメント キー
|
document_key | True | string |
暗号化キーは、ドキュメントのアップロード時にクライアントに送信されました |
戻り値
- 返答
- binary
定義
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
これは基本的なデータ型 'バイナリ' です。