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 プランは以下のような追加の利点を提供しています:

  1. 最大限のデータ セキュリティ (テキストは翻訳後すぐに削除されます)

  2. 月当たりに翻訳できる文字数にボリューム制限はありません (月額 €4.99 の固定価格 + 翻訳された文字あたり €0.00002 の使用量ベースのコストに基づく請求モデル)

  3. 翻訳リクエストの優先実行

詳細については、ヘルプ センターをご覧ください。

  • 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 つまたは複数のテキスト エントリを追加します。複数使用されている場合、それらは同じコンテキストであると見なされます。
ドキュメントのアップロードと翻訳

この呼び出しは、ドキュメントをアップロードし、翻訳のためにキューに入れます。
ドキュメントの状態をチェックする

ドキュメント翻訳プロセスの現在のステータスを取得します。
使用と制限を確認する

現在の請求期間内の使用状況情報と、対応するアカウント制限を取得します。
用語集でサポートされている言語ペアの一覧表示

用語集機能でサポートされている言語ペアのリストを取得します。
用語集の削除

指定した用語集を削除します。
用語集の詳細を取得する

用語集のエントリを省略して、単一の用語集のメタ情報を取得します。
用語集を作成

用語集を作成
用語集エントリーを取得する

単一の用語集のエントリを、Accept ヘッダーによって指定されるフォーマットで一覧表示します。
翻訳されたドキュメントのダウンロード

ドキュメント翻訳プロセスのステータスが done になると、結果をダウンロードできます。

すべての用語集を一覧表示する

操作 ID:
ListGlossaries

すべての用語集とそのメタ情報を一覧表示しますが、用語集のエントリは一覧表示しません。

戻り値

名前 パス 型 説明
用語集
 glossaries array of Glossary

サポートされている言語を取得する

操作 ID:
GetLanguages

ソース言語またはターゲット言語として、現在翻訳がサポートされている言語のリストを取得します。

パラメーター

名前 キー 必須 型 説明
タイプ
 type string

ソース言語またはターゲット言語をリストするかどうかを設定します

戻り値

名前 パス 型 説明
array of object
language
 language string

与えられた言語の言語コード。
名称
 name string

英語での言語の名前。
supports_formality
 supports_formality boolean

ターゲット言語リストの場合の形式サポートを示します。

テキストを翻訳して、これを一般的なテキスト翻訳に使用します

操作 ID:
TranslateText

翻訳する 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

0 は XML 構造の自動検出を無効にします
分割タグ
 splitting_tags string

常に分割を引き起こす XML タグのコンマ区切りリスト
無視タグ
 ignore_tags string

翻訳対象外のテキストを示す XML タグのコンマ区切りリスト

戻り値

名前 パス 型 説明
翻訳
 translations array of object
detected_source_language
 translations.detected_source_language string

検出されたソース言語。
text
 translations.text string

翻訳済みのテキスト。

ドキュメントのアップロードと翻訳

操作 ID:
TranslateDocument

この呼び出しは、ドキュメントをアップロードし、翻訳のためにキューに入れます。

パラメーター

名前 キー 必須 型 説明
ソース言語
 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

アップロードされたドキュメントとサーバー側での結果の翻訳を暗号化するために使用される一意のキー。

ドキュメントの状態をチェックする

操作 ID:
GetDocumentStatus

ドキュメント翻訳プロセスの現在のステータスを取得します。

パラメーター

名前 キー 必須 型 説明
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

翻訳が完了するまでの推定秒数。 このパラメーターは、status が "translating" の間が含まれるのみです。
billed_characters
 billed_characters integer

アカウントに請求される文字数。
error_message
 error_message string

該当する場合は、同期エラーの短い説明を入力します。 内容は変更になる場合がありますのでご了承ください。 このパラメーターは、変換中にエラーが発生した場合に含まれる場合があります。

使用と制限を確認する

操作 ID:
GetUsage

現在の請求期間内の使用状況情報と、対応するアカウント制限を取得します。

戻り値

名前 パス 型 説明
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

請求期間ごとにチームが翻訳できる現在のドキュメント最大数。

用語集でサポートされている言語ペアの一覧表示

操作 ID:
ListGlossaryLanguages

用語集機能でサポートされている言語ペアのリストを取得します。

戻り値

名前 パス 型 説明
supported_languages
 supported_languages array of object

サポートされている言語のリスト
source_lang
 supported_languages.source_lang string

用語集のソース テキストが指定されている言語。
target_lang
 supported_languages.target_lang string

用語集のターゲット テキストが指定されている言語。

用語集の削除

操作 ID:
DeleteGlossary

指定した用語集を削除します。

パラメーター

名前 キー 必須 型 説明
用語集 ID
 glossary_id True string

用語集に割り当てられた一意の ID

用語集の詳細を取得する

操作 ID:
GetGlossary

用語集のエントリを省略して、単一の用語集のメタ情報を取得します。

パラメーター

名前 キー 必須 型 説明
用語集 ID
 glossary_id True string

用語集に割り当てられた一意の ID

戻り値

Body
Glossary

用語集を作成

操作 ID:
CreateGlossary

用語集を作成

パラメーター

名前 キー 必須 型 説明
件名
 name True string

用語集に関連付ける名前
ソース言語
 source_lang True string

用語集のソース テキストが指定されている言語
ターゲット言語
 target_lang True string

用語集のターゲット テキストが指定されている言語
エントリ
 entries True string

Entries Format パラメータで指定された形式の用語集エントリー
エントリ フォーマット
 entries_format True string

tsv(デフォルト) - タブ区切り値 -csv - コンマ区切り値

戻り値

Body
Glossary

用語集エントリーを取得する

操作 ID:
GetGlossaryEntries

単一の用語集のエントリを、Accept ヘッダーによって指定されるフォーマットで一覧表示します。

パラメーター

名前 キー 必須 型 説明
用語集 ID
 glossary_id True string

用語集に割り当てられた一意の ID
Format
 Accept string

現在。text/tab-separated-values のみサポートしています

翻訳されたドキュメントのダウンロード

操作 ID:
DownloadDocument

ドキュメント翻訳プロセスのステータスが done になると、結果をダウンロードできます。

パラメーター

名前 キー 必須 型 説明
Document ID
 document_id True string

ドキュメント ID は、ドキュメントのアップロード時にクライアントに送信されました
ドキュメント キー
 document_key True string

暗号化キーは、ドキュメントのアップロード時にクライアントに送信されました

戻り値

返答
binary

定義

GlossaryId

用語集に割り当てられた一意の ID。

用語集に割り当てられた一意の ID。

string

用語集

名前 パス 型 説明
glossary_id
 glossary_id GlossaryId

用語集に割り当てられた一意の ID。
名称
 name string

用語集に関連付ける名前。
準備完了
 ready boolean

新しく作成された用語集が既に translate リクエストで使用できるかどうかを示します。 作成された用語集がまだ準備できていない場合は、しばらく待ってから、translate で使用する前の用語集の ready ステータスリクエストを確認する必要があります。
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

用語集のエントリ数。

GlossarySourceLanguage

用語集のソース テキストが指定されている言語。

用語集のソース テキストが指定されている言語。

string

GlossaryTargetLanguage

用語集のターゲット テキストが指定されている言語。

用語集のターゲット テキストが指定されている言語。

string

binary

これは基本的なデータ型 'バイナリ' です。