TranslateText - Amazon Translate

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

TranslateText

入力テキストをソース言語からターゲット言語に翻訳します。使用可能な言語と言語コードのリストについては、「」を参照してくださいサポートされている言語と言語コード

リクエストの構文

{ "Settings": { "Formality": "string", "Profanity": "string" }, "SourceLanguageCode": "string", "TargetLanguageCode": "string", "TerminologyNames": [ "string" ], "Text": "string" }

リクエストパラメータ

すべてのアクションに共通のパラメーターの詳細については、「共通パラメータ」を参照してください。

リクエストは以下の JSON 形式のデータを受け入れます。

Settings

出力テキストの形式レベルを設定するオプションや、不敬な単語やフレーズを隠すオプションなど、翻訳出力を構成するための設定。

型: TranslationSettings オブジェクト

: 必須 いいえ

SourceLanguageCode

ソーステキストの言語コード。言語は Amazon Translate でサポートされている言語である必要があります。言語コードのリストについては、「サポートされている言語と言語コード」を参照してください。

Amazon Translate でテキストのソース言語を決定させるには、autoSourceLanguageCodeフィールド。を指定した場合auto、Amazon Translateが電話するAmazon Comprehendでソース言語を決定できます。

Type: 文字列

長さの制約: 最小長は 2 です。 最大長は 5 です。

: 必須 はい

TargetLanguageCode

ターゲットテキストの言語に対して要求された言語コード。言語は Amazon Translate でサポートされている言語である必要があります。

Type: 文字列

長さの制約: 最小長は 2 です。 最大長は 5 です。

: 必須 はい

TerminologyNames

TranslateText リクエストで使用される用語リストファイルの名前。最大で 1 つの用語リストを使用できます。TranslateTextリクエスト. 用語リストには、最大 256 の用語を含めることができます。

Type: 文字列の配列

長さの制約: 最小長は 1 です。 最大長は 256 です。

パターン: ^([A-Za-z0-9-]_?)+$

: 必須 いいえ

Text

翻訳するテキスト。テキスト文字列は、最大 5,000 バイトまでです。キャラクタセットによっては、5,000 文字未満になる場合があります。

Type: 文字列

長さの制約: 最小長は 1 です。 最大長は 5,000 です。

パターン: [\P{M}\p{M}]{1,5000}

: 必須 はい

レスポンスの構文

{ "AppliedSettings": { "Formality": "string", "Profanity": "string" }, "AppliedTerminologies": [ { "Name": "string", "Terms": [ { "SourceText": "string", "TargetText": "string" } ] } ], "SourceLanguageCode": "string", "TargetLanguageCode": "string", "TranslatedText": "string" }

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

AppliedSettings

変換出力を構成する設定。

型: TranslationSettings オブジェクト

AppliedTerminologies

Amazon Translate によって翻訳されたテキストレスポンスの入力テキストに適用されるカスタム用語の名前。

Type: の配列AppliedTerminologyオブジェクト

SourceLanguageCode

ソーステキストの言語コード。

Type: 文字列

長さの制約: 最小長は 2 です。 最大長は 5 です。

TargetLanguageCode

ターゲットテキストの言語コード。

Type: 文字列

長さの制約: 最小長は 2 です。 最大長は 5 です。

TranslatedText

が翻訳されたテキスト。

Type: 文字列

長さの制約: 最大長は 10,000 です。

パターン: [\P{M}\p{M}]{0,10000}

エラー

すべてのアクションに共通のエラーについては、「一般的なエラー」を参照してください。

DetectedLanguageLowConfidenceException

Amazon Comprehend がソース言語を正確に検出した信頼度は低いです。信頼性のレベルが低い場合でも、それが許容される範囲である場合は例外で言語を使用して Amazon Translate を再度呼び出すことができます。詳細については、「」を参照してください。ドミナント言語を検出するのオペレーションAmazon Comprehend 開発者ガイドガイド

HTTP ステータスコード: 400

InternalServerException

内部サーバーエラーが発生しました。リクエストを再実行します。

HTTP ステータスコード: 500

InvalidRequestException

あなたが行ったリクエストは有効ではありません。リクエストを確認して有効でない理由を判断し、リクエストを再試行してください。

HTTP ステータスコード: 400

ResourceNotFoundException

お探しのリソースが見つかりませんでした。変更後のリクエストを再試行する前に、探しているリソースを確認し、別のリソースがニーズを満たすかどうかを確認します。

HTTP ステータスコード: 400

ServiceUnavailableException

Amazon Translate サービスが一時的に使用できません 少し待ってから、リクエストを再試行してください。

HTTP ステータスコード: 500

TextSizeLimitExceededException

送信したテキストのサイズがサイズ制限を超えています。テキストのサイズを小さくするか、小さいドキュメントを使用してから、リクエストを再試行してください。

HTTP ステータスコード: 400

TooManyRequestsException

短期間でリクエストが多すぎました。しばらく待ってから、リクエストを再度試みてください。

HTTP ステータスコード: 400

UnsupportedLanguagePairException

Amazon Translate は、ソーステキストの言語から要求されたターゲット言語への翻訳をサポートしていません。詳細については、「例外処理」を参照してください。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください: