aws-sdk-comprehend 1.61.0 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9506b07c0fd74a91d95eb651618788bde3605dbe23762423c4e241644bcc3c8
-  data.tar.gz: '0094e85d2ff29db0389c55662ac90e94ccdd3b08076b56d09a7e94ee8a2efdba'
+  metadata.gz: b2b0ff29417aa35c35084fa9357970b72b02f674261ec69b68401baffccedd3d
+  data.tar.gz: 284edfaefd2215cd9783ab96c6535b0e50c1b6f763067f51a32ef2ac501e9952
 SHA512:
-  metadata.gz: 61ed9fc9bbe5d1c330e70d64564ba6beb6eccbd6a8e25cd8be9e1e896536a44d930138c626a2054f90302d33fb2894115a777abd6e1ad12cb0bcbe787f980efe
-  data.tar.gz: faa8ad043980f18673d0f31f286713e60dba7b5af54e6a69befac5fd9894be4f1cd73c45b3507772c88a04189b5764523ce964938db5976f4aef0300aaae5738
+  metadata.gz: 1433313b3641640353668d8e0f6f9f007ca8d7b7ef645bb210b9c05ebdf7f8172d4a545bf27179c8bd5ab7b3a33eefacfff093b57f10113b5bc0a06e1ec70ddb
+  data.tar.gz: 48864026f184295c7e9c9945286ea283dee6eb418dee073595c9a40113fc90201324089751874f8b1a72bca52a8e6c9dcb31b07ac29a39698c9f9911e26f07d7

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.62.0 (2022-09-21)
+------------------
+
+* Feature - Amazon Comprehend now supports synchronous mode for targeted sentiment API operations.
+
 1.61.0 (2022-05-20)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.61.0
+1.62.0

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

@@ -370,10 +370,10 @@ module Aws::Comprehend
     # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-languages.html
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document should contain at
-    #   least 20 characters and must contain fewer than 5,000 bytes of UTF-8
-    #   encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. Each document should
+    #   contain at least 20 characters. The maximum size of each document is 5
+    #   KB.
     #
     # @return [Types::BatchDetectDominantLanguageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -409,12 +409,16 @@ module Aws::Comprehend
 
     # Inspects the text of a batch of documents for named entities and
     # returns information about them. For more information about named
-    # entities, see how-entities
+    # entities, see [Entities][1] in the Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   than 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -460,9 +464,9 @@ module Aws::Comprehend
     # Detects the key noun phrases found in a batch of documents.
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   than 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -509,9 +513,15 @@ module Aws::Comprehend
     # in each one.
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   that 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
+    #
+    #   <note markdown="1"> Amazon Comprehend performs real-time sentiment analysis on the first
+    #   500 characters of the input text and ignores any additional text in
+    #   the input.
+    #
+    #    </note>
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -555,12 +565,17 @@ module Aws::Comprehend
 
     # Inspects the text of a batch of documents for the syntax and part of
     # speech of the words in the document and returns information about
-    # them. For more information, see how-syntax.
+    # them. For more information, see [Syntax][1] in the Comprehend
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   that 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size for each
+    #   document is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -605,6 +620,70 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Inspects a batch of documents and returns a sentiment analysis for
+    # each entity identified in the documents.
+    #
+    # For more information about targeted sentiment, see [Targeted
+    # sentiment][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html
+    #
+    # @option params [required, Array<String>] :text_list
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
+    #
+    # @option params [required, String] :language_code
+    #   The language of the input documents. Currently, English is the only
+    #   supported language.
+    #
+    # @return [Types::BatchDetectTargetedSentimentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchDetectTargetedSentimentResponse#result_list #result_list} => Array&lt;Types::BatchDetectTargetedSentimentItemResult&gt;
+    #   * {Types::BatchDetectTargetedSentimentResponse#error_list #error_list} => Array&lt;Types::BatchItemError&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_detect_targeted_sentiment({
+    #     text_list: ["CustomerInputString"], # required
+    #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.result_list #=> Array
+    #   resp.result_list[0].index #=> Integer
+    #   resp.result_list[0].entities #=> Array
+    #   resp.result_list[0].entities[0].descriptive_mention_index #=> Array
+    #   resp.result_list[0].entities[0].descriptive_mention_index[0] #=> Integer
+    #   resp.result_list[0].entities[0].mentions #=> Array
+    #   resp.result_list[0].entities[0].mentions[0].score #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].group_score #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].text #=> String
+    #   resp.result_list[0].entities[0].mentions[0].type #=> String, one of "PERSON", "LOCATION", "ORGANIZATION", "FACILITY", "BRAND", "COMMERCIAL_ITEM", "MOVIE", "MUSIC", "BOOK", "SOFTWARE", "GAME", "PERSONAL_TITLE", "EVENT", "DATE", "QUANTITY", "ATTRIBUTE", "OTHER"
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment #=> String, one of "POSITIVE", "NEGATIVE", "NEUTRAL", "MIXED"
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.positive #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.negative #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.neutral #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.mixed #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].begin_offset #=> Integer
+    #   resp.result_list[0].entities[0].mentions[0].end_offset #=> Integer
+    #   resp.error_list #=> Array
+    #   resp.error_list[0].index #=> Integer
+    #   resp.error_list[0].error_code #=> String
+    #   resp.error_list[0].error_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/BatchDetectTargetedSentiment AWS API Documentation
+    #
+    # @overload batch_detect_targeted_sentiment(params = {})
+    # @param [Hash] params ({})
+    def batch_detect_targeted_sentiment(params = {}, options = {})
+      req = build_request(:batch_detect_targeted_sentiment, params)
+      req.send_request(options)
+    end
+
     # Creates a new document classification request to analyze a single
     # document in real-time, using a previously created and trained custom
     # model and an endpoint.
@@ -655,9 +734,7 @@ module Aws::Comprehend
     # types such as name, address, bank account number, or phone number.
     #
     # @option params [required, String] :text
-    #   Creates a new document classification request to analyze a single
-    #   document in real-time, returning personally identifiable information
-    #   (PII) entity labels.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. Currently, English is the only
@@ -694,7 +771,11 @@ module Aws::Comprehend
     # documents that labeled with the categories that you want to use. After
     # the classifier is trained you can use it to categorize a set of
     # labeled documents into the categories. For more information, see
-    # how-document-classification.
+    # [Document Classification][1] in the Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-document-classification.html
     #
     # @option params [required, String] :document_classifier_name
     #   The name of the document classifier.
@@ -1896,8 +1977,8 @@ module Aws::Comprehend
     # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-languages.html
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string should contain at least 20 characters
-    #   and must contain fewer that 5,000 bytes of UTF-8 encoded characters.
+    #   A UTF-8 text string. The string must contain at least 20 characters.
+    #   The maximum string size is 100 KB.
     #
     # @return [Types::DetectDominantLanguageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1925,11 +2006,15 @@ module Aws::Comprehend
     end
 
     # Inspects text for named entities, and returns information about them.
-    # For more information, about named entities, see how-entities.
+    # For more information, about named entities, see [Entities][1] in the
+    # Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #
     # @option params [String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -1989,8 +2074,8 @@ module Aws::Comprehend
     # Detects the key noun phrases found in the text.
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The string must contain less than 100 KB of UTF-8
+    #   encoded characters.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -2029,8 +2114,7 @@ module Aws::Comprehend
     # identifiable information (PII) and returns information about them.
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. Currently, English is the only
@@ -2068,8 +2152,13 @@ module Aws::Comprehend
     # (`POSITIVE`, `NEUTRAL`, `MIXED`, or `NEGATIVE`).
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 5 KB.
+    #
+    #   <note markdown="1"> Amazon Comprehend performs real-time sentiment analysis on the first
+    #   500 characters of the input text and ignores any additional text in
+    #   the input.
+    #
+    #    </note>
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -2106,11 +2195,15 @@ module Aws::Comprehend
     end
 
     # Inspects text for syntax and the part of speech of words in the
-    # document. For more information, how-syntax.
+    # document. For more information, see [Syntax][1] in the Comprehend
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html
     #
     # @option params [required, String] :text
-    #   A UTF-8 string. Each string must contain fewer that 5,000 bytes of UTF
-    #   encoded characters.
+    #   A UTF-8 string. The maximum string size is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language code of the input documents. You can specify any of the
@@ -2148,6 +2241,61 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Inspects the input text and returns a sentiment analysis for each
+    # entity identified in the text.
+    #
+    # For more information about targeted sentiment, see [Targeted
+    # sentiment][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html
+    #
+    # @option params [required, String] :text
+    #   A UTF-8 text string. The maximum string length is 5 KB.
+    #
+    # @option params [required, String] :language_code
+    #   The language of the input documents. Currently, English is the only
+    #   supported language.
+    #
+    # @return [Types::DetectTargetedSentimentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DetectTargetedSentimentResponse#entities #entities} => Array&lt;Types::TargetedSentimentEntity&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.detect_targeted_sentiment({
+    #     text: "CustomerInputString", # required
+    #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.entities #=> Array
+    #   resp.entities[0].descriptive_mention_index #=> Array
+    #   resp.entities[0].descriptive_mention_index[0] #=> Integer
+    #   resp.entities[0].mentions #=> Array
+    #   resp.entities[0].mentions[0].score #=> Float
+    #   resp.entities[0].mentions[0].group_score #=> Float
+    #   resp.entities[0].mentions[0].text #=> String
+    #   resp.entities[0].mentions[0].type #=> String, one of "PERSON", "LOCATION", "ORGANIZATION", "FACILITY", "BRAND", "COMMERCIAL_ITEM", "MOVIE", "MUSIC", "BOOK", "SOFTWARE", "GAME", "PERSONAL_TITLE", "EVENT", "DATE", "QUANTITY", "ATTRIBUTE", "OTHER"
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment #=> String, one of "POSITIVE", "NEGATIVE", "NEUTRAL", "MIXED"
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.positive #=> Float
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.negative #=> Float
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.neutral #=> Float
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.mixed #=> Float
+    #   resp.entities[0].mentions[0].begin_offset #=> Integer
+    #   resp.entities[0].mentions[0].end_offset #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectTargetedSentiment AWS API Documentation
+    #
+    # @overload detect_targeted_sentiment(params = {})
+    # @param [Hash] params ({})
+    def detect_targeted_sentiment(params = {}, options = {})
+      req = build_request(:detect_targeted_sentiment, params)
+      req.send_request(options)
+    end
+
     # Creates a new custom model that replicates a source custom model that
     # you import. The source model can be in your AWS account or another
     # one.
@@ -4063,7 +4211,7 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. Currently, English is the only
-    #   valid language.
+    #   supported language.
     #
     # @option params [String] :client_request_token
     #   A unique identifier for the request. If you don't set the client
@@ -4720,7 +4868,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.61.0'
+      context[:gem_version] = '1.62.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -33,6 +33,9 @@ module Aws::Comprehend
     BatchDetectSyntaxItemResult = Shapes::StructureShape.new(name: 'BatchDetectSyntaxItemResult')
     BatchDetectSyntaxRequest = Shapes::StructureShape.new(name: 'BatchDetectSyntaxRequest')
     BatchDetectSyntaxResponse = Shapes::StructureShape.new(name: 'BatchDetectSyntaxResponse')
+    BatchDetectTargetedSentimentItemResult = Shapes::StructureShape.new(name: 'BatchDetectTargetedSentimentItemResult')
+    BatchDetectTargetedSentimentRequest = Shapes::StructureShape.new(name: 'BatchDetectTargetedSentimentRequest')
+    BatchDetectTargetedSentimentResponse = Shapes::StructureShape.new(name: 'BatchDetectTargetedSentimentResponse')
     BatchItemError = Shapes::StructureShape.new(name: 'BatchItemError')
     BatchItemErrorList = Shapes::ListShape.new(name: 'BatchItemErrorList')
     BatchSizeLimitExceededException = Shapes::StructureShape.new(name: 'BatchSizeLimitExceededException')
@@ -103,6 +106,8 @@ module Aws::Comprehend
     DetectSentimentResponse = Shapes::StructureShape.new(name: 'DetectSentimentResponse')
     DetectSyntaxRequest = Shapes::StructureShape.new(name: 'DetectSyntaxRequest')
     DetectSyntaxResponse = Shapes::StructureShape.new(name: 'DetectSyntaxResponse')
+    DetectTargetedSentimentRequest = Shapes::StructureShape.new(name: 'DetectTargetedSentimentRequest')
+    DetectTargetedSentimentResponse = Shapes::StructureShape.new(name: 'DetectTargetedSentimentResponse')
     DocumentClass = Shapes::StructureShape.new(name: 'DocumentClass')
     DocumentClassificationJobFilter = Shapes::StructureShape.new(name: 'DocumentClassificationJobFilter')
     DocumentClassificationJobProperties = Shapes::StructureShape.new(name: 'DocumentClassificationJobProperties')
@@ -208,20 +213,24 @@ module Aws::Comprehend
     ListKeyPhrasesDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListKeyPhrasesDetectionJobsRequest')
     ListKeyPhrasesDetectionJobsResponse = Shapes::StructureShape.new(name: 'ListKeyPhrasesDetectionJobsResponse')
     ListOfClasses = Shapes::ListShape.new(name: 'ListOfClasses')
+    ListOfDescriptiveMentionIndices = Shapes::ListShape.new(name: 'ListOfDescriptiveMentionIndices')
     ListOfDetectDominantLanguageResult = Shapes::ListShape.new(name: 'ListOfDetectDominantLanguageResult')
     ListOfDetectEntitiesResult = Shapes::ListShape.new(name: 'ListOfDetectEntitiesResult')
     ListOfDetectKeyPhrasesResult = Shapes::ListShape.new(name: 'ListOfDetectKeyPhrasesResult')
     ListOfDetectSentimentResult = Shapes::ListShape.new(name: 'ListOfDetectSentimentResult')
     ListOfDetectSyntaxResult = Shapes::ListShape.new(name: 'ListOfDetectSyntaxResult')
+    ListOfDetectTargetedSentimentResult = Shapes::ListShape.new(name: 'ListOfDetectTargetedSentimentResult')
     ListOfDocumentReadFeatureTypes = Shapes::ListShape.new(name: 'ListOfDocumentReadFeatureTypes')
     ListOfDominantLanguages = Shapes::ListShape.new(name: 'ListOfDominantLanguages')
     ListOfEntities = Shapes::ListShape.new(name: 'ListOfEntities')
     ListOfEntityLabels = Shapes::ListShape.new(name: 'ListOfEntityLabels')
     ListOfKeyPhrases = Shapes::ListShape.new(name: 'ListOfKeyPhrases')
     ListOfLabels = Shapes::ListShape.new(name: 'ListOfLabels')
+    ListOfMentions = Shapes::ListShape.new(name: 'ListOfMentions')
     ListOfPiiEntities = Shapes::ListShape.new(name: 'ListOfPiiEntities')
     ListOfPiiEntityTypes = Shapes::ListShape.new(name: 'ListOfPiiEntityTypes')
     ListOfSyntaxTokens = Shapes::ListShape.new(name: 'ListOfSyntaxTokens')
+    ListOfTargetedSentimentEntities = Shapes::ListShape.new(name: 'ListOfTargetedSentimentEntities')
     ListPiiEntitiesDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListPiiEntitiesDetectionJobsRequest')
     ListPiiEntitiesDetectionJobsResponse = Shapes::StructureShape.new(name: 'ListPiiEntitiesDetectionJobsResponse')
     ListSentimentDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListSentimentDetectionJobsRequest')
@@ -234,6 +243,7 @@ module Aws::Comprehend
     ListTopicsDetectionJobsResponse = Shapes::StructureShape.new(name: 'ListTopicsDetectionJobsResponse')
     MaskCharacter = Shapes::StringShape.new(name: 'MaskCharacter')
     MaxResultsInteger = Shapes::IntegerShape.new(name: 'MaxResultsInteger')
+    MentionSentiment = Shapes::StructureShape.new(name: 'MentionSentiment')
     ModelStatus = Shapes::StringShape.new(name: 'ModelStatus')
     NumberOfTopicsInteger = Shapes::IntegerShape.new(name: 'NumberOfTopicsInteger')
     OutputDataConfig = Shapes::StructureShape.new(name: 'OutputDataConfig')
@@ -317,6 +327,9 @@ module Aws::Comprehend
     TargetedSentimentDetectionJobFilter = Shapes::StructureShape.new(name: 'TargetedSentimentDetectionJobFilter')
     TargetedSentimentDetectionJobProperties = Shapes::StructureShape.new(name: 'TargetedSentimentDetectionJobProperties')
     TargetedSentimentDetectionJobPropertiesList = Shapes::ListShape.new(name: 'TargetedSentimentDetectionJobPropertiesList')
+    TargetedSentimentEntity = Shapes::StructureShape.new(name: 'TargetedSentimentEntity')
+    TargetedSentimentEntityType = Shapes::StringShape.new(name: 'TargetedSentimentEntityType')
+    TargetedSentimentMention = Shapes::StructureShape.new(name: 'TargetedSentimentMention')
     TextSizeLimitExceededException = Shapes::StructureShape.new(name: 'TextSizeLimitExceededException')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     TooManyRequestsException = Shapes::StructureShape.new(name: 'TooManyRequestsException')
@@ -403,6 +416,18 @@ module Aws::Comprehend
     BatchDetectSyntaxResponse.add_member(:error_list, Shapes::ShapeRef.new(shape: BatchItemErrorList, required: true, location_name: "ErrorList"))
     BatchDetectSyntaxResponse.struct_class = Types::BatchDetectSyntaxResponse
 
+    BatchDetectTargetedSentimentItemResult.add_member(:index, Shapes::ShapeRef.new(shape: Integer, location_name: "Index"))
+    BatchDetectTargetedSentimentItemResult.add_member(:entities, Shapes::ShapeRef.new(shape: ListOfTargetedSentimentEntities, location_name: "Entities"))
+    BatchDetectTargetedSentimentItemResult.struct_class = Types::BatchDetectTargetedSentimentItemResult
+
+    BatchDetectTargetedSentimentRequest.add_member(:text_list, Shapes::ShapeRef.new(shape: CustomerInputStringList, required: true, location_name: "TextList"))
+    BatchDetectTargetedSentimentRequest.add_member(:language_code, Shapes::ShapeRef.new(shape: LanguageCode, required: true, location_name: "LanguageCode"))
+    BatchDetectTargetedSentimentRequest.struct_class = Types::BatchDetectTargetedSentimentRequest
+
+    BatchDetectTargetedSentimentResponse.add_member(:result_list, Shapes::ShapeRef.new(shape: ListOfDetectTargetedSentimentResult, required: true, location_name: "ResultList"))
+    BatchDetectTargetedSentimentResponse.add_member(:error_list, Shapes::ShapeRef.new(shape: BatchItemErrorList, required: true, location_name: "ErrorList"))
+    BatchDetectTargetedSentimentResponse.struct_class = Types::BatchDetectTargetedSentimentResponse
+
     BatchItemError.add_member(:index, Shapes::ShapeRef.new(shape: Integer, location_name: "Index"))
     BatchItemError.add_member(:error_code, Shapes::ShapeRef.new(shape: String, location_name: "ErrorCode"))
     BatchItemError.add_member(:error_message, Shapes::ShapeRef.new(shape: String, location_name: "ErrorMessage"))
@@ -639,6 +664,13 @@ module Aws::Comprehend
     DetectSyntaxResponse.add_member(:syntax_tokens, Shapes::ShapeRef.new(shape: ListOfSyntaxTokens, location_name: "SyntaxTokens"))
     DetectSyntaxResponse.struct_class = Types::DetectSyntaxResponse
 
+    DetectTargetedSentimentRequest.add_member(:text, Shapes::ShapeRef.new(shape: CustomerInputString, required: true, location_name: "Text"))
+    DetectTargetedSentimentRequest.add_member(:language_code, Shapes::ShapeRef.new(shape: LanguageCode, required: true, location_name: "LanguageCode"))
+    DetectTargetedSentimentRequest.struct_class = Types::DetectTargetedSentimentRequest
+
+    DetectTargetedSentimentResponse.add_member(:entities, Shapes::ShapeRef.new(shape: ListOfTargetedSentimentEntities, location_name: "Entities"))
+    DetectTargetedSentimentResponse.struct_class = Types::DetectTargetedSentimentResponse
+
     DocumentClass.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
     DocumentClass.add_member(:score, Shapes::ShapeRef.new(shape: Float, location_name: "Score"))
     DocumentClass.struct_class = Types::DocumentClass
@@ -1064,6 +1096,8 @@ module Aws::Comprehend
 
     ListOfClasses.member = Shapes::ShapeRef.new(shape: DocumentClass)
 
+    ListOfDescriptiveMentionIndices.member = Shapes::ShapeRef.new(shape: Integer)
+
     ListOfDetectDominantLanguageResult.member = Shapes::ShapeRef.new(shape: BatchDetectDominantLanguageItemResult)
 
     ListOfDetectEntitiesResult.member = Shapes::ShapeRef.new(shape: BatchDetectEntitiesItemResult)
@@ -1074,6 +1108,8 @@ module Aws::Comprehend
 
     ListOfDetectSyntaxResult.member = Shapes::ShapeRef.new(shape: BatchDetectSyntaxItemResult)
 
+    ListOfDetectTargetedSentimentResult.member = Shapes::ShapeRef.new(shape: BatchDetectTargetedSentimentItemResult)
+
     ListOfDocumentReadFeatureTypes.member = Shapes::ShapeRef.new(shape: DocumentReadFeatureTypes)
 
     ListOfDominantLanguages.member = Shapes::ShapeRef.new(shape: DominantLanguage)
@@ -1086,12 +1122,16 @@ module Aws::Comprehend
 
     ListOfLabels.member = Shapes::ShapeRef.new(shape: DocumentLabel)
 
+    ListOfMentions.member = Shapes::ShapeRef.new(shape: TargetedSentimentMention)
+
     ListOfPiiEntities.member = Shapes::ShapeRef.new(shape: PiiEntity)
 
     ListOfPiiEntityTypes.member = Shapes::ShapeRef.new(shape: PiiEntityType)
 
     ListOfSyntaxTokens.member = Shapes::ShapeRef.new(shape: SyntaxToken)
 
+    ListOfTargetedSentimentEntities.member = Shapes::ShapeRef.new(shape: TargetedSentimentEntity)
+
     ListPiiEntitiesDetectionJobsRequest.add_member(:filter, Shapes::ShapeRef.new(shape: PiiEntitiesDetectionJobFilter, location_name: "Filter"))
     ListPiiEntitiesDetectionJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListPiiEntitiesDetectionJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
@@ -1135,6 +1175,10 @@ module Aws::Comprehend
     ListTopicsDetectionJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListTopicsDetectionJobsResponse.struct_class = Types::ListTopicsDetectionJobsResponse
 
+    MentionSentiment.add_member(:sentiment, Shapes::ShapeRef.new(shape: SentimentType, location_name: "Sentiment"))
+    MentionSentiment.add_member(:sentiment_score, Shapes::ShapeRef.new(shape: SentimentScore, location_name: "SentimentScore"))
+    MentionSentiment.struct_class = Types::MentionSentiment
+
     OutputDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
     OutputDataConfig.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "KmsKeyId"))
     OutputDataConfig.struct_class = Types::OutputDataConfig
@@ -1482,6 +1526,19 @@ module Aws::Comprehend
 
     TargetedSentimentDetectionJobPropertiesList.member = Shapes::ShapeRef.new(shape: TargetedSentimentDetectionJobProperties)
 
+    TargetedSentimentEntity.add_member(:descriptive_mention_index, Shapes::ShapeRef.new(shape: ListOfDescriptiveMentionIndices, location_name: "DescriptiveMentionIndex"))
+    TargetedSentimentEntity.add_member(:mentions, Shapes::ShapeRef.new(shape: ListOfMentions, location_name: "Mentions"))
+    TargetedSentimentEntity.struct_class = Types::TargetedSentimentEntity
+
+    TargetedSentimentMention.add_member(:score, Shapes::ShapeRef.new(shape: Float, location_name: "Score"))
+    TargetedSentimentMention.add_member(:group_score, Shapes::ShapeRef.new(shape: Float, location_name: "GroupScore"))
+    TargetedSentimentMention.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "Text"))
+    TargetedSentimentMention.add_member(:type, Shapes::ShapeRef.new(shape: TargetedSentimentEntityType, location_name: "Type"))
+    TargetedSentimentMention.add_member(:mention_sentiment, Shapes::ShapeRef.new(shape: MentionSentiment, location_name: "MentionSentiment"))
+    TargetedSentimentMention.add_member(:begin_offset, Shapes::ShapeRef.new(shape: Integer, location_name: "BeginOffset"))
+    TargetedSentimentMention.add_member(:end_offset, Shapes::ShapeRef.new(shape: Integer, location_name: "EndOffset"))
+    TargetedSentimentMention.struct_class = Types::TargetedSentimentMention
+
     TextSizeLimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     TextSizeLimitExceededException.struct_class = Types::TextSizeLimitExceededException
 
@@ -1621,6 +1678,19 @@ module Aws::Comprehend
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:batch_detect_targeted_sentiment, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "BatchDetectTargetedSentiment"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: BatchDetectTargetedSentimentRequest)
+        o.output = Shapes::ShapeRef.new(shape: BatchDetectTargetedSentimentResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TextSizeLimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedLanguageException)
+        o.errors << Shapes::ShapeRef.new(shape: BatchSizeLimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:classify_document, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ClassifyDocument"
         o.http_method = "POST"
@@ -1972,6 +2042,18 @@ module Aws::Comprehend
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:detect_targeted_sentiment, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DetectTargetedSentiment"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DetectTargetedSentimentRequest)
+        o.output = Shapes::ShapeRef.new(shape: DetectTargetedSentimentResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TextSizeLimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedLanguageException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:import_model, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ImportModel"
         o.http_method = "POST"

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

@@ -126,10 +126,10 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document should contain at
-    #   least 20 characters and must contain fewer than 5,000 bytes of UTF-8
-    #   encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. Each document should
+    #   contain at least 20 characters. The maximum size of each document is
+    #   5 KB.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/BatchDetectDominantLanguageRequest AWS API Documentation
@@ -193,9 +193,9 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   than 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
     #   @return [Array<String>]
     #
     # @!attribute [rw] language_code
@@ -266,9 +266,9 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   than 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
     #   @return [Array<String>]
     #
     # @!attribute [rw] language_code
@@ -344,9 +344,15 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   that 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
+    #
+    #   <note markdown="1"> Amazon Comprehend performs real-time sentiment analysis on the first
+    #   500 characters of the input text and ignores any additional text in
+    #   the input.
+    #
+    #    </note>
     #   @return [Array<String>]
     #
     # @!attribute [rw] language_code
@@ -417,9 +423,9 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   that 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size for
+    #   each document is 5 KB.
     #   @return [Array<String>]
     #
     # @!attribute [rw] language_code
@@ -462,6 +468,73 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # Analysis results for one of the documents in the batch.
+    #
+    # @!attribute [rw] index
+    #   The zero-based index of this result in the input list.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] entities
+    #   An array of targeted sentiment entities.
+    #   @return [Array<Types::TargetedSentimentEntity>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/BatchDetectTargetedSentimentItemResult AWS API Documentation
+    #
+    class BatchDetectTargetedSentimentItemResult < Struct.new(
+      :index,
+      :entities)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass BatchDetectTargetedSentimentRequest
+    #   data as a hash:
+    #
+    #       {
+    #         text_list: ["CustomerInputString"], # required
+    #         language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #       }
+    #
+    # @!attribute [rw] text_list
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] language_code
+    #   The language of the input documents. Currently, English is the only
+    #   supported language.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/BatchDetectTargetedSentimentRequest AWS API Documentation
+    #
+    class BatchDetectTargetedSentimentRequest < Struct.new(
+      :text_list,
+      :language_code)
+      SENSITIVE = [:text_list]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] result_list
+    #   A list of objects containing the results of the operation. The
+    #   results are sorted in ascending order by the `Index` field and match
+    #   the order of the documents in the input list. If all of the
+    #   documents contain an error, the `ResultList` is empty.
+    #   @return [Array<Types::BatchDetectTargetedSentimentItemResult>]
+    #
+    # @!attribute [rw] error_list
+    #   List of errors that the operation can return.
+    #   @return [Array<Types::BatchItemError>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/BatchDetectTargetedSentimentResponse AWS API Documentation
+    #
+    class BatchDetectTargetedSentimentResponse < Struct.new(
+      :result_list,
+      :error_list)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes an error that occurred while processing a document in a
     # batch. The operation returns on `BatchItemError` object for each
     # document that contained an error.
@@ -692,9 +765,7 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text
-    #   Creates a new document classification request to analyze a single
-    #   document in real-time, returning personally identifiable information
-    #   (PII) entity labels.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #   @return [String]
     #
     # @!attribute [rw] language_code
@@ -1728,9 +1799,8 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text
-    #   A UTF-8 text string. Each string should contain at least 20
-    #   characters and must contain fewer that 5,000 bytes of UTF-8 encoded
-    #   characters.
+    #   A UTF-8 text string. The string must contain at least 20 characters.
+    #   The maximum string size is 100 KB.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectDominantLanguageRequest AWS API Documentation
@@ -1771,8 +1841,7 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #   @return [String]
     #
     # @!attribute [rw] language_code
@@ -1822,7 +1891,12 @@ module Aws::Comprehend
     #   If your request uses a custom entity recognition model, Amazon
     #   Comprehend detects the entities that the model is trained to
     #   recognize. Otherwise, it detects the default entity types. For a
-    #   list of default entity types, see how-entities.
+    #   list of default entity types, see [Entities][1] in the Comprehend
+    #   Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html
     #   @return [Array<Types::Entity>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectEntitiesResponse AWS API Documentation
@@ -1842,8 +1916,8 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The string must contain less than 100 KB of
+    #   UTF-8 encoded characters.
     #   @return [String]
     #
     # @!attribute [rw] language_code
@@ -1886,8 +1960,7 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #   @return [String]
     #
     # @!attribute [rw] language_code
@@ -1928,8 +2001,13 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 5 KB.
+    #
+    #   <note markdown="1"> Amazon Comprehend performs real-time sentiment analysis on the first
+    #   500 characters of the input text and ignores any additional text in
+    #   the input.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] language_code
@@ -1975,8 +2053,7 @@ module Aws::Comprehend
     #       }
     #
     # @!attribute [rw] text
-    #   A UTF-8 string. Each string must contain fewer that 5,000 bytes of
-    #   UTF encoded characters.
+    #   A UTF-8 string. The maximum string size is 5 KB.
     #   @return [String]
     #
     # @!attribute [rw] language_code
@@ -2000,7 +2077,11 @@ module Aws::Comprehend
     #   the response provides the text, the token type, where the text
     #   begins and ends, and the level of confidence that Amazon Comprehend
     #   has that the token is correct. For a list of token types, see
-    #   how-syntax.
+    #   [Syntax][1] in the Comprehend Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html
     #   @return [Array<Types::SyntaxToken>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectSyntaxResponse AWS API Documentation
@@ -2011,6 +2092,45 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DetectTargetedSentimentRequest
+    #   data as a hash:
+    #
+    #       {
+    #         text: "CustomerInputString", # required
+    #         language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #       }
+    #
+    # @!attribute [rw] text
+    #   A UTF-8 text string. The maximum string length is 5 KB.
+    #   @return [String]
+    #
+    # @!attribute [rw] language_code
+    #   The language of the input documents. Currently, English is the only
+    #   supported language.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectTargetedSentimentRequest AWS API Documentation
+    #
+    class DetectTargetedSentimentRequest < Struct.new(
+      :text,
+      :language_code)
+      SENSITIVE = [:text]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] entities
+    #   Targeted sentiment analysis for each of the entities identified in
+    #   the input text.
+    #   @return [Array<Types::TargetedSentimentEntity>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectTargetedSentimentResponse AWS API Documentation
+    #
+    class DetectTargetedSentimentResponse < Struct.new(
+      :entities)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Specifies the class that categorizes the document being analyzed
     #
     # @!attribute [rw] name
@@ -2233,7 +2353,11 @@ module Aws::Comprehend
     # The input properties for training a document classifier.
     #
     # For more information on how the input file is formatted, see
-    # prep-classifier-data.
+    # [Preparing training data][1] in the Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/prep-classifier-data.html
     #
     # @note When making an API call, you may pass DocumentClassifierInputDataConfig
     #   data as a hash:
@@ -2291,10 +2415,9 @@ module Aws::Comprehend
     #   @return [String]
     #
     # @!attribute [rw] test_s3_uri
-    #   The Amazon S3 URI for the input data. The Amazon S3 bucket must be
-    #   in the same AWS Region as the API endpoint that you are calling. The
-    #   URI can point to a single input file or it can provide the prefix
-    #   for a collection of input files.
+    #   This specifies the Amazon S3 location where the test annotations for
+    #   an entity recognizer are located. The URI must be in the same AWS
+    #   Region as the API endpoint that you are calling.
     #   @return [String]
     #
     # @!attribute [rw] label_delimiter
@@ -3091,20 +3214,13 @@ module Aws::Comprehend
     #   @return [String]
     #
     # @!attribute [rw] begin_offset
-    #   A character offset in the input text that shows where the entity
-    #   begins (the first character is at position 0). The offset returns
-    #   the position of each UTF-8 code point in the string. A *code point*
-    #   is the abstract character from a particular graphical
-    #   representation. For example, a multi-byte UTF-8 character maps to a
-    #   single code point.
+    #   The zero-based offset from the beginning of the source text to the
+    #   first character in the entity.
     #   @return [Integer]
     #
     # @!attribute [rw] end_offset
-    #   A character offset in the input text that shows where the entity
-    #   ends. The offset returns the position of each UTF-8 code point in
-    #   the string. A *code point* is the abstract character from a
-    #   particular graphical representation. For example, a multi-byte UTF-8
-    #   character maps to a single code point.
+    #   The zero-based offset from the beginning of the source text to the
+    #   last character in the entity.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/Entity AWS API Documentation
@@ -3157,9 +3273,9 @@ module Aws::Comprehend
     #   @return [String]
     #
     # @!attribute [rw] test_s3_uri
-    #   This specifies the Amazon S3 location where the test annotations for
-    #   an entity recognizer are located. The URI must be in the same AWS
-    #   Region as the API endpoint that you are calling.
+    #   Specifies the Amazon S3 location where the test annotations for an
+    #   entity recognizer are located. The URI must be in the same region as
+    #   the API endpoint that you are calling.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerAnnotations AWS API Documentation
@@ -4041,20 +4157,13 @@ module Aws::Comprehend
     #   @return [String]
     #
     # @!attribute [rw] begin_offset
-    #   A character offset in the input text that shows where the key phrase
-    #   begins (the first character is at position 0). The offset returns
-    #   the position of each UTF-8 code point in the string. A *code point*
-    #   is the abstract character from a particular graphical
-    #   representation. For example, a multi-byte UTF-8 character maps to a
-    #   single code point.
+    #   The zero-based offset from the beginning of the source text to the
+    #   first character in the key phrase.
     #   @return [Integer]
     #
     # @!attribute [rw] end_offset
-    #   A character offset in the input text where the key phrase ends. The
-    #   offset returns the position of each UTF-8 code point in the string.
-    #   A `code point` is the abstract character from a particular graphical
-    #   representation. For example, a multi-byte UTF-8 character maps to a
-    #   single code point.
+    #   The zero-based offset from the beginning of the source text to the
+    #   last character in the key phrase.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/KeyPhrase AWS API Documentation
@@ -5030,6 +5139,34 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # Contains the sentiment and sentiment score for one mention of an
+    # entity.
+    #
+    # For more information about targeted sentiment, see [Targeted
+    # sentiment][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html
+    #
+    # @!attribute [rw] sentiment
+    #   The sentiment of the mention.
+    #   @return [String]
+    #
+    # @!attribute [rw] sentiment_score
+    #   Describes the level of confidence that Amazon Comprehend has in the
+    #   accuracy of its detection of sentiments.
+    #   @return [Types::SentimentScore]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/MentionSentiment AWS API Documentation
+    #
+    class MentionSentiment < Struct.new(
+      :sentiment,
+      :sentiment_score)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides configuration parameters for the output of inference jobs.
     #
     # @note When making an API call, you may pass OutputDataConfig
@@ -5085,7 +5222,12 @@ module Aws::Comprehend
     # Identifies the part of speech represented by the token and gives the
     # confidence that Amazon Comprehend has that the part of speech was
     # correctly identified. For more information about the parts of speech
-    # that Amazon Comprehend can identify, see how-syntax.
+    # that Amazon Comprehend can identify, see [Syntax][1] in the Comprehend
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html
     #
     # @!attribute [rw] tag
     #   Identifies the part of speech that the token represents.
@@ -5256,20 +5398,13 @@ module Aws::Comprehend
     #   @return [String]
     #
     # @!attribute [rw] begin_offset
-    #   A character offset in the input text that shows where the PII entity
-    #   begins (the first character is at position 0). The offset returns
-    #   the position of each UTF-8 code point in the string. A *code point*
-    #   is the abstract character from a particular graphical
-    #   representation. For example, a multi-byte UTF-8 character maps to a
-    #   single code point.
+    #   The zero-based offset from the beginning of the source text to the
+    #   first character in the entity.
     #   @return [Integer]
     #
     # @!attribute [rw] end_offset
-    #   A character offset in the input text that shows where the PII entity
-    #   ends. The offset returns the position of each UTF-8 code point in
-    #   the string. A *code point* is the abstract character from a
-    #   particular graphical representation. For example, a multi-byte UTF-8
-    #   character maps to a single code point.
+    #   The zero-based offset from the beginning of the source text to the
+    #   last character in the entity.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/PiiEntity AWS API Documentation
@@ -6756,7 +6891,7 @@ module Aws::Comprehend
     #
     # @!attribute [rw] language_code
     #   The language of the input documents. Currently, English is the only
-    #   valid language.
+    #   supported language.
     #   @return [String]
     #
     # @!attribute [rw] client_request_token
@@ -7351,7 +7486,12 @@ module Aws::Comprehend
     # @!attribute [rw] part_of_speech
     #   Provides the part of speech label and the confidence level that
     #   Amazon Comprehend has that the part of speech was correctly
-    #   identified. For more information, see how-syntax.
+    #   identified. For more information, see [Syntax][1] in the Comprehend
+    #   Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html
     #   @return [Types::PartOfSpeechTag]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/SyntaxToken AWS API Documentation
@@ -7590,6 +7730,100 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # Information about one of the entities found by targeted sentiment
+    # analysis.
+    #
+    # For more information about targeted sentiment, see [Targeted
+    # sentiment][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html
+    #
+    # @!attribute [rw] descriptive_mention_index
+    #   One or more index into the Mentions array that provides the best
+    #   name for the entity group.
+    #   @return [Array<Integer>]
+    #
+    # @!attribute [rw] mentions
+    #   An array of mentions of the entity in the document. The array
+    #   represents a co-reference group. See [ Co-reference group][1] for an
+    #   example.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html#how-targeted-sentiment-values
+    #   @return [Array<Types::TargetedSentimentMention>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/TargetedSentimentEntity AWS API Documentation
+    #
+    class TargetedSentimentEntity < Struct.new(
+      :descriptive_mention_index,
+      :mentions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Information about one mention of an entity. The mention information
+    # includes the location of the mention in the text and the sentiment of
+    # the mention.
+    #
+    # For more information about targeted sentiment, see [Targeted
+    # sentiment][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html
+    #
+    # @!attribute [rw] score
+    #   Model confidence that the entity is relevant. Value range is zero to
+    #   one, where one is highest confidence.
+    #   @return [Float]
+    #
+    # @!attribute [rw] group_score
+    #   The confidence that all the entities mentioned in the group relate
+    #   to the same entity.
+    #   @return [Float]
+    #
+    # @!attribute [rw] text
+    #   The text in the document that identifies the entity.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The type of the entity. Amazon Comprehend supports a variety of
+    #   [entity types][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html#how-targeted-sentiment-entities
+    #   @return [String]
+    #
+    # @!attribute [rw] mention_sentiment
+    #   Contains the sentiment and sentiment score for the mention.
+    #   @return [Types::MentionSentiment]
+    #
+    # @!attribute [rw] begin_offset
+    #   The offset into the document text where the mention begins.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] end_offset
+    #   The offset into the document text where the mention ends.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/TargetedSentimentMention AWS API Documentation
+    #
+    class TargetedSentimentMention < Struct.new(
+      :score,
+      :group_score,
+      :text,
+      :type,
+      :mention_sentiment,
+      :begin_offset,
+      :end_offset)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The size of the input text exceeds the limit. Use a smaller document.
     #
     # @!attribute [rw] message
@@ -7798,7 +8032,11 @@ module Aws::Comprehend
     # Amazon Comprehend can't process the language of the input text. For
     # custom entity recognition APIs, only English, Spanish, French,
     # Italian, German, or Portuguese are accepted. For a list of supported
-    # languages, see supported-languages.
+    # languages, [Supported languages][1] in the Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/supported-languages.html
     #
     # @!attribute [rw] message
     #   @return [String]

data/lib/aws-sdk-comprehend.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-comprehend/customizations'
 # @!group service
 module Aws::Comprehend
 
-  GEM_VERSION = '1.61.0'
+  GEM_VERSION = '1.62.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-comprehend
 version: !ruby/object:Gem::Version
-  version: 1.61.0
+  version: 1.62.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-20 00:00:00.000000000 Z
+date: 2022-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core