aws-sdk-translate 1.38.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f83d085cfb031f5911cb38428f8db0395419c2c96e38943ebe2dda9857089ba
-  data.tar.gz: 4085af53260662bffb1c9313304dcad803a950a9ff8b29a2b82eef8433622b44
+  metadata.gz: d2d3da6497b0b23edf01695cfce94636419cca1a56d265a0c4ca00ac04caaeda
+  data.tar.gz: 88736a9ff112f357ef12224a3bb7844477a9ac3caba1df32ff22173b30ff9d4e
 SHA512:
-  metadata.gz: 1d6cc30efd17e61d9f5f32555ff0183bcd7ef70cf4d9293a3a1350fe9307c1437f0489a361d010b6c27634097be902796dfdafa7c818a06105d1c2c8f725e5e2
-  data.tar.gz: 2f4391d077e74eab1b3b672c13f2bbca4ee4d55bf6348c767daea07736186895b45cdab7759f3d4bb9cb98826da58206aed84ef4683fd15cac637222828da7df
+  metadata.gz: d8620eb7e43d1c7de93c7f12ee0dfd9f4524534b73904d7f26afff0494713845e6475d97acb041b3aca60d0f6189f7d8cf2f00cf831bdfedda4c2781f873c677
+  data.tar.gz: 5b7398875dd09ad3175a56568f548ec3b1ec25b1d415868f11323013193d3d10d442905969105065544b1844f43fd87f01c32cbf693e6855b2d0c363f9246bd1

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.39.0 (2021-11-24)
+------------------
+
+* Feature - This release enables customers to use translation settings to mask profane words and phrases in their translation output.
+
 1.38.0 (2021-11-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.38.0
+1.39.0

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

@@ -503,6 +503,7 @@ module Aws::Translate
     #   resp.text_translation_job_properties.output_data_config.encryption_key.type #=> String, one of "KMS"
     #   resp.text_translation_job_properties.output_data_config.encryption_key.id #=> String
     #   resp.text_translation_job_properties.data_access_role_arn #=> String
+    #   resp.text_translation_job_properties.settings.profanity #=> String, one of "MASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/DescribeTextTranslationJob AWS API Documentation
     #
@@ -883,6 +884,7 @@ module Aws::Translate
     #   resp.text_translation_job_properties_list[0].output_data_config.encryption_key.type #=> String, one of "KMS"
     #   resp.text_translation_job_properties_list[0].output_data_config.encryption_key.id #=> String
     #   resp.text_translation_job_properties_list[0].data_access_role_arn #=> String
+    #   resp.text_translation_job_properties_list[0].settings.profanity #=> String, one of "MASK"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ListTextTranslationJobs AWS API Documentation
@@ -975,6 +977,10 @@ module Aws::Translate
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [Types::TranslationSettings] :settings
+    #   Settings to configure your translation output, including the option to
+    #   mask profane words and phrases.
+    #
     # @return [Types::StartTextTranslationJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartTextTranslationJobResponse#job_id #job_id} => String
@@ -1001,6 +1007,9 @@ module Aws::Translate
     #     terminology_names: ["ResourceName"],
     #     parallel_data_names: ["ResourceName"],
     #     client_token: "ClientTokenString", # required
+    #     settings: {
+    #       profanity: "MASK", # accepts MASK
+    #     },
     #   })
     #
     # @example Response structure
@@ -1089,12 +1098,17 @@ module Aws::Translate
     #   The language code requested for the language of the target text. The
     #   language must be a language supported by Amazon Translate.
     #
+    # @option params [Types::TranslationSettings] :settings
+    #   Settings to configure your translation output, including the option to
+    #   mask profane words and phrases.
+    #
     # @return [Types::TranslateTextResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::TranslateTextResponse#translated_text #translated_text} => String
     #   * {Types::TranslateTextResponse#source_language_code #source_language_code} => String
     #   * {Types::TranslateTextResponse#target_language_code #target_language_code} => String
     #   * {Types::TranslateTextResponse#applied_terminologies #applied_terminologies} => Array<Types::AppliedTerminology>
+    #   * {Types::TranslateTextResponse#applied_settings #applied_settings} => Types::TranslationSettings
     #
     # @example Request syntax with placeholder values
     #
@@ -1103,6 +1117,9 @@ module Aws::Translate
     #     terminology_names: ["ResourceName"],
     #     source_language_code: "LanguageCodeString", # required
     #     target_language_code: "LanguageCodeString", # required
+    #     settings: {
+    #       profanity: "MASK", # accepts MASK
+    #     },
     #   })
     #
     # @example Response structure
@@ -1115,6 +1132,7 @@ module Aws::Translate
     #   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.profanity #=> String, one of "MASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateText AWS API Documentation
     #
@@ -1193,7 +1211,7 @@ module Aws::Translate
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-translate'
-      context[:gem_version] = '1.38.0'
+      context[:gem_version] = '1.39.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -71,6 +71,7 @@ module Aws::Translate
     ParallelDataProperties = Shapes::StructureShape.new(name: 'ParallelDataProperties')
     ParallelDataPropertiesList = Shapes::ListShape.new(name: 'ParallelDataPropertiesList')
     ParallelDataStatus = Shapes::StringShape.new(name: 'ParallelDataStatus')
+    Profanity = Shapes::StringShape.new(name: 'Profanity')
     ResourceName = Shapes::StringShape.new(name: 'ResourceName')
     ResourceNameList = Shapes::ListShape.new(name: 'ResourceNameList')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
@@ -99,6 +100,7 @@ module Aws::Translate
     TooManyRequestsException = Shapes::StructureShape.new(name: 'TooManyRequestsException')
     TranslateTextRequest = Shapes::StructureShape.new(name: 'TranslateTextRequest')
     TranslateTextResponse = Shapes::StructureShape.new(name: 'TranslateTextResponse')
+    TranslationSettings = Shapes::StructureShape.new(name: 'TranslationSettings')
     UnboundedLengthString = Shapes::StringShape.new(name: 'UnboundedLengthString')
     UnsupportedLanguagePairException = Shapes::StructureShape.new(name: 'UnsupportedLanguagePairException')
     UpdateParallelDataRequest = Shapes::StructureShape.new(name: 'UpdateParallelDataRequest')
@@ -281,6 +283,7 @@ module Aws::Translate
     StartTextTranslationJobRequest.add_member(:terminology_names, Shapes::ShapeRef.new(shape: ResourceNameList, location_name: "TerminologyNames"))
     StartTextTranslationJobRequest.add_member(:parallel_data_names, Shapes::ShapeRef.new(shape: ResourceNameList, location_name: "ParallelDataNames"))
     StartTextTranslationJobRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientTokenString, required: true, location_name: "ClientToken", metadata: {"idempotencyToken"=>true}))
+    StartTextTranslationJobRequest.add_member(:settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "Settings"))
     StartTextTranslationJobRequest.struct_class = Types::StartTextTranslationJobRequest
 
     StartTextTranslationJobResponse.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, location_name: "JobId"))
@@ -352,6 +355,7 @@ module Aws::Translate
     TextTranslationJobProperties.add_member(:input_data_config, Shapes::ShapeRef.new(shape: InputDataConfig, location_name: "InputDataConfig"))
     TextTranslationJobProperties.add_member(:output_data_config, Shapes::ShapeRef.new(shape: OutputDataConfig, location_name: "OutputDataConfig"))
     TextTranslationJobProperties.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "DataAccessRoleArn"))
+    TextTranslationJobProperties.add_member(:settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "Settings"))
     TextTranslationJobProperties.struct_class = Types::TextTranslationJobProperties
 
     TextTranslationJobPropertiesList.member = Shapes::ShapeRef.new(shape: TextTranslationJobProperties)
@@ -363,14 +367,19 @@ module Aws::Translate
     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"))
     TranslateTextRequest.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "TargetLanguageCode"))
+    TranslateTextRequest.add_member(:settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "Settings"))
     TranslateTextRequest.struct_class = Types::TranslateTextRequest
 
     TranslateTextResponse.add_member(:translated_text, Shapes::ShapeRef.new(shape: String, required: true, location_name: "TranslatedText"))
     TranslateTextResponse.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "SourceLanguageCode"))
     TranslateTextResponse.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "TargetLanguageCode"))
     TranslateTextResponse.add_member(:applied_terminologies, Shapes::ShapeRef.new(shape: AppliedTerminologyList, location_name: "AppliedTerminologies"))
+    TranslateTextResponse.add_member(:applied_settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "AppliedSettings"))
     TranslateTextResponse.struct_class = Types::TranslateTextResponse
 
+    TranslationSettings.add_member(:profanity, Shapes::ShapeRef.new(shape: Profanity, location_name: "Profanity"))
+    TranslationSettings.struct_class = Types::TranslationSettings
+
     UnsupportedLanguagePairException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     UnsupportedLanguagePairException.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, location_name: "SourceLanguageCode"))
     UnsupportedLanguagePairException.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, location_name: "TargetLanguageCode"))

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

@@ -266,13 +266,13 @@ module Aws::Translate
     #       }
     #
     # @!attribute [rw] type
-    #   The type of encryption key used by Amazon Translate to encrypt
-    #   custom terminologies.
+    #   The type of encryption key used by Amazon Translate to encrypt this
+    #   object.
     #   @return [String]
     #
     # @!attribute [rw] id
     #   The Amazon Resource Name (ARN) of the encryption key being used to
-    #   encrypt the custom terminology.
+    #   encrypt this object.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/EncryptionKey AWS API Documentation
@@ -313,8 +313,8 @@ module Aws::Translate
     #   that was successfully imported into Amazon Translate. The location
     #   is returned as a presigned URL that has a 30 minute expiration.
     #
-    #   Amazon Translate doesn't scan parallel data input files for the
-    #   risk of CSV injection attacks.
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
     #
     #    CSV injection occurs when a .csv or .tsv file is altered so that a
     #   record contains malicious code. The record begins with a special
@@ -322,8 +322,8 @@ module Aws::Translate
     #   spreadsheet program, the program might interpret the record as a
     #   formula and run the code within it.
     #
-    #    Before you download a parallel data input file from Amazon S3,
-    #   ensure that you recognize the file and trust its creator.
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
     #   @return [Types::ParallelDataDataLocation]
     #
     # @!attribute [rw] auxiliary_data_location
@@ -392,9 +392,22 @@ module Aws::Translate
     #   @return [Types::TerminologyProperties]
     #
     # @!attribute [rw] terminology_data_location
-    #   The data location of the custom terminology being retrieved. The
-    #   custom terminology file is returned in a presigned url that has a 30
-    #   minute expiration.
+    #   The Amazon S3 location of the most recent custom terminology input
+    #   file that was successfully imported into Amazon Translate. The
+    #   location is returned as a presigned URL that has a 30 minute
+    #   expiration.
+    #
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
+    #
+    #    CSV injection occurs when a .csv or .tsv file is altered so that a
+    #   record contains malicious code. The record begins with a special
+    #   character, such as =, +, -, or @. When the file is opened in a
+    #   spreadsheet program, the program might interpret the record as a
+    #   formula and run the code within it.
+    #
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
     #   @return [Types::TerminologyDataLocation]
     #
     # @!attribute [rw] auxiliary_data_location
@@ -869,8 +882,8 @@ module Aws::Translate
     #   The Amazon S3 location of the parallel data input file. The location
     #   is returned as a presigned URL to that has a 30 minute expiration.
     #
-    #   Amazon Translate doesn't scan parallel data input files for the
-    #   risk of CSV injection attacks.
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
     #
     #    CSV injection occurs when a .csv or .tsv file is altered so that a
     #   record contains malicious code. The record begins with a special
@@ -878,8 +891,8 @@ module Aws::Translate
     #   spreadsheet program, the program might interpret the record as a
     #   formula and run the code within it.
     #
-    #    Before you download a parallel data input file from Amazon S3,
-    #   ensure that you recognize the file and trust its creator.
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ParallelDataDataLocation AWS API Documentation
@@ -1052,6 +1065,9 @@ module Aws::Translate
     #         terminology_names: ["ResourceName"],
     #         parallel_data_names: ["ResourceName"],
     #         client_token: "ClientTokenString", # required
+    #         settings: {
+    #           profanity: "MASK", # accepts MASK
+    #         },
     #       }
     #
     # @!attribute [rw] job_name
@@ -1131,6 +1147,11 @@ module Aws::Translate
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] settings
+    #   Settings to configure your translation output, including the option
+    #   to mask profane words and phrases.
+    #   @return [Types::TranslationSettings]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/StartTextTranslationJobRequest AWS API Documentation
     #
     class StartTextTranslationJobRequest < Struct.new(
@@ -1142,7 +1163,8 @@ module Aws::Translate
       :target_language_codes,
       :terminology_names,
       :parallel_data_names,
-      :client_token)
+      :client_token,
+      :settings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1306,7 +1328,22 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] location
-    #   The location of the custom terminology data.
+    #   The Amazon S3 location of the most recent custom terminology input
+    #   file that was successfully imported into Amazon Translate. The
+    #   location is returned as a presigned URL that has a 30 minute
+    #   expiration.
+    #
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
+    #
+    #    CSV injection occurs when a .csv or .tsv file is altered so that a
+    #   record contains malicious code. The record begins with a special
+    #   character, such as =, +, -, or @. When the file is opened in a
+    #   spreadsheet program, the program might interpret the record as a
+    #   formula and run the code within it.
+    #
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TerminologyDataLocation AWS API Documentation
@@ -1547,6 +1584,10 @@ module Aws::Translate
     #   the job's input data.
     #   @return [String]
     #
+    # @!attribute [rw] settings
+    #   Settings that configure the translation output.
+    #   @return [Types::TranslationSettings]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TextTranslationJobProperties AWS API Documentation
     #
     class TextTranslationJobProperties < Struct.new(
@@ -1563,7 +1604,8 @@ module Aws::Translate
       :end_time,
       :input_data_config,
       :output_data_config,
-      :data_access_role_arn)
+      :data_access_role_arn,
+      :settings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1590,6 +1632,9 @@ module Aws::Translate
     #         terminology_names: ["ResourceName"],
     #         source_language_code: "LanguageCodeString", # required
     #         target_language_code: "LanguageCodeString", # required
+    #         settings: {
+    #           profanity: "MASK", # accepts MASK
+    #         },
     #       }
     #
     # @!attribute [rw] text
@@ -1625,13 +1670,19 @@ module Aws::Translate
     #   language must be a language supported by Amazon Translate.
     #   @return [String]
     #
+    # @!attribute [rw] settings
+    #   Settings to configure your translation output, including the option
+    #   to mask profane words and phrases.
+    #   @return [Types::TranslationSettings]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateTextRequest AWS API Documentation
     #
     class TranslateTextRequest < Struct.new(
       :text,
       :terminology_names,
       :source_language_code,
-      :target_language_code)
+      :target_language_code,
+      :settings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1653,13 +1704,54 @@ module Aws::Translate
     #   Amazon Translate for the translated text response.
     #   @return [Array<Types::AppliedTerminology>]
     #
+    # @!attribute [rw] applied_settings
+    #   Settings that configure the translation output.
+    #   @return [Types::TranslationSettings]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateTextResponse AWS API Documentation
     #
     class TranslateTextResponse < Struct.new(
       :translated_text,
       :source_language_code,
       :target_language_code,
-      :applied_terminologies)
+      :applied_terminologies,
+      :applied_settings)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Settings that configure the translation output.
+    #
+    # @note When making an API call, you may pass TranslationSettings
+    #   data as a hash:
+    #
+    #       {
+    #         profanity: "MASK", # accepts MASK
+    #       }
+    #
+    # @!attribute [rw] profanity
+    #   Enable the profanity setting if you want Amazon Translate 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
+    #   for each profane word or phrase, regardless of the length or number
+    #   of words.
+    #
+    #   Amazon Translate does not detect profanity in all of its supported
+    #   languages. For languages that support profanity detection, see
+    #   [Supported Languages and Language Codes in the Amazon Translate
+    #   Developer Guide][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is.html#what-is-languages
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslationSettings AWS API Documentation
+    #
+    class TranslationSettings < Struct.new(
+      :profanity)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-translate.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-translate/customizations'
 # @!group service
 module Aws::Translate
 
-  GEM_VERSION = '1.38.0'
+  GEM_VERSION = '1.39.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-translate
 version: !ruby/object:Gem::Version
-  version: 1.38.0
+  version: 1.39.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-11 00:00:00.000000000 Z
+date: 2021-11-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core