翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
TranslateText
入力テキストをソース言語からターゲット言語に翻訳します。使用可能な言語と言語コードのリストについては、「」を参照してください。サポートされている言語と言語コード。
リクエストの構文
{
"SourceLanguageCode": "string",
"TargetLanguageCode": "string",
"TerminologyNames": [ "string" ],
"Text": "string"
}リクエストパラメータ
すべてのアクションに共通のパラメータについては、「」を参照してください。共通パラメータ。
リクエストは以下のデータを JSON 形式で受け入れます。
- 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 です。
Pattern:
^([A-Za-z0-9-]_?)+$必須: いいえ
- Text
-
翻訳するテキストを指定します。テキスト文字列は 5,000 バイトまでです。キャラクタセットによっては、5,000 文字未満になる場合があります。
Type: 文字列
長さの制限: 最小長は 1 です｡ 最大長は 5000 です。
Pattern:
[\P{M}\p{M}]{1,5000}必須: はい
レスポンスの構文
{
"AppliedTerminologies": [
{
"Name": "string",
"Terms": [
{
"SourceText": "string",
"TargetText": "string"
}
]
}
],
"SourceLanguageCode": "string",
"TargetLanguageCode": "string",
"TranslatedText": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- AppliedTerminologies
-
翻訳されたテキストレスポンスに対して Amazon Translate が入力テキストに適用するカスタム用語の名前。
Type: 配列: AppliedTerminology objects
- SourceLanguageCode
-
ソーステキストの言語コード。
Type: 文字列
長さの制限: 最小長は 2 です｡ 最大長は 5 です。
- TargetLanguageCode
-
ターゲットテキストの言語コード。
Type: 文字列
長さの制限: 最小長は 2 です｡ 最大長は 5 です。
- TranslatedText
-
翻訳されたテキストです。
Type: 文字列
長さの制限: 最大長は 10000 です。
Pattern:
[\P{M}\p{M}]{0,10000}
Errors
すべてのアクションに共通のエラーについては、「一般的なエラー」を参照してください。
- 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
以下の資料も参照してください。
言語固有の API のいずれかでこの API を使用する方法の詳細については、AWSSDK については、以下を参照してください。
