Microsoft Translator V3 (プレビュー)
Microsoft Azure Cognitive Services Translator を使用すると、一般的なモデルまたはカスタム モデルを使用して、100 を超える言語でテキストとドキュメントを翻訳できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft 翻訳ツール |
| URL | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| mtfb@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft 翻訳ツール |
| Website | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| プライバシー ポリシー | https://privacy.microsoft.com/ |
| カテゴリ | 人工知能;ビジネス インテリジェンス |
Azure Cognitive Services Translator コネクタを使用すると、Power Automate Flow や Power App などの Power Platform の任意のコンポーネントを Microsoft Translator サービスと統合できます。 このコネクタを使用すると、次のアクションを実行できます。
•テキストの翻訳。
• テキストを表記変換します。
• ドキュメントファイルの種類の様々な翻訳。
[前提条件]
Azure portal で Translator リソースを作成する手順に従う
資格情報を取得する方法
• Translator リソースを作成した後、 Azure Portal からリソース名とキーを取得します。
• ドキュメントを翻訳するには、次の前提条件に従ってください。
• 次のスクリーンショットに示すように、ソースコンテナーとターゲットコンテナー内を移動し、[Microsoft Entra ID ユーザー アカウントに切り替える] をクリックします。 この手順は、コネクタにのみ必要です。
コネクタの概要
フローで Translator コネクタを使用し、翻訳タスクを自動化する方法については、次の手順に従います。
一般的なエラー
一般的なエラーについては、このドキュメントを参照してください。 https://learn.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-reference#errors
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| アクセス キー | Translator の Microsoft Translator リソース名と Azure Cognitive Services リソース キーを指定します。 | すべてのリージョン | 共有可能 |
| ロジック アプリのマネージド ID | LogicApps マネージド ID を使用して接続を作成する | LOGICAPPS のみ | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
アクセス キー
認証 ID: keyBasedAuth
適用対象: すべてのリージョン
Translator の Microsoft Translator リソース名と Azure Cognitive Services リソース キーを指定します。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Translator リソース名 | 文字列 | Microsoft Translator リソース名を入力します | 正しい |
| リソース キー | securestring | Translator 用の Azure Cognitive Services リソース キー。 | 正しい |
Logic Apps マネージド ID
認証 ID: managedIdentityAuth
適用: LOGICAPPS のみ
LogicApps マネージド ID を使用して接続を作成する
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| LogicApps マネージド ID | managedIdentity | Logic Apps マネージド ID を使用してサインインする | 正しい |
| Translator リソース名 | 文字列 | Microsoft Translator リソース名を入力します | 正しい |
| リソース キー | securestring | Translator 用の Azure Cognitive Services リソース キー。 | 正しい |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Translator リソース名 | 文字列 | Microsoft Translator リソース名を入力します | 正しい |
| リソース キー | securestring | Translator 用の Azure Cognitive Services リソース キー。 | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| Transliterate |
ある言語のテキストを、あるスクリプトから別のスクリプトに変換します。 |
| サポートされているストレージ ソースを取得する |
サポートされているストレージ ソース/オプションの一覧を取得します。 |
| サポートされるドキュメントの形式の取得 |
サポートされているドキュメント形式の一覧を取得します。 |
| サポートされる用語集の形式の取得 |
サポートされている用語集の形式の一覧を取得します。 |
| テキストを翻訳する |
指定したソース言語テキストをターゲット言語テキストに翻訳します。 |
| ドキュメントの状態を取得する |
ジョブ内の特定のドキュメントの状態を取得します。 |
| ドキュメントの状態を取得する |
翻訳ジョブ内のすべてのドキュメントの状態を取得します。 |
| ドキュメント翻訳を開始する |
このアクションにより、ドキュメント翻訳ジョブが開始されます。 |
| 翻訳の取り消し |
現在処理中またはキューに登録されているドキュメント翻訳ジョブを取り消します。 |
| 翻訳の状態を取得する |
特定のドキュメント翻訳要求の状態の概要を取得します。 |
| 翻訳の状態を取得する |
ユーザーによって送信されたすべての翻訳要求の状態と共にリストを取得します。 |
| 言語を取得する |
Microsoft Azure Cognitive Services Translator で翻訳がサポートされているすべての言語を取得します。 |
Transliterate
ある言語のテキストを、あるスクリプトから別のスクリプトに変換します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Language
|
language | True | string |
スクリプト間で変換するテキストの言語を指定します。 |
|
ソース スクリプト
|
fromScript | True | string |
入力テキストのスクリプトの名前。 |
|
ターゲット スクリプト
|
toScript | True | string |
音訳されたテキストのスクリプトの名前。 |
|
テキスト
|
Text | True | string |
翻訳するテキスト。 |
戻り値
- response
- array of TransliterationResults
サポートされているストレージ ソースを取得する
サポートされているストレージ ソース/オプションの一覧を取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of string |
応答値。 |
サポートされるドキュメントの形式の取得
サポートされる用語集の形式の取得
テキストを翻訳する
指定したソース言語テキストをターゲット言語テキストに翻訳します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース言語
|
from | True | string |
ソース言語コード (例: 'en')。 ソース言語コードが指定されていない場合は、自動言語検出が適用され、ソース言語が決定されます。 |
|
目標言語
|
to | True | string |
ターゲット言語コード (例: 'fr')。 |
|
テキストの種類
|
textType | string |
翻訳するテキスト形式がプレーン テキストか HTML かを定義します。 |
|
|
不適切な表現のアクション
|
profanityAction | string |
翻訳での不適切な表現の処理方法を指定します。 |
|
|
不適切な表現マーカー
|
profanityMarker | string |
翻訳で不適切な表現をマークする方法を指定します。 |
|
|
文の長さを含める
|
includeSentenceLength | string |
入力テキストと翻訳されたテキストの文の境界を含めるかどうかを指定します。 |
|
|
推奨されるソース言語
|
suggestedFrom | string |
入力テキストの言語を識別できない場合は、フォールバック言語を指定します。 |
|
|
ソース テキストのスクリプト
|
fromScript | string |
入力テキストのスクリプトの名前。 |
|
|
翻訳されたテキストのスクリプト
|
toScript | string |
翻訳されたテキストのスクリプトの名前。 |
|
|
カテゴリ
|
category | string |
翻訳のカテゴリ (ドメイン) を指定する文字列。 このパラメーターは、Custom Translator で構築されたカスタマイズされたシステムから翻訳を取得するために使用されます。 |
|
|
一般ドメインへのフォールバックを許可する
|
allowFallback | string |
カスタム システムが存在しない場合に、サービスが一般的なシステムにフォールバックすることを許可することを指定します。 |
|
|
テキスト
|
Text | True | string |
翻訳するテキスト。 |
戻り値
- response
- array of TranslationResults
ドキュメントの状態を取得する
ジョブ内の特定のドキュメントの状態を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
|
ドキュメント ID
|
documentId | True | string |
ドキュメント ID。 |
戻り値
ドキュメントの状態を取得する
翻訳ジョブ内のすべてのドキュメントの状態を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
|
返されるレコードの合計数
|
$top | integer |
ユーザーがすべてのページにわたって返すレコードの合計数。 |
|
|
スキップするレコードの数
|
$skip | integer |
並べ替え方法に基づいてリストからスキップするレコードの数。 |
|
|
返される最大レコード数
|
$maxpagesize | integer |
ページで返される最大レコード数。 |
|
|
並べ替え順
|
$orderBy | array |
コレクションの並べ替えクエリ。 (例: 'CreatedDateTimeUtc asc'、'CreatedDateTimeUtc desc')。 |
|
|
start datetime
|
createdDateTimeUtcStart | date-time |
アイテムを取得する開始日時。 |
|
|
終了日時
|
createdDateTimeUtcEnd | date-time |
前のアイテムを取得する終了日時。 |
|
|
状態でフィルター処理する
|
statuses | array |
フィルター処理で使用する状態。 |
|
|
ドキュメント ID でフィルター処理する
|
ids | array |
フィルター処理で使用するドキュメント ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of object |
応答値。 |
|
パス
|
value.path | string |
ドキュメントまたはフォルダーの場所。 |
|
ソースパス
|
value.sourcePath | string |
ソース ドキュメントの場所。 |
|
createdDateTimeUtc
|
value.createdDateTimeUtc | string |
操作の作成日時。 |
|
lastActionDateTimeUtc
|
value.lastActionDateTimeUtc | string |
操作の状態が更新された日時。 |
|
状態
|
value.status | string |
ジョブまたはドキュメントで使用可能な状態の一覧。 |
|
送信先
|
value.to | string |
目標言語。 |
|
進捗
|
value.progress | integer |
翻訳の進行状況 (使用可能な場合)。 |
|
id
|
value.id | string |
ドキュメント ID。 |
|
characterCharged
|
value.characterCharged | integer |
API によって課金される文字。 |
|
@nextLink
|
@nextLink | string |
次のページの URL。 最後のページの場合は Null。 |
ドキュメント翻訳を開始する
このアクションにより、ドキュメント翻訳ジョブが開始されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力ドキュメントのストレージの種類
|
storageType | True | string |
ファイルまたはフォルダーを選択します。 |
|
ソース言語
|
sourceLanguage | True | string |
言語コード。 何も指定しない場合、Microsoft Translator はドキュメント言語の自動検出を試みます。 |
|
ソース ドキュメントの場所
|
sourceURL | True | string |
1 つのファイルまたはフォルダーを指定できるソース ドキュメントの場所。 この場所は、Azure BLOB ストレージからの URL リンクです。 |
|
プレフィックス フィルター
|
documentFilterPrefix | string |
変換のソース パス内のドキュメントをフィルター処理するための、大文字と小文字を区別するプレフィックス文字列。 たとえば、Azure Storage BLOB URI を使用する場合は、プレフィックスを使用して翻訳用のサブ フォルダーを制限します。 |
|
|
サフィックス フィルター
|
documentFilterSuffix | string |
変換のソース パス内のドキュメントをフィルター処理するための、大文字と小文字を区別するサフィックス文字列。 最も多くの場合、ファイル拡張子に使用されます。 |
|
|
カテゴリ
|
targetCategory | string |
翻訳のカテゴリ (ドメイン) を指定する文字列。 このパラメーターは、Custom Translator で構築されたカスタマイズされたシステムから翻訳を取得するために使用されます。 |
|
|
翻訳されたドキュメントの場所
|
targetContainerURL | True | string |
翻訳されたドキュメントが格納される場所。 この場所は、Azure BLOB ストレージからの URL リンクです。 |
|
目標言語
|
targetLanguage | True | string |
ターゲット言語コード。 |
|
用語集の URL
|
glossaryUrl | string |
用語集ドキュメントの場所。 この場所は、Azure BLOB ストレージからの URL リンクです。 |
|
|
用語集ドキュメントの形式とバージョン
|
glossaryFormatVersion | string |
用語集ドキュメントの形式とバージョン。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
operationID
|
operationID | string |
操作 ID。 |
翻訳の取り消し
現在処理中またはキューに登録されているドキュメント翻訳ジョブを取り消します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
戻り値
翻訳の状態を取得する
特定のドキュメント翻訳要求の状態の概要を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
戻り値
翻訳の状態を取得する
ユーザーによって送信されたすべての翻訳要求の状態と共にリストを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
返されるレコードの合計数
|
$top | integer |
ユーザーがすべてのページにわたって返すレコードの合計数。 |
|
|
スキップするレコードの数
|
$skip | integer |
並べ替え方法に基づいてリストからスキップするレコードの数。 |
|
|
返される最大レコード数
|
$maxpagesize | integer |
ページで返される最大レコード数。 |
|
|
並べ替え順
|
$orderBy | array |
コレクションの並べ替えクエリ 。例: CreatedDateTimeUtc asc'、'CreatedDateTimeUtc desc'。 |
|
|
start datetime
|
createdDateTimeUtcStart | date-time |
レコードを取得する開始日時。 |
|
|
終了日時
|
createdDateTimeUtcEnd | date-time |
レコードを取得する前の終了日時。 |
|
|
状態でフィルター処理する
|
statuses | array |
フィルター処理で使用する状態。 |
|
|
操作 ID でフィルター処理する
|
ids | array |
フィルター処理で使用する操作 ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of TranslationStatusResponse |
応答値。 |
|
@nextLink
|
@nextLink | string |
次のページの URL。 最後のページの場合は Null。 |
言語を取得する
Microsoft Azure Cognitive Services Translator で翻訳がサポートされているすべての言語を取得します。
戻り値
- response
- array of Language
定義
TranslationResults
翻訳結果。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
翻訳されたテキスト
|
TranslatedText | string |
翻訳されたテキストを取得します。 |
|
音訳されたテキスト
|
TransliteratedText | string |
音訳されたテキストを取得します。 |
TransliterationResults
表記変換の結果。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
テキスト
|
text | string |
音訳されたテキストを取得します。 |
|
スクリプト
|
script | string |
表記変換されたスクリプト。 |
Language
言語コード。 指定されていない場合、Microsoft Translator はドキュメント言語の自動検出を試みます。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
言語コード
|
Code | string |
言語コードを取得または設定します。 |
|
Language
|
Name | string |
言語を取得または設定します。 |
FormatOKResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of object |
詳細を含むファイル形式。 |
|
format
|
value.format | string |
ドキュメント形式の名前。 |
|
fileExtensions
|
value.fileExtensions | array of string |
この形式でサポートされているファイル拡張子。 |
|
contentTypes
|
value.contentTypes | array of string |
この形式でサポートされているコンテンツ タイプ。 |
|
versions
|
value.versions | array of string |
サポートされているバージョン。 |
|
デフォルトバージョン
|
value.defaultVersion | string |
何も指定されていない場合の既定のバージョン。 |
TranslationStatusResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string |
操作の ID。 |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
操作の作成日時。 |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
操作の状態が更新された日時。 |
|
状態
|
status | string |
取り消し、取り消し、失敗、未開始、実行中、成功、ValidationFailed など、ジョブまたはドキュメントで使用可能な状態の一覧。 |
|
トータル
|
summary.total | integer |
ドキュメントの合計数。 |
|
失敗
|
summary.failed | integer |
失敗したドキュメントの数。 |
|
success
|
summary.success | integer |
正常に翻訳されたドキュメントの数。 |
|
inProgress
|
summary.inProgress | integer |
進行中のドキュメントの数。 |
|
notYetStarted
|
summary.notYetStarted | integer |
まだ処理を開始していないドキュメントの数。 |
|
cancelled
|
summary.cancelled | integer |
取り消されたドキュメントの数。 |
|
totalCharacterCharged
|
summary.totalCharacterCharged | integer |
課金される文字の合計数。 |
DocumentStatusResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
パス
|
path | string |
ドキュメントまたはフォルダーの場所。 |
|
ソースパス
|
sourcePath | string |
ソース ドキュメントの場所。 |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
操作の作成日時。 |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
操作の状態が更新された日時。 |
|
状態
|
status | string |
取り消し、取り消し、失敗、未開始、実行中、成功、ValidationFailed など、ジョブまたはドキュメントで使用可能な状態の一覧。 |
|
送信先
|
to | string |
目標言語。 |
|
進捗
|
progress | integer |
翻訳の進行状況 (使用可能な場合)。 |
|
id
|
id | string |
ドキュメント ID。 |
|
characterCharged
|
characterCharged | integer |
API によって課金される文字。 |