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 による翻訳がサポートされているすべての言語を取得します。

サポートされるストレージ ソースを取得する

操作 ID:

GetSupportedStorageSources

サポートされるストレージ ソース/オプションの一覧を取得します。

戻り値

名前	パス	型	説明
価値	value	array of string	応答値。

サポートされるドキュメント形式を取得する

操作 ID:

GetSupportedDocumentFormats

サポートされるドキュメント形式の一覧を取得します。

戻り値

Body

FormatOKResponse

サポートされる用語集形式を取得する

操作 ID:

GetSupportedGlossaryFormats

サポートされる用語集形式の一覧を取得します。

戻り値

Body

FormatOKResponse

テキストの翻訳

操作 ID:

Translate

指定したソース言語テキストをターゲット言語テキストに翻訳します。

パラメーター

名前	キー	必須	型	説明
ソース言語	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	翻訳するテキスト。

戻り値

返答

array of TranslationResults

ドキュメントの状態を取得する

操作 ID:

GetDocumentStatus

ジョブ内の特定のドキュメントの状態を取得します。

パラメーター

名前	キー	必須	型	説明
操作 ID	id	True	string	操作 ID。
Document ID	documentId	True	string	ドキュメント ID。

戻り値

Body

DocumentStatusResponse

ドキュメントの状態を取得する

操作 ID:

GetDocumentsStatus

翻訳ジョブ内のすべてのドキュメントの状態を取得します。

パラメーター

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

ドキュメント翻訳を開始する

操作 ID:

StartDocumentTranslation

このアクションでドキュメント翻訳ジョブを開始します。

パラメーター

名前	キー	必須	型	説明
入力ドキュメントのストレージ タイプ	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:

GetTranslationStatus

指定したドキュメント翻訳要求の状態の概要を取得します。

パラメーター

名前	キー	必須	型	説明
操作 ID	id	True	string	操作 ID。

戻り値

Body

TranslationStatusResponse

翻訳の状態を取得する

操作 ID:

GetTranslationsStatus

ユーザーが送信したすべての翻訳要求の状態とともに一覧を取得します。

パラメーター

名前	キー	必須	型	説明
返されるレコードの合計数	$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:

CancelTranslation

現在処理中またはキューに入れられているドキュメント翻訳ジョブをキャンセルします。

パラメーター

名前	キー	必須	型	説明
操作 ID	id	True	string	操作 ID。

戻り値

Body

TranslationStatusResponse

表記変換

操作 ID:

Transliterate

ある言語でテキストをあるスクリプトから別のスクリプトに変換します。

パラメーター

名前	キー	必須	型	説明
Language	language	True	string	あるスクリプトから別のスクリプトに変換するテキストの言語を指定します。
ソース スクリプト	fromScript	True	string	入力テキストのスクリプトの名前。
対象のスクリプト	toScript	True	string	表記変換されるテキストのスクリプトの名前。
Text	Text	True	string	翻訳するテキスト。

戻り値

返答

array of TransliterationResults

言語を取得する

操作 ID:

GetTranslateSupportedLanguages

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

戻り値

返答

array of Language

定義

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