Microsoft Translator V3 (プレビュー)
Microsoft Azure Cognitive Services Translator を使用すると、一般モデルまたはカスタム モデルを使用して 100 を超える言語のテキストやドキュメントを翻訳できます。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure China の地域 - 米国国防総省 (DoD) |
| Power Automate | Standard | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Microsoft Translator |
| [URL] | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| メール | mtfb@microsoft.com |
| Connector Metadata | |
|---|---|
| 発行者 | Microsoft Translator |
| Web サイト | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| プライバシー ポリシー | https://privacy.microsoft.com/ |
| カテゴリー | AI;ビジネス インテリジェンス |
Azure Cognitive Services Translator コネクタを使用すると、Power Platform Flow や Power App などの Power Automate のコンポーネントを 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
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| Translator リソース名 | string | Microsoft Translator リソース名を入力する | True |
| リソース キー | securestring | Translator の Azure Cognitive Services リソース キー。 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| サポートされるストレージ ソースを取得する |
サポートされるストレージ ソース/オプションの一覧を取得します。 |
| サポートされるドキュメント形式を取得する |
サポートされるドキュメント形式の一覧を取得します。 |
| サポートされる用語集形式を取得する |
サポートされる用語集形式の一覧を取得します。 |
| テキストの翻訳 |
指定したソース言語テキストをターゲット言語テキストに翻訳します。 |
| ドキュメントの状態を取得する |
ジョブ内の特定のドキュメントの状態を取得します。 |
| ドキュメントの状態を取得する |
翻訳ジョブ内のすべてのドキュメントの状態を取得します。 |
| ドキュメント翻訳を開始する |
このアクションでドキュメント翻訳ジョブを開始します。 |
| 翻訳の状態を取得する |
指定したドキュメント翻訳要求の状態の概要を取得します。 |
| 翻訳の状態を取得する |
ユーザーが送信したすべての翻訳要求の状態とともに一覧を取得します。 |
| 翻訳をキャンセルする |
現在処理中またはキューに入れられているドキュメント翻訳ジョブをキャンセルします。 |
| 表記変換 |
ある言語でテキストをあるスクリプトから別のスクリプトに変換します。 |
| 言語を取得する |
Microsoft Azure Cognitive Services Translator による翻訳がサポートされているすべての言語を取得します。 |
サポートされるストレージ ソースを取得する
サポートされるストレージ ソース/オプションの一覧を取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
価値
|
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 |
翻訳のカテゴリ (ドメイン) を指定する文字列。 このパラメータは、カスタム翻訳ツールで構築されたカスタマイズ システムから翻訳を取得するために使用されます。 |
|
|
一般ドメインへのフォールバックを許可する
|
allowFallback | string |
カスタム システムが存在しない場合に、サービスが一般システムにフォールバックできることを指定します。 |
|
|
Text
|
Text | True | string |
翻訳するテキスト。 |
戻り値
ドキュメントの状態を取得する
ジョブ内の特定のドキュメントの状態を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
|
Document ID
|
documentId | True | string |
ドキュメント ID。 |
戻り値
ドキュメントの状態を取得する
翻訳ジョブ内のすべてのドキュメントの状態を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
|
返されるレコードの合計数
|
$top | integer |
すべてのページで返されるレコードの合計数。 |
|
|
スキップするレコードの数
|
$skip | integer |
ソート方法に基づいて一覧からスキップされるレコードの数。 |
|
|
返されるレコードの最大数
|
$maxpagesize | integer |
ページで返されるレコードの最大数。 |
|
|
並べ替え順
|
$orderBy | array |
コレクションのクエリを並べ替えます。 (例: 'CreatedDateTimeUtc asc'、'CreatedDateTimeUtc desc')。 |
|
|
開始日時
|
createdDateTimeUtcStart | date-time |
アイテムの取得を開始する日時。 |
|
|
終了日時
|
createdDateTimeUtcEnd | date-time |
アイテムの取得を終了する日時。 |
|
|
状態でフィルター処理する
|
statuses | array |
フィルター処理に使用する状態。 |
|
|
ドキュメント ID でフィルター処理する
|
ids | array |
フィルター処理に使用するドキュメント ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
価値
|
value | array of object |
応答値。 |
|
パス
|
value.path | string |
フォルダーのドキュメントの場所。 |
|
sourcePath
|
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 |
ソースドキュメントの場所 (単一のファイルまたはフォルダー)。 この場所は、Azure Blob Storage からの URL リンクです。 |
|
接頭辞フィルター
|
documentFilterPrefix | string |
翻訳のソース パス内のドキュメントをフィルター処理するための大文字と小文字を区別する接頭辞文字列。 たとえば、Azure Storage BLOB URI を使用する場合、接頭辞を使用して翻訳用のサブ フォルダーを制限します。 |
|
|
接尾辞フィルター
|
documentFilterSuffix | string |
翻訳のソース パス内のドキュメントをフィルター処理するための大文字と小文字を区別する接尾辞文字列。 ファイル拡張子に最もよく使用されます。 |
|
|
カテゴリー
|
targetCategory | string |
翻訳のカテゴリ (ドメイン) を指定する文字列。 このパラメータは、カスタム翻訳ツールで構築されたカスタマイズ システムから翻訳を取得するために使用されます。 |
|
|
翻訳済みドキュメントの場所
|
targetContainerURL | True | string |
翻訳済みのドキュメントを保存する場所。 この場所は、Azure Blob Storage からの URL リンクです。 |
|
ターゲット言語
|
targetLanguage | True | string |
ターゲット言語コード |
|
用語集 URL
|
glossaryUrl | string |
用語集ドキュメントの場所。 この場所は、Azure Blob Storage からの URL リンクです。 |
|
|
用語集ドキュメントの形式とバージョン
|
glossaryFormatVersion | string |
用語集ドキュメントの形式とバージョン。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
operationID
|
operationID | string |
操作 ID。 |
翻訳の状態を取得する
指定したドキュメント翻訳要求の状態の概要を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
戻り値
翻訳の状態を取得する
ユーザーが送信したすべての翻訳要求の状態とともに一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
返されるレコードの合計数
|
$top | integer |
すべてのページで返されるレコードの合計数。 |
|
|
スキップするレコードの数
|
$skip | integer |
ソート方法に基づいて一覧からスキップされるレコードの数。 |
|
|
返されるレコードの最大数
|
$maxpagesize | integer |
ページで返されるレコードの最大数。 |
|
|
並べ替え順
|
$orderBy | array |
コレクションのクエリを並べ替えます (例: 'CreatedDateTimeUtc asc'、'CreatedDateTimeUtc desc')。 |
|
|
開始日時
|
createdDateTimeUtcStart | date-time |
レコードの取得を開始する日時。 |
|
|
終了日時
|
createdDateTimeUtcEnd | date-time |
レコードの取得を終了する日時。 |
|
|
状態でフィルター処理する
|
statuses | array |
フィルター処理に使用する状態。 |
|
|
操作 ID でフィルター処理
|
ids | array |
フィルター処理に使用する操作 ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
価値
|
value | array of TranslationStatusResponse |
応答値。 |
|
@nextLink
|
@nextLink | string |
次のページの URL。 最後のページの場合は null。 |
翻訳をキャンセルする
現在処理中またはキューに入れられているドキュメント翻訳ジョブをキャンセルします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
id | True | string |
操作 ID。 |
戻り値
表記変換
ある言語でテキストをあるスクリプトから別のスクリプトに変換します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Language
|
language | True | string |
あるスクリプトから別のスクリプトに変換するテキストの言語を指定します。 |
|
ソース スクリプト
|
fromScript | True | string |
入力テキストのスクリプトの名前。 |
|
対象のスクリプト
|
toScript | True | string |
表記変換されるテキストのスクリプトの名前。 |
|
Text
|
Text | True | string |
翻訳するテキスト。 |
戻り値
言語を取得する
定義
TranslationResults
翻訳結果。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
翻訳されたテキスト
|
TranslatedText | string |
翻訳済みのテキストを取得します。 |
|
表記変換済みテキスト
|
TransliteratedText | string |
表記変換済みのテキストを取得します。 |
TransliterationResults
表記変換結果。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Text
|
text | string |
表記変換済みのテキストを取得します。 |
|
スクリプト
|
script | string |
表記変換済みスクリプト。 |
Language
言語コード。 何も指定しない場合、Microsoft Translator によってドキュメント言語の自動検出が試行されます。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
言語コード
|
Code | string |
言語コードの取得または設定。 |
|
Language
|
Name | string |
言語を取得または設定します。 |
FormatOKResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
価値
|
value | array of object |
詳細を含むファイル形式。 |
|
format
|
value.format | string |
ドキュメント形式の名前。 |
|
fileExtensions
|
value.fileExtensions | array of string |
この形式でサポートされるファイル拡張子。 |
|
contentTypes
|
value.contentTypes | array of string |
この形式でサポートされているコンテンツ タイプ。 |
|
バージョン
|
value.versions | array of string |
サポートされるバージョン。 |
|
defaultVersion
|
value.defaultVersion | string |
何も指定しない場合の既定のバージョン。 |
TranslationStatusResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string |
操作の ID。 |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
操作の作成日時。 |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
操作の状態が更新された日時。 |
|
ステータス
|
status | string |
ジョブまたはドキュメントで有効な状態の一覧 (Canceled、Cancelling、Failed、NotStarted、Running、Succeeded、ValidationFailed など)。 |
|
total
|
summary.total | integer |
ドキュメントの総数。 |
|
失敗
|
summary.failed | integer |
失敗したドキュメントの数。 |
|
成功
|
summary.success | integer |
正常に翻訳されたドキュメントの数。 |
|
inProgress
|
summary.inProgress | integer |
現在処理中のドキュメントの数。 |
|
notYetStarted
|
summary.notYetStarted | integer |
まだ処理が開始されていないドキュメントの数。 |
|
キャンセル済み
|
summary.cancelled | integer |
キャンセルしたドキュメントの数。 |
|
totalCharacterCharged
|
summary.totalCharacterCharged | integer |
課金された合計文字数。 |
DocumentStatusResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
パス
|
path | string |
フォルダーのドキュメントの場所。 |
|
sourcePath
|
sourcePath | string |
ソース ドキュメントの場所。 |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
操作の作成日時。 |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
操作の状態が更新された日時。 |
|
ステータス
|
status | string |
ジョブまたはドキュメントで有効な状態の一覧 (Canceled、Cancelling、Failed、NotStarted、Running、Succeeded、ValidationFailed など)。 |
|
送信先
|
to | string |
ターゲット言語。 |
|
進行状況
|
progress | integer |
翻訳の進行状況 (使用可能な場合)。 |
|
id
|
id | string |
ドキュメント ID。 |
|
characterCharged
|
characterCharged | integer |
API で課金される文字。 |