翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
TranslateText
入力テキストをソース言語からターゲット言語に翻訳します。使用可能な言語と言語コードのリストについては、「」を参照してくださいサポートされている言語と言語コード。
リクエストの構文
{
"Settings": {
"Formality": "string
",
"Profanity": "string
"
},
"SourceLanguageCode": "string
",
"TargetLanguageCode": "string
",
"TerminologyNames": [ "string
" ],
"Text": "string
"
}
リクエストパラメータ
すべてのアクションに共通のパラメーターの詳細については、「共通パラメータ」を参照してください。
リクエストは以下の JSON 形式のデータを受け入れます。
- Settings
-
出力テキストの形式レベルを設定するオプションや、不敬な単語やフレーズを隠すオプションなど、翻訳出力を構成するための設定。
型: TranslationSettings オブジェクト
: 必須 いいえ
- SourceLanguageCode
-
ソーステキストの言語コード。言語は Amazon Translate でサポートされている言語である必要があります。言語コードのリストについては、「サポートされている言語と言語コード」を参照してください。
Amazon Translate でテキストのソース言語を決定させるには、
auto
のSourceLanguageCode
フィールド。を指定した場合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 を使用する方法の詳細については、次を参照してください: