aws-sdk-translate 1.59.0 → 1.60.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 757357722fd4a40562e7f67b50acc428dc18981558848aaef985717ca1670049
-  data.tar.gz: 66be00fbb9c13528f02a412d30015ef4438788142bb281bb385106f65b4ea869
+  metadata.gz: 71bfbb23fcb7271fe18da3b7368fa82ab26121a8bdcd616099287ee234f61613
+  data.tar.gz: 2d4b72f61916da55a17bdc3ebce1f932d75fde9eabd75af1d2c2dea8cf1b4527
 SHA512:
-  metadata.gz: 81b5dfb9753836e5e81645293763bdba97f974573c0eb618f67e52ede9958b34d8cace9f5dd0a82fa993230bf23e7be6b410a5e3aa0d9028a4838efe4572f22a
-  data.tar.gz: 8077f3be33badd47d016f0f0ea957d4f81ed4e01218e891000ede7b9c0a7f7bd3dce130bc51c3ed52206d35973e32f0af97b0b128c799a550d0c33ea9e385c8c
+  metadata.gz: 69ec8e6b0f36079599d5843b4bec5a6b29b146bc85cf104bd0acd5134f8face82032990fc570cd9795bb3fbcad5e098ee7b6272adfb3452ed6236346cdb7c557
+  data.tar.gz: 32544215b5187cf6fc572261ad8d524c6762e243aef530105232fc54505499ec3b83e3fd74e4c3a24a6bfc1a9ccd397310497bc329ea4d8a156f71ae4dae4f1e

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.60.0 (2023-10-31)
+------------------
+
+* Feature - Added support for Brevity translation settings feature.
+
 1.59.0 (2023-09-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.59.0
+1.60.0

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

@@ -447,8 +447,8 @@ module Aws::Translate
     #     name: "ResourceName", # required
     #     description: "Description",
     #     parallel_data_config: { # required
-    #       s3_uri: "S3Uri", # required
-    #       format: "TSV", # required, accepts TSV, CSV, TMX
+    #       s3_uri: "S3Uri",
+    #       format: "TSV", # accepts TSV, CSV, TMX
     #     },
     #     encryption_key: {
     #       type: "KMS", # required, accepts KMS
@@ -574,6 +574,7 @@ module Aws::Translate
     #   resp.text_translation_job_properties.data_access_role_arn #=> String
     #   resp.text_translation_job_properties.settings.formality #=> String, one of "FORMAL", "INFORMAL"
     #   resp.text_translation_job_properties.settings.profanity #=> String, one of "MASK"
+    #   resp.text_translation_job_properties.settings.brevity #=> String, one of "ON"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/DescribeTextTranslationJob AWS API Documentation
     #
@@ -1053,6 +1054,7 @@ module Aws::Translate
     #   resp.text_translation_job_properties_list[0].data_access_role_arn #=> String
     #   resp.text_translation_job_properties_list[0].settings.formality #=> String, one of "FORMAL", "INFORMAL"
     #   resp.text_translation_job_properties_list[0].settings.profanity #=> String, one of "MASK"
+    #   resp.text_translation_job_properties_list[0].settings.brevity #=> String, one of "ON"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ListTextTranslationJobs AWS API Documentation
@@ -1181,9 +1183,15 @@ module Aws::Translate
     #   not need to pass this option.**
     #
     # @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.
+    #   Settings to configure your translation output. You can configure the
+    #   following options:
+    #
+    #   * Brevity: not supported.
+    #
+    #   * Formality: sets the formality level of the output text.
+    #
+    #   * Profanity: masks profane words and phrases in your translation
+    #     output.
     #
     # @return [Types::StartTextTranslationJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1214,6 +1222,7 @@ module Aws::Translate
     #     settings: {
     #       formality: "FORMAL", # accepts FORMAL, INFORMAL
     #       profanity: "MASK", # accepts MASK
+    #       brevity: "ON", # accepts ON
     #     },
     #   })
     #
@@ -1312,13 +1321,11 @@ module Aws::Translate
     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.
+    # language. This synchronous operation supports text, HTML, or Word
+    # documents as 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).
     #
     # If you set the `Formality` parameter, the request will fail if the
     # target language does not support formality. For a list of target
@@ -1349,14 +1356,24 @@ module Aws::Translate
     #   [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].
+    #   The language code for the language of the source text. For a list of
+    #   supported language codes, see [Supported languages][1].
+    #
+    #   To have Amazon Translate determine the source language of your text,
+    #   you can specify `auto` in the `SourceLanguageCode` field. If you
+    #   specify `auto`, Amazon Translate will call [Amazon Comprehend][2] to
+    #   determine the source language.
+    #
+    #   <note markdown="1"> If you specify `auto`, you must send the `TranslateDocument` request
+    #   in a region that supports Amazon Comprehend. Otherwise, the request
+    #   returns an error indicating that autodetect is not supported.
+    #
+    #    </note>
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
+    #   [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 translated document. For a list of
@@ -1367,9 +1384,15 @@ module Aws::Translate
     #   [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.
+    #   Settings to configure your translation output. You can configure the
+    #   following options:
+    #
+    #   * Brevity: not supported.
+    #
+    #   * Formality: sets the formality level of the output text.
+    #
+    #   * Profanity: masks profane words and phrases in your translation
+    #     output.
     #
     # @return [Types::TranslateDocumentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1392,6 +1415,7 @@ module Aws::Translate
     #     settings: {
     #       formality: "FORMAL", # accepts FORMAL, INFORMAL
     #       profanity: "MASK", # accepts MASK
+    #       brevity: "ON", # accepts ON
     #     },
     #   })
     #
@@ -1407,6 +1431,7 @@ module Aws::Translate
     #   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"
+    #   resp.applied_settings.brevity #=> String, one of "ON"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateDocument AWS API Documentation
     #
@@ -1475,9 +1500,16 @@ module Aws::Translate
     #   [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.
+    #   Settings to configure your translation output. You can configure the
+    #   following options:
+    #
+    #   * Brevity: reduces the length of the translated output for most
+    #     translations.
+    #
+    #   * Formality: sets the formality level of the output text.
+    #
+    #   * Profanity: masks profane words and phrases in your translation
+    #     output.
     #
     # @return [Types::TranslateTextResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1497,6 +1529,7 @@ module Aws::Translate
     #     settings: {
     #       formality: "FORMAL", # accepts FORMAL, INFORMAL
     #       profanity: "MASK", # accepts MASK
+    #       brevity: "ON", # accepts ON
     #     },
     #   })
     #
@@ -1512,6 +1545,7 @@ module Aws::Translate
     #   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"
+    #   resp.applied_settings.brevity #=> String, one of "ON"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateText AWS API Documentation
     #
@@ -1589,8 +1623,8 @@ module Aws::Translate
     #     name: "ResourceName", # required
     #     description: "Description",
     #     parallel_data_config: { # required
-    #       s3_uri: "S3Uri", # required
-    #       format: "TSV", # required, accepts TSV, CSV, TMX
+    #       s3_uri: "S3Uri",
+    #       format: "TSV", # accepts TSV, CSV, TMX
     #     },
     #     client_token: "ClientTokenString", # required
     #   })
@@ -1624,7 +1658,7 @@ module Aws::Translate
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-translate'
-      context[:gem_version] = '1.59.0'
+      context[:gem_version] = '1.60.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -16,6 +16,7 @@ module Aws::Translate
     AppliedTerminology = Shapes::StructureShape.new(name: 'AppliedTerminology')
     AppliedTerminologyList = Shapes::ListShape.new(name: 'AppliedTerminologyList')
     BoundedLengthString = Shapes::StringShape.new(name: 'BoundedLengthString')
+    Brevity = Shapes::StringShape.new(name: 'Brevity')
     ClientTokenString = Shapes::StringShape.new(name: 'ClientTokenString')
     ConcurrentModificationException = Shapes::StructureShape.new(name: 'ConcurrentModificationException')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
@@ -293,8 +294,8 @@ module Aws::Translate
     OutputDataConfig.add_member(:encryption_key, Shapes::ShapeRef.new(shape: EncryptionKey, location_name: "EncryptionKey"))
     OutputDataConfig.struct_class = Types::OutputDataConfig
 
-    ParallelDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
-    ParallelDataConfig.add_member(:format, Shapes::ShapeRef.new(shape: ParallelDataFormat, required: true, location_name: "Format"))
+    ParallelDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "S3Uri"))
+    ParallelDataConfig.add_member(:format, Shapes::ShapeRef.new(shape: ParallelDataFormat, location_name: "Format"))
     ParallelDataConfig.struct_class = Types::ParallelDataConfig
 
     ParallelDataDataLocation.add_member(:repository_type, Shapes::ShapeRef.new(shape: String, required: true, location_name: "RepositoryType"))
@@ -470,6 +471,7 @@ module Aws::Translate
 
     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.add_member(:brevity, Shapes::ShapeRef.new(shape: Brevity, location_name: "Brevity"))
     TranslationSettings.struct_class = Types::TranslationSettings
 
     UnsupportedDisplayLanguageCodeException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))

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

@@ -32,7 +32,7 @@ module Aws::Translate
             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"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               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"

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

@@ -1167,9 +1167,15 @@ module Aws::Translate
     #   @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.
+    #   Settings to configure your translation output. You can configure the
+    #   following options:
+    #
+    #   * Brevity: not supported.
+    #
+    #   * Formality: sets the formality level of the output text.
+    #
+    #   * Profanity: masks profane words and phrases in your translation
+    #     output.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/StartTextTranslationJobRequest AWS API Documentation
@@ -1709,14 +1715,24 @@ module Aws::Translate
     #   @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].
+    #   The language code for the language of the source text. For a list of
+    #   supported language codes, see [Supported languages][1].
+    #
+    #   To have Amazon Translate determine the source language of your text,
+    #   you can specify `auto` in the `SourceLanguageCode` field. If you
+    #   specify `auto`, Amazon Translate will call [Amazon Comprehend][2] to
+    #   determine the source language.
+    #
+    #   <note markdown="1"> If you specify `auto`, you must send the `TranslateDocument` request
+    #   in a region that supports Amazon Comprehend. Otherwise, the request
+    #   returns an error indicating that autodetect is not supported.
+    #
+    #    </note>
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html
+    #   [2]: https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-general.html
     #   @return [String]
     #
     # @!attribute [rw] target_language_code
@@ -1729,9 +1745,15 @@ module Aws::Translate
     #   @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.
+    #   Settings to configure your translation output. You can configure the
+    #   following options:
+    #
+    #   * Brevity: not supported.
+    #
+    #   * Formality: sets the formality level of the output text.
+    #
+    #   * Profanity: masks profane words and phrases in your translation
+    #     output.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateDocumentRequest AWS API Documentation
@@ -1765,9 +1787,16 @@ module Aws::Translate
     #   @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.
+    #   Settings to configure your translation output. You can configure the
+    #   following options:
+    #
+    #   * Brevity: reduces the length of the translation output for most
+    #     translations. Available for `TranslateText` only.
+    #
+    #   * Formality: sets the formality level of the translation output.
+    #
+    #   * Profanity: masks profane words and phrases in the translation
+    #     output.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateDocumentResponse AWS API Documentation
@@ -1836,9 +1865,16 @@ module Aws::Translate
     #   @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.
+    #   Settings to configure your translation output. You can configure the
+    #   following options:
+    #
+    #   * Brevity: reduces the length of the translated output for most
+    #     translations.
+    #
+    #   * Formality: sets the formality level of the output text.
+    #
+    #   * Profanity: masks profane words and phrases in your translation
+    #     output.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateTextRequest AWS API Documentation
@@ -1900,18 +1936,25 @@ module Aws::Translate
       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.
+    # Settings to configure your translation output. You can configure the
+    # following options:
+    #
+    # * Brevity: reduces the length of the translation output for most
+    #   translations. Available for `TranslateText` only.
+    #
+    # * Formality: sets the formality level of the translation output.
+    #
+    # * Profanity: masks profane words and phrases in the translation
+    #   output.
     #
     # @!attribute [rw] formality
-    #   You can optionally specify the desired level of formality for
-    #   translations to supported target languages. The formality setting
-    #   controls the level of formal language usage (also known as
-    #   [register][1]) in the translation output. You can set the value to
-    #   informal or formal. If you don't specify a value for formality, or
-    #   if the target language doesn't support formality, the translation
-    #   will ignore the formality setting.
+    #   You can specify the desired level of formality for translations to
+    #   supported target languages. The formality setting controls the level
+    #   of formal language usage (also known as [register][1]) in the
+    #   translation output. You can set the value to informal or formal. If
+    #   you don't specify a value for formality, or if the target language
+    #   doesn't support formality, the translation will ignore the
+    #   formality setting.
     #
     #   If you specify multiple target languages for the job, translate
     #   ignores the formality setting for any unsupported target language.
@@ -1926,8 +1969,8 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] profanity
-    #   Enable the profanity setting if you want Amazon Translate to mask
-    #   profane words and phrases in your translation output.
+    #   You can enable the profanity setting if you want to mask profane
+    #   words and phrases in your translation output.
     #
     #   To mask profane words and phrases, Amazon Translate replaces them
     #   with the grawlix string “?$#@$“. This 5-character sequence is used
@@ -1949,11 +1992,30 @@ module Aws::Translate
     #   [1]: https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-profanity.html#customizing-translations-profanity-languages
     #   @return [String]
     #
+    # @!attribute [rw] brevity
+    #   When you turn on brevity, Amazon Translate reduces the length of the
+    #   translation output for most translations (when compared with the
+    #   same translation with brevity turned off). By default, brevity is
+    #   turned off.
+    #
+    #   If you turn on brevity for a translation request with an unsupported
+    #   language pair, the translation proceeds with the brevity setting
+    #   turned off.
+    #
+    #   For the language pairs that brevity supports, see [Using brevity][1]
+    #   in the Amazon Translate Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-brevity
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslationSettings AWS API Documentation
     #
     class TranslationSettings < Struct.new(
       :formality,
-      :profanity)
+      :profanity,
+      :brevity)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-translate.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-translate
 version: !ruby/object:Gem::Version
-  version: 1.59.0
+  version: 1.60.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-27 00:00:00.000000000 Z
+date: 2023-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core