aws-sdk-translate 1.50.0 → 1.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 676b1460e9db8fd1bcc03d1df47d3d617bc6a9df9ff82ce60af865c46efd4ddb
-  data.tar.gz: 2b4d28dc78204a0cd43cc80032a216c19edc46df8a0dc1dcba37182da2ff426d
+  metadata.gz: 58b2f09fd6d7932e95f8beb86a52dc0e8c6ee5b3cfe67cc40b12a9d60187502e
+  data.tar.gz: d5415777d6625dc807b4178aa046e68e1fe5b7d7afb4e058f987b2973c25dd08
 SHA512:
-  metadata.gz: bc0fc2fbfe387ccf63f68192eb7a7bdf23bace72cdad74d9c405804a075e8541cbac36cb61774cdceebbe72dca511e6d365bb712a3fa007c5d93f46682c73ee7
-  data.tar.gz: a08f5040bae463631a74ed006231b8699b6bf7c7742d2833b3e53f987f56b7c3890eb422ed3de17ef2942ae6ac0e8f419df8cf843510c11721fb7c5560ab8c20
+  metadata.gz: b2aea410b774f8846d72a120752dd364de9852d4f973d8d11d82901f1b5f5b6994664b1b53fcaf6f41471591cd9833f38f85d31f21dc91fd314cffb54285c051
+  data.tar.gz: 14cc7ba496daa9fbea3750db44e05a189e8f5a8d9d4dbb769e100febbc1c861abafa4f98205d9d6507284209a62191beaa47eab111bdcf967b4d98ceb52c95ae

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.51.0 (2023-05-23)
+------------------
+
+* Feature - Added support for calling TranslateDocument API.
+
 1.50.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.50.0
+1.51.0

data/lib/aws-sdk-translate/client.rb

@@ -1289,6 +1289,112 @@ module Aws::Translate
       req.send_request(options)
     end
 
+    # Translates the input document from the source language to the target
+    # language. This synchronous operation supports plain text or HTML for
+    # the input document. `TranslateDocument` supports translations from
+    # English to any supported language, and from any supported language to
+    # English. Therefore, specify either the source language code or the
+    # target language code as “en” (English).
+    #
+    # `TranslateDocument` does not support language auto-detection.
+    #
+    # If you set the `Formality` parameter, the request will fail if the
+    # target language does not support formality. For a list of target
+    # languages that support formality, see [Setting formality][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-formality.html
+    #
+    # @option params [required, Types::Document] :document
+    #   The content and content type for the document to be translated. The
+    #   document size must not exceed 100 KB.
+    #
+    # @option params [Array<String>] :terminology_names
+    #   The name of a terminology list file to add to the translation job.
+    #   This file provides source terms and the desired translation for each
+    #   term. A terminology list can contain a maximum of 256 terms. You can
+    #   use one custom terminology resource in your translation request.
+    #
+    #   Use the ListTerminologies operation to get the available terminology
+    #   lists.
+    #
+    #   For more information about custom terminology lists, see [Custom
+    #   terminology][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/how-custom-terminology.html
+    #
+    # @option params [required, String] :source_language_code
+    #   The language code for the language of the source text. Do not use
+    #   `auto`, because `TranslateDocument` does not support language
+    #   auto-detection. For a list of supported language codes, see [Supported
+    #   languages][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
+    #
+    # @option params [required, String] :target_language_code
+    #   The language code requested for the translated document. For a list of
+    #   supported language codes, see [Supported languages][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
+    #
+    # @option params [Types::TranslationSettings] :settings
+    #   Settings to configure your translation output, including the option to
+    #   set the formality level of the output text and the option to mask
+    #   profane words and phrases.
+    #
+    # @return [Types::TranslateDocumentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::TranslateDocumentResponse#translated_document #translated_document} => Types::TranslatedDocument
+    #   * {Types::TranslateDocumentResponse#source_language_code #source_language_code} => String
+    #   * {Types::TranslateDocumentResponse#target_language_code #target_language_code} => String
+    #   * {Types::TranslateDocumentResponse#applied_terminologies #applied_terminologies} => Array&lt;Types::AppliedTerminology&gt;
+    #   * {Types::TranslateDocumentResponse#applied_settings #applied_settings} => Types::TranslationSettings
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.translate_document({
+    #     document: { # required
+    #       content: "data", # required
+    #       content_type: "ContentType", # required
+    #     },
+    #     terminology_names: ["ResourceName"],
+    #     source_language_code: "LanguageCodeString", # required
+    #     target_language_code: "LanguageCodeString", # required
+    #     settings: {
+    #       formality: "FORMAL", # accepts FORMAL, INFORMAL
+    #       profanity: "MASK", # accepts MASK
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.translated_document.content #=> String
+    #   resp.source_language_code #=> String
+    #   resp.target_language_code #=> String
+    #   resp.applied_terminologies #=> Array
+    #   resp.applied_terminologies[0].name #=> String
+    #   resp.applied_terminologies[0].terms #=> Array
+    #   resp.applied_terminologies[0].terms[0].source_text #=> String
+    #   resp.applied_terminologies[0].terms[0].target_text #=> String
+    #   resp.applied_settings.formality #=> String, one of "FORMAL", "INFORMAL"
+    #   resp.applied_settings.profanity #=> String, one of "MASK"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateDocument AWS API Documentation
+    #
+    # @overload translate_document(params = {})
+    # @param [Hash] params ({})
+    def translate_document(params = {}, options = {})
+      req = build_request(:translate_document, params)
+      req.send_request(options)
+    end
+
     # Translates input text from the source language to the target language.
     # For a list of available languages and language codes, see [Supported
     # languages][1].
@@ -1303,13 +1409,23 @@ module Aws::Translate
     #   10,000 characters.
     #
     # @option params [Array<String>] :terminology_names
-    #   The name of the terminology list file to be used in the TranslateText
-    #   request. You can use 1 terminology list at most in a `TranslateText`
-    #   request. Terminology lists can contain a maximum of 256 terms.
+    #   The name of a terminology list file to add to the translation job.
+    #   This file provides source terms and the desired translation for each
+    #   term. A terminology list can contain a maximum of 256 terms. You can
+    #   use one custom terminology resource in your translation request.
+    #
+    #   Use the ListTerminologies operation to get the available terminology
+    #   lists.
+    #
+    #   For more information about custom terminology lists, see [Custom
+    #   terminology][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/how-custom-terminology.html
     #
     # @option params [required, String] :source_language_code
-    #   The language code for the language of the source text. The language
-    #   must be a language supported by Amazon Translate. For a list of
+    #   The language code for the language of the source text. For a list of
     #   language codes, see [Supported languages][1].
     #
     #   To have Amazon Translate determine the source language of your text,
@@ -1329,8 +1445,12 @@ module Aws::Translate
     #   [2]: https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-general.html
     #
     # @option params [required, String] :target_language_code
-    #   The language code requested for the language of the target text. The
-    #   language must be a language supported by Amazon Translate.
+    #   The language code requested for the language of the target text. For a
+    #   list of language codes, see [Supported languages][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
     #
     # @option params [Types::TranslationSettings] :settings
     #   Settings to configure your translation output, including the option to
@@ -1482,7 +1602,7 @@ module Aws::Translate
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-translate'
-      context[:gem_version] = '1.50.0'
+      context[:gem_version] = '1.51.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-translate/client_api.rb

@@ -31,6 +31,8 @@ module Aws::Translate
     DetectedLanguageLowConfidenceException = Shapes::StructureShape.new(name: 'DetectedLanguageLowConfidenceException')
     Directionality = Shapes::StringShape.new(name: 'Directionality')
     DisplayLanguageCode = Shapes::StringShape.new(name: 'DisplayLanguageCode')
+    Document = Shapes::StructureShape.new(name: 'Document')
+    DocumentContent = Shapes::BlobShape.new(name: 'DocumentContent')
     EncryptionKey = Shapes::StructureShape.new(name: 'EncryptionKey')
     EncryptionKeyID = Shapes::StringShape.new(name: 'EncryptionKeyID')
     EncryptionKeyType = Shapes::StringShape.new(name: 'EncryptionKeyType')
@@ -116,8 +118,12 @@ module Aws::Translate
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     TooManyRequestsException = Shapes::StructureShape.new(name: 'TooManyRequestsException')
     TooManyTagsException = Shapes::StructureShape.new(name: 'TooManyTagsException')
+    TranslateDocumentRequest = Shapes::StructureShape.new(name: 'TranslateDocumentRequest')
+    TranslateDocumentResponse = Shapes::StructureShape.new(name: 'TranslateDocumentResponse')
     TranslateTextRequest = Shapes::StructureShape.new(name: 'TranslateTextRequest')
     TranslateTextResponse = Shapes::StructureShape.new(name: 'TranslateTextResponse')
+    TranslatedDocument = Shapes::StructureShape.new(name: 'TranslatedDocument')
+    TranslatedDocumentContent = Shapes::BlobShape.new(name: 'TranslatedDocumentContent')
     TranslatedTextString = Shapes::StringShape.new(name: 'TranslatedTextString')
     TranslationSettings = Shapes::StructureShape.new(name: 'TranslationSettings')
     UnboundedLengthString = Shapes::StringShape.new(name: 'UnboundedLengthString')
@@ -172,6 +178,10 @@ module Aws::Translate
     DetectedLanguageLowConfidenceException.add_member(:detected_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, location_name: "DetectedLanguageCode"))
     DetectedLanguageLowConfidenceException.struct_class = Types::DetectedLanguageLowConfidenceException
 
+    Document.add_member(:content, Shapes::ShapeRef.new(shape: DocumentContent, required: true, location_name: "Content"))
+    Document.add_member(:content_type, Shapes::ShapeRef.new(shape: ContentType, required: true, location_name: "ContentType"))
+    Document.struct_class = Types::Document
+
     EncryptionKey.add_member(:type, Shapes::ShapeRef.new(shape: EncryptionKeyType, required: true, location_name: "Type"))
     EncryptionKey.add_member(:id, Shapes::ShapeRef.new(shape: EncryptionKeyID, required: true, location_name: "Id"))
     EncryptionKey.struct_class = Types::EncryptionKey
@@ -427,6 +437,20 @@ module Aws::Translate
     TooManyTagsException.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, location_name: "ResourceArn"))
     TooManyTagsException.struct_class = Types::TooManyTagsException
 
+    TranslateDocumentRequest.add_member(:document, Shapes::ShapeRef.new(shape: Document, required: true, location_name: "Document"))
+    TranslateDocumentRequest.add_member(:terminology_names, Shapes::ShapeRef.new(shape: ResourceNameList, location_name: "TerminologyNames"))
+    TranslateDocumentRequest.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "SourceLanguageCode"))
+    TranslateDocumentRequest.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "TargetLanguageCode"))
+    TranslateDocumentRequest.add_member(:settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "Settings"))
+    TranslateDocumentRequest.struct_class = Types::TranslateDocumentRequest
+
+    TranslateDocumentResponse.add_member(:translated_document, Shapes::ShapeRef.new(shape: TranslatedDocument, required: true, location_name: "TranslatedDocument"))
+    TranslateDocumentResponse.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "SourceLanguageCode"))
+    TranslateDocumentResponse.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "TargetLanguageCode"))
+    TranslateDocumentResponse.add_member(:applied_terminologies, Shapes::ShapeRef.new(shape: AppliedTerminologyList, location_name: "AppliedTerminologies"))
+    TranslateDocumentResponse.add_member(:applied_settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "AppliedSettings"))
+    TranslateDocumentResponse.struct_class = Types::TranslateDocumentResponse
+
     TranslateTextRequest.add_member(:text, Shapes::ShapeRef.new(shape: BoundedLengthString, required: true, location_name: "Text"))
     TranslateTextRequest.add_member(:terminology_names, Shapes::ShapeRef.new(shape: ResourceNameList, location_name: "TerminologyNames"))
     TranslateTextRequest.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "SourceLanguageCode"))
@@ -441,6 +465,9 @@ module Aws::Translate
     TranslateTextResponse.add_member(:applied_settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "AppliedSettings"))
     TranslateTextResponse.struct_class = Types::TranslateTextResponse
 
+    TranslatedDocument.add_member(:content, Shapes::ShapeRef.new(shape: TranslatedDocumentContent, required: true, location_name: "Content"))
+    TranslatedDocument.struct_class = Types::TranslatedDocument
+
     TranslationSettings.add_member(:formality, Shapes::ShapeRef.new(shape: Formality, location_name: "Formality"))
     TranslationSettings.add_member(:profanity, Shapes::ShapeRef.new(shape: Profanity, location_name: "Profanity"))
     TranslationSettings.struct_class = Types::TranslationSettings
@@ -699,6 +726,21 @@ module Aws::Translate
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:translate_document, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "TranslateDocument"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: TranslateDocumentRequest)
+        o.output = Shapes::ShapeRef.new(shape: TranslateDocumentResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedLanguagePairException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+      end)
+
       api.add_operation(:translate_text, Seahorse::Model::Operation.new.tap do |o|
         o.name = "TranslateText"
         o.http_method = "POST"

data/lib/aws-sdk-translate/endpoint_parameters.rb

@@ -50,9 +50,6 @@ module Aws::Translate
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

data/lib/aws-sdk-translate/endpoint_provider.rb

@@ -14,36 +14,39 @@ module Aws::Translate
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint)
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://translate-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://translate-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://translate.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://translate-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://translate-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://translate.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://translate.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://translate.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

data/lib/aws-sdk-translate/endpoints.rb

@@ -221,6 +221,20 @@ module Aws::Translate
       end
     end
 
+    class TranslateDocument
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::Translate::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class TranslateText
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-translate/plugins/endpoints.rb

@@ -86,6 +86,8 @@ module Aws::Translate
             Aws::Translate::Endpoints::StopTextTranslationJob.build(context)
           when :tag_resource
             Aws::Translate::Endpoints::TagResource.build(context)
+          when :translate_document
+            Aws::Translate::Endpoints::TranslateDocument.build(context)
           when :translate_text
             Aws::Translate::Endpoints::TranslateText.build(context)
           when :untag_resource

data/lib/aws-sdk-translate/types.rb

@@ -228,6 +228,35 @@ module Aws::Translate
       include Aws::Structure
     end
 
+    # The content and content type of a document.
+    #
+    # @!attribute [rw] content
+    #   The `Content`field type is Binary large object (blob). This object
+    #   contains the document content converted into base64-encoded binary
+    #   data. If you use one of the AWS SDKs, the SDK performs the
+    #   Base64-encoding on this field before sending the request.
+    #   @return [String]
+    #
+    # @!attribute [rw] content_type
+    #   Describes the format of the document. You can specify one of the
+    #   following:
+    #
+    #   * text/html - The input data consists of HTML content. Amazon
+    #     Translate translates only the text in the HTML element.
+    #
+    #   * text/plain - The input data consists of unformatted text. Amazon
+    #     Translate translates every character in the content.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/Document AWS API Documentation
+    #
+    class Document < Struct.new(
+      :content,
+      :content_type)
+      SENSITIVE = [:content]
+      include Aws::Structure
+    end
+
     # The encryption key used to encrypt this object.
     #
     # @!attribute [rw] type
@@ -460,26 +489,26 @@ module Aws::Translate
     #   as input. You can specify one of the following multipurpose internet
     #   mail extension (MIME) types:
     #
-    #   * `text/html`\: The input data consists of one or more HTML files.
+    #   * `text/html`: The input data consists of one or more HTML files.
     #     Amazon Translate translates only the text that resides in the
     #     `html` element in each file.
     #
-    #   * `text/plain`\: The input data consists of one or more unformatted
+    #   * `text/plain`: The input data consists of one or more unformatted
     #     text files. Amazon Translate translates every character in this
     #     type of input.
     #
-    #   * `application/vnd.openxmlformats-officedocument.wordprocessingml.document`\:
+    #   * `application/vnd.openxmlformats-officedocument.wordprocessingml.document`:
     #     The input data consists of one or more Word documents (.docx).
     #
-    #   * `application/vnd.openxmlformats-officedocument.presentationml.presentation`\:
+    #   * `application/vnd.openxmlformats-officedocument.presentationml.presentation`:
     #     The input data consists of one or more PowerPoint Presentation
     #     files (.pptx).
     #
-    #   * `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`\:
+    #   * `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`:
     #     The input data consists of one or more Excel Workbook files
     #     (.xlsx).
     #
-    #   * `application/x-xliff+xml`\: The input data consists of one or more
+    #   * `application/x-xliff+xml`: The input data consists of one or more
     #     XML Localization Interchange File Format (XLIFF) files (.xlf).
     #     Amazon Translate supports only XLIFF version 1.2.
     #
@@ -1598,7 +1627,7 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] settings
-    #   Settings that configure the translation output.
+    #   Settings that modify the translation output.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TextTranslationJobProperties AWS API Documentation
@@ -1654,6 +1683,102 @@ module Aws::Translate
       include Aws::Structure
     end
 
+    # @!attribute [rw] document
+    #   The content and content type for the document to be translated. The
+    #   document size must not exceed 100 KB.
+    #   @return [Types::Document]
+    #
+    # @!attribute [rw] terminology_names
+    #   The name of a terminology list file to add to the translation job.
+    #   This file provides source terms and the desired translation for each
+    #   term. A terminology list can contain a maximum of 256 terms. You can
+    #   use one custom terminology resource in your translation request.
+    #
+    #   Use the ListTerminologies operation to get the available terminology
+    #   lists.
+    #
+    #   For more information about custom terminology lists, see [Custom
+    #   terminology][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/how-custom-terminology.html
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] source_language_code
+    #   The language code for the language of the source text. Do not use
+    #   `auto`, because `TranslateDocument` does not support language
+    #   auto-detection. For a list of supported language codes, see
+    #   [Supported languages][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
+    #   @return [String]
+    #
+    # @!attribute [rw] target_language_code
+    #   The language code requested for the translated document. For a list
+    #   of supported language codes, see [Supported languages][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
+    #   @return [String]
+    #
+    # @!attribute [rw] settings
+    #   Settings to configure your translation output, including the option
+    #   to set the formality level of the output text and the option to mask
+    #   profane words and phrases.
+    #   @return [Types::TranslationSettings]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateDocumentRequest AWS API Documentation
+    #
+    class TranslateDocumentRequest < Struct.new(
+      :document,
+      :terminology_names,
+      :source_language_code,
+      :target_language_code,
+      :settings)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] translated_document
+    #   The document containing the translated content. The document format
+    #   matches the source document format.
+    #   @return [Types::TranslatedDocument]
+    #
+    # @!attribute [rw] source_language_code
+    #   The language code of the source document.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_language_code
+    #   The language code of the translated document.
+    #   @return [String]
+    #
+    # @!attribute [rw] applied_terminologies
+    #   The names of the custom terminologies applied to the input text by
+    #   Amazon Translate to produce the translated text document.
+    #   @return [Array<Types::AppliedTerminology>]
+    #
+    # @!attribute [rw] applied_settings
+    #   Settings to configure your translation output, including the option
+    #   to set the formality level of the output text and the option to mask
+    #   profane words and phrases.
+    #   @return [Types::TranslationSettings]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateDocumentResponse AWS API Documentation
+    #
+    class TranslateDocumentResponse < Struct.new(
+      :translated_document,
+      :source_language_code,
+      :target_language_code,
+      :applied_terminologies,
+      :applied_settings)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] text
     #   The text to translate. The text string can be a maximum of 10,000
     #   bytes long. Depending on your character set, this may be fewer than
@@ -1661,15 +1786,24 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] terminology_names
-    #   The name of the terminology list file to be used in the
-    #   TranslateText request. You can use 1 terminology list at most in a
-    #   `TranslateText` request. Terminology lists can contain a maximum of
-    #   256 terms.
+    #   The name of a terminology list file to add to the translation job.
+    #   This file provides source terms and the desired translation for each
+    #   term. A terminology list can contain a maximum of 256 terms. You can
+    #   use one custom terminology resource in your translation request.
+    #
+    #   Use the ListTerminologies operation to get the available terminology
+    #   lists.
+    #
+    #   For more information about custom terminology lists, see [Custom
+    #   terminology][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/how-custom-terminology.html
     #   @return [Array<String>]
     #
     # @!attribute [rw] source_language_code
-    #   The language code for the language of the source text. The language
-    #   must be a language supported by Amazon Translate. For a list of
+    #   The language code for the language of the source text. For a list of
     #   language codes, see [Supported languages][1].
     #
     #   To have Amazon Translate determine the source language of your text,
@@ -1690,8 +1824,12 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] target_language_code
-    #   The language code requested for the language of the target text. The
-    #   language must be a language supported by Amazon Translate.
+    #   The language code requested for the language of the target text. For
+    #   a list of language codes, see [Supported languages][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
     #   @return [String]
     #
     # @!attribute [rw] settings
@@ -1730,7 +1868,7 @@ module Aws::Translate
     #   @return [Array<Types::AppliedTerminology>]
     #
     # @!attribute [rw] applied_settings
-    #   Settings that configure the translation output.
+    #   Optional settings that modify the translation output.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateTextResponse AWS API Documentation
@@ -1745,8 +1883,23 @@ module Aws::Translate
       include Aws::Structure
     end
 
-    # Optional settings that configure the translation output. Use these
-    # settings for real time translations and asynchronous translation jobs.
+    # The translated content.
+    #
+    # @!attribute [rw] content
+    #   The document containing the translated content.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslatedDocument AWS API Documentation
+    #
+    class TranslatedDocument < Struct.new(
+      :content)
+      SENSITIVE = [:content]
+      include Aws::Structure
+    end
+
+    # Settings to configure your translation output, including the option to
+    # set the formality level of the output text and the option to mask
+    # profane words and phrases.
     #
     # @!attribute [rw] formality
     #   You can optionally specify the desired level of formality for
@@ -1822,11 +1975,11 @@ module Aws::Translate
 
     # Amazon Translate does not support translation from the language of the
     # source text into the requested target language. For more information,
-    # see [Error messages][1].
+    # see [Supported languages][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/translate/latest/dg/how-to-error-msg.html
+    # [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
     #
     # @!attribute [rw] message
     #   @return [String]

data/lib/aws-sdk-translate.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-translate/customizations'
 # @!group service
 module Aws::Translate
 
-  GEM_VERSION = '1.50.0'
+  GEM_VERSION = '1.51.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-translate
 version: !ruby/object:Gem::Version
-  version: 1.50.0
+  version: 1.51.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core