次の方法で共有


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

翻訳するテキスト。

戻り値

言語を取得する

Microsoft Azure Cognitive Services Translator による翻訳がサポートされているすべての言語を取得します。

戻り値

定義

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 で課金される文字。