aws-sdk-textract 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e4cca400ed79e0db32dc117da71bcf9e64c8ea80
-  data.tar.gz: 15250eeb7f588474ab18bc9db8b2709745663476
+  metadata.gz: bb5796435f32cf464a826d8a950bfd4530ce0653
+  data.tar.gz: '099358286d8dee94332f1e18da3028c18abd5d8b'
 SHA512:
-  metadata.gz: a4e8418f8541deee215b9eb5838d8e3e5648ed5dd3b3315447c5fd11a84ec010c14932be840808528a1317a1f18dd1c55e8199a815fa3b170405c456303af9ba
-  data.tar.gz: be85b0fc679517abc96e7cfba7905bece767552a3108117252c6b60a759bf044da86a0b5a1e07529682d320433fb9f79b509ab16a767abd705669f44dbd8339e
+  metadata.gz: 0f45a24e21f46c9f0c44a619e0e2b272288c42fe68484cfa997f280cbb3e8bf35db471565e620154e6f95898f821da77500554801e40b628488333632961adb5
+  data.tar.gz: da14d00c06ecc20b0b246c7a7b5235c2582460356a4d4c1d58f6cda494de28cb7d76e24e7d0462692d6fd9dc1e6bbae417e64bfa28db714cd867ad735e3fd554

data/lib/aws-sdk-textract.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-textract/customizations'
 # @service
 module Aws::Textract
 
-  GEM_VERSION = '1.3.0'
+  GEM_VERSION = '1.4.0'
 
 end

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

@@ -209,40 +209,98 @@ module Aws::Textract
     #     When `true`, request parameters are validated before
     #     sending the request.
     #
+    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
+    #     requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_open_timeout (15) The number of
+    #     seconds to wait when opening a HTTP session before rasing a
+    #     `Timeout::Error`.
+    #
+    #   @option options [Integer] :http_read_timeout (60) The default
+    #     number of seconds to wait for response data.  This value can
+    #     safely be set
+    #     per-request on the session yeidled by {#session_for}.
+    #
+    #   @option options [Float] :http_idle_timeout (5) The number of
+    #     seconds a connection is allowed to sit idble before it is
+    #     considered stale.  Stale connections are closed and removed
+    #     from the pool before making a request.
+    #
+    #   @option options [Float] :http_continue_timeout (1) The number of
+    #     seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has
+    #     "Expect" header set to "100-continue".  Defaults to `nil` which
+    #     disables this behaviour.  This value can safely be set per
+    #     request on the session yeidled by {#session_for}.
+    #
+    #   @option options [Boolean] :http_wire_trace (false) When `true`,
+    #     HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
+    #     SSL peer certificates are verified when establishing a
+    #     connection.
+    #
+    #   @option options [String] :ssl_ca_bundle Full path to the SSL
+    #     certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass
+    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
+    #     will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory Full path of the
+    #     directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
+    #     system default will be used if available.
+    #
     def initialize(*args)
       super
     end
 
     # @!group API Operations
 
-    # Analyzes an input document for relationships in the detected text and
-    # tables.
+    # Analyzes an input document for relationships between detected items.
     #
-    # Two types of information are returned:
+    # The types of information returned are as follows:
     #
     # * Words and lines that are related to nearby lines and words. The
-    #   related information is returned in two Block objects: a KEY Block
-    #   object and a VALUE Block object. For example, *Name: Ana Silva
-    #   Carolina* contains a key and value. *Name:* is the key. *Ana Silva
-    #   Carolina* is the value.
+    #   related information is returned in two Block objects each of type
+    #   `KEY_VALUE_SET`\: a KEY Block object and a VALUE Block object. For
+    #   example, *Name: Ana Silva Carolina* contains a key and value.
+    #   *Name:* is the key. *Ana Silva Carolina* is the value.
+    #
+    # * Table and table cell data. A TABLE Block object contains information
+    #   about a detected table. A CELL Block object is returned for each
+    #   cell in a table.
+    #
+    # * Selectable elements such as checkboxes and radio buttons. A
+    #   SELECTION\_ELEMENT Block object contains information about a
+    #   selectable element.
     #
-    # * Table and table cell data. A TABLE Block contains information about
-    #   a detected table. A CELL block is returned for each cell in a table.
+    # * Lines and words of text. A LINE Block object contains one or more
+    #   WORD Block objects.
     #
     # You can choose which type of analysis to perform by specifying the
     # `FeatureTypes` list.
     #
-    # The output is returned in a list of `BLOCK` objects (Blocks). For more
-    # information, see how-it-works-analyzing.
+    # The output is returned in a list of `BLOCK` objects.
     #
     # `AnalyzeDocument` is a synchronous operation. To analyze documents
     # asynchronously, use StartDocumentAnalysis.
     #
+    # For more information, see [Document Text Analysis][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html
+    #
     # @option params [required, Types::Document] :document
     #   The input document as base64-encoded bytes or an Amazon S3 object. If
     #   you use the AWS CLI to call Amazon Textract operations, you can't
     #   pass image bytes. The document must be an image in JPG or PNG format.
     #
+    #   If you are using an AWS SDK to call Amazon Textract, you might not
+    #   need to base64-encode image bytes passed using the `Bytes` field.
+    #
     # @option params [required, Array<String>] :feature_types
     #   A list of the types of analysis to perform. Add TABLES to the list to
     #   return information about the tables detected in the input document.
@@ -273,7 +331,7 @@ module Aws::Textract
     #
     #   resp.document_metadata.pages #=> Integer
     #   resp.blocks #=> Array
-    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL"
+    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL", "SELECTION_ELEMENT"
     #   resp.blocks[0].confidence #=> Float
     #   resp.blocks[0].text #=> String
     #   resp.blocks[0].row_index #=> Integer
@@ -294,6 +352,7 @@ module Aws::Textract
     #   resp.blocks[0].relationships[0].ids[0] #=> String
     #   resp.blocks[0].entity_types #=> Array
     #   resp.blocks[0].entity_types[0] #=> String, one of "KEY", "VALUE"
+    #   resp.blocks[0].selection_status #=> String, one of "SELECTED", "NOT_SELECTED"
     #   resp.blocks[0].page #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/AnalyzeDocument AWS API Documentation
@@ -308,17 +367,31 @@ module Aws::Textract
     # Detects text in the input document. Amazon Textract can detect lines
     # of text and the words that make up a line of text. The input document
     # must be an image in JPG or PNG format. `DetectDocumentText` returns
-    # the detected text in an array of Block objects. For more information,
-    # see how-it-works-detecting.
+    # the detected text in an array of Block objects.
+    #
+    # Each document page has as an associated `Block` of type PAGE. Each
+    # PAGE `Block` object is the parent of LINE `Block` objects that
+    # represent the lines of detected text on a page. A LINE `Block` object
+    # is a parent for each word that makes up the line. Words are
+    # represented by `Block` objects of type WORD.
     #
     # `DetectDocumentText` is a synchronous operation. To analyze documents
     # asynchronously, use StartDocumentTextDetection.
     #
+    # For more information, see [Document Text Detection][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html
+    #
     # @option params [required, Types::Document] :document
     #   The input document as base64-encoded bytes or an Amazon S3 object. If
     #   you use the AWS CLI to call Amazon Textract operations, you can't
     #   pass image bytes. The document must be an image in JPG or PNG format.
     #
+    #   If you are using an AWS SDK to call Amazon Textract, you might not
+    #   need to base64-encode image bytes passed using the `Bytes` field.
+    #
     # @return [Types::DetectDocumentTextResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DetectDocumentTextResponse#document_metadata #document_metadata} => Types::DocumentMetadata
@@ -341,7 +414,7 @@ module Aws::Textract
     #
     #   resp.document_metadata.pages #=> Integer
     #   resp.blocks #=> Array
-    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL"
+    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL", "SELECTION_ELEMENT"
     #   resp.blocks[0].confidence #=> Float
     #   resp.blocks[0].text #=> String
     #   resp.blocks[0].row_index #=> Integer
@@ -362,6 +435,7 @@ module Aws::Textract
     #   resp.blocks[0].relationships[0].ids[0] #=> String
     #   resp.blocks[0].entity_types #=> Array
     #   resp.blocks[0].entity_types[0] #=> String, one of "KEY", "VALUE"
+    #   resp.blocks[0].selection_status #=> String, one of "SELECTED", "NOT_SELECTED"
     #   resp.blocks[0].page #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/DetectDocumentText AWS API Documentation
@@ -374,7 +448,7 @@ module Aws::Textract
     end
 
     # Gets the results for an Amazon Textract asynchronous operation that
-    # analyzes text in a document image.
+    # analyzes text in a document.
     #
     # You start asynchronous text analysis by calling StartDocumentAnalysis,
     # which returns a job identifier (`JobId`). When the text analysis
@@ -386,8 +460,25 @@ module Aws::Textract
     # `GetDocumentAnalysis`, and pass the job identifier (`JobId`) from the
     # initial call to `StartDocumentAnalysis`.
     #
-    # `GetDocumentAnalysis` returns an array of Block objects. For more
-    # information, see how-it-works-analyzing.
+    # `GetDocumentAnalysis` returns an array of Block objects. The following
+    # types of information are returned:
+    #
+    # * Words and lines that are related to nearby lines and words. The
+    #   related information is returned in two Block objects each of type
+    #   `KEY_VALUE_SET`\: a KEY Block object and a VALUE Block object. For
+    #   example, *Name: Ana Silva Carolina* contains a key and value.
+    #   *Name:* is the key. *Ana Silva Carolina* is the value.
+    #
+    # * Table and table cell data. A TABLE Block object contains information
+    #   about a detected table. A CELL Block object is returned for each
+    #   cell in a table.
+    #
+    # * Selectable elements such as checkboxes and radio buttons. A
+    #   SELECTION\_ELEMENT Block object contains information about a
+    #   selectable element.
+    #
+    # * Lines and words of text. A LINE Block object contains one or more
+    #   WORD Block objects.
     #
     # Use the `MaxResults` parameter to limit the number of blocks returned.
     # If there are more results than specified in `MaxResults`, the value of
@@ -397,6 +488,12 @@ module Aws::Textract
     # with the token value that's returned from the previous call to
     # `GetDocumentAnalysis`.
     #
+    # For more information, see [Document Text Analysis][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html
+    #
     # @option params [required, String] :job_id
     #   A unique identifier for the text-detection job. The `JobId` is
     #   returned from `StartDocumentAnalysis`.
@@ -436,7 +533,7 @@ module Aws::Textract
     #   resp.job_status #=> String, one of "IN_PROGRESS", "SUCCEEDED", "FAILED", "PARTIAL_SUCCESS"
     #   resp.next_token #=> String
     #   resp.blocks #=> Array
-    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL"
+    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL", "SELECTION_ELEMENT"
     #   resp.blocks[0].confidence #=> Float
     #   resp.blocks[0].text #=> String
     #   resp.blocks[0].row_index #=> Integer
@@ -457,6 +554,7 @@ module Aws::Textract
     #   resp.blocks[0].relationships[0].ids[0] #=> String
     #   resp.blocks[0].entity_types #=> Array
     #   resp.blocks[0].entity_types[0] #=> String, one of "KEY", "VALUE"
+    #   resp.blocks[0].selection_status #=> String, one of "SELECTED", "NOT_SELECTED"
     #   resp.blocks[0].page #=> Integer
     #   resp.warnings #=> Array
     #   resp.warnings[0].error_code #=> String
@@ -474,8 +572,8 @@ module Aws::Textract
     end
 
     # Gets the results for an Amazon Textract asynchronous operation that
-    # detects text in a document image. Amazon Textract can detect lines of
-    # text and the words that make up a line of text.
+    # detects text in a document. Amazon Textract can detect lines of text
+    # and the words that make up a line of text.
     #
     # You start asynchronous text detection by calling
     # StartDocumentTextDetection, which returns a job identifier (`JobId`).
@@ -488,8 +586,13 @@ module Aws::Textract
     # pass the job identifier (`JobId`) from the initial call to
     # `StartDocumentTextDetection`.
     #
-    # `GetDocumentTextDetection` returns an array of Block objects. For more
-    # information, see how-it-works-detecting.
+    # `GetDocumentTextDetection` returns an array of Block objects.
+    #
+    # Each document page has as an associated `Block` of type PAGE. Each
+    # PAGE `Block` object is the parent of LINE `Block` objects that
+    # represent the lines of detected text on a page. A LINE `Block` object
+    # is a parent for each word that makes up the line. Words are
+    # represented by `Block` objects of type WORD.
     #
     # Use the MaxResults parameter to limit the number of blocks that are
     # returned. If there are more results than specified in `MaxResults`,
@@ -499,8 +602,11 @@ module Aws::Textract
     # `NextToken` request parameter with the token value that's returned
     # from the previous call to `GetDocumentTextDetection`.
     #
-    # For more information, see Document Text Detection in the Amazon
-    # Textract Developer Guide.
+    # For more information, see [Document Text Detection][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html
     #
     # @option params [required, String] :job_id
     #   A unique identifier for the text detection job. The `JobId` is
@@ -541,7 +647,7 @@ module Aws::Textract
     #   resp.job_status #=> String, one of "IN_PROGRESS", "SUCCEEDED", "FAILED", "PARTIAL_SUCCESS"
     #   resp.next_token #=> String
     #   resp.blocks #=> Array
-    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL"
+    #   resp.blocks[0].block_type #=> String, one of "KEY_VALUE_SET", "PAGE", "LINE", "WORD", "TABLE", "CELL", "SELECTION_ELEMENT"
     #   resp.blocks[0].confidence #=> Float
     #   resp.blocks[0].text #=> String
     #   resp.blocks[0].row_index #=> Integer
@@ -562,6 +668,7 @@ module Aws::Textract
     #   resp.blocks[0].relationships[0].ids[0] #=> String
     #   resp.blocks[0].entity_types #=> Array
     #   resp.blocks[0].entity_types[0] #=> String, one of "KEY", "VALUE"
+    #   resp.blocks[0].selection_status #=> String, one of "SELECTED", "NOT_SELECTED"
     #   resp.blocks[0].page #=> Integer
     #   resp.warnings #=> Array
     #   resp.warnings[0].error_code #=> String
@@ -578,22 +685,14 @@ module Aws::Textract
       req.send_request(options)
     end
 
-    # Starts asynchronous analysis of text for relationships in the text and
-    # tables that are detected in a document. Amazon Textract returns for
-    # two types of information:
-    #
-    # * Words and lines that are related to nearby lines and words. The
-    #   related information is returned in two Block objects: A KEY Block
-    #   object and a VALUE Block object. For example, *Name: Ana Silva
-    #   Carolina* contains a key and value. *Name:* is the key. *Ana Silva
-    #   Carolina* is the value.
+    # Starts asynchronous analysis of an input document for relationships
+    # between detected items such as key and value pairs, tables, and
+    # selection elements.
     #
-    # * Table and table cell data. A TABLE block contains information about
-    #   a detected table. A CELL block is returned for each cell in a table.
-    #
-    # Amazon Textract can analyze text in document images and PDF files that
-    # are stored in an Amazon S3 bucket. Use DocumentLocation to specify the
-    # bucket name and file name of the document image.
+    # `StartDocumentAnalysis` can analyze text in documents that are in JPG,
+    # PNG, and PDF format. The documents are stored in an Amazon S3 bucket.
+    # Use DocumentLocation to specify the bucket name and file name of the
+    # document.
     #
     # `StartDocumentAnalysis` returns a job identifier (`JobId`) that you
     # use to get the results of the operation. When text analysis is
@@ -605,6 +704,12 @@ module Aws::Textract
     # the job identifier (`JobId`) from the initial call to
     # `StartDocumentAnalysis`.
     #
+    # For more information, see [Document Text Analysis][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html
+    #
     # @option params [required, Types::DocumentLocation] :document_location
     #   The location of the document to be processed.
     #
@@ -613,7 +718,8 @@ module Aws::Textract
     #   return information about the tables that are detected in the input
     #   document. Add FORMS to return detected fields and the associated text.
     #   To perform both types of analysis, add TABLES and FORMS to
-    #   `FeatureTypes`.
+    #   `FeatureTypes`. All selectable elements (`SELECTION_ELEMENT`) that are
+    #   detected are returned, whatever the value of `FeatureTypes`.
     #
     # @option params [String] :client_request_token
     #   The idempotent token that you use to identify the start request. If
@@ -622,8 +728,10 @@ module Aws::Textract
     #   same job from being accidentally started more than once.
     #
     # @option params [String] :job_tag
-    #   The unique identifier you specify to identify the job in the
-    #   completion status that's published to the Amazon SNS topic.
+    #   An identifier you specify that's included in the completion
+    #   notification that's published to the Amazon SNS topic. For example,
+    #   you can use `JobTag` to identify the type of document, such as a tax
+    #   form or a receipt, that the completion notification corresponds to.
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Textract to publish the
@@ -669,9 +777,10 @@ module Aws::Textract
     # Textract can detect lines of text and the words that make up a line of
     # text.
     #
-    # Amazon Textract can detect text in document images and PDF files that
-    # are stored in an Amazon S3 bucket. Use DocumentLocation to specify the
-    # bucket name and the file name of the document image.
+    # `StartDocumentTextDetection` can analyze text in documents that are in
+    # JPG, PNG, and PDF format. The documents are stored in an Amazon S3
+    # bucket. Use DocumentLocation to specify the bucket name and file name
+    # of the document.
     #
     # `StartTextDetection` returns a job identifier (`JobId`) that you use
     # to get the results of the operation. When text detection is finished,
@@ -683,8 +792,11 @@ module Aws::Textract
     # pass the job identifier (`JobId`) from the initial call to
     # `StartDocumentTextDetection`.
     #
-    # For more information, see Document Text Detection in the Amazon
-    # Textract Developer Guide.
+    # For more information, see [Document Text Detection][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html
     #
     # @option params [required, Types::DocumentLocation] :document_location
     #   The location of the document to be processed.
@@ -696,9 +808,10 @@ module Aws::Textract
     #   prevent the same job from being accidentally started more than once.
     #
     # @option params [String] :job_tag
-    #   A unique identifier you specify to identify the job in the completion
-    #   status that's published to the Amazon Simple Notification Service
-    #   (Amazon SNS) topic.
+    #   An identifier you specify that's included in the completion
+    #   notification that's published to the Amazon SNS topic. For example,
+    #   you can use `JobTag` to identify the type of document, such as a tax
+    #   form or a receipt, that the completion notification corresponds to.
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Textract to publish the
@@ -752,7 +865,7 @@ module Aws::Textract
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-textract'
-      context[:gem_version] = '1.3.0'
+      context[:gem_version] = '1.4.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -66,6 +66,7 @@ module Aws::Textract
     S3ObjectName = Shapes::StringShape.new(name: 'S3ObjectName')
     S3ObjectVersion = Shapes::StringShape.new(name: 'S3ObjectVersion')
     SNSTopicArn = Shapes::StringShape.new(name: 'SNSTopicArn')
+    SelectionStatus = Shapes::StringShape.new(name: 'SelectionStatus')
     StartDocumentAnalysisRequest = Shapes::StructureShape.new(name: 'StartDocumentAnalysisRequest')
     StartDocumentAnalysisResponse = Shapes::StructureShape.new(name: 'StartDocumentAnalysisResponse')
     StartDocumentTextDetectionRequest = Shapes::StructureShape.new(name: 'StartDocumentTextDetectionRequest')
@@ -97,6 +98,7 @@ module Aws::Textract
     Block.add_member(:id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "Id"))
     Block.add_member(:relationships, Shapes::ShapeRef.new(shape: RelationshipList, location_name: "Relationships"))
     Block.add_member(:entity_types, Shapes::ShapeRef.new(shape: EntityTypes, location_name: "EntityTypes"))
+    Block.add_member(:selection_status, Shapes::ShapeRef.new(shape: SelectionStatus, location_name: "SelectionStatus"))
     Block.add_member(:page, Shapes::ShapeRef.new(shape: UInteger, location_name: "Page"))
     Block.struct_class = Types::Block
 

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

@@ -28,6 +28,9 @@ module Aws::Textract
     #   If you use the AWS CLI to call Amazon Textract operations, you
     #   can't pass image bytes. The document must be an image in JPG or PNG
     #   format.
+    #
+    #   If you are using an AWS SDK to call Amazon Textract, you might not
+    #   need to base64-encode image bytes passed using the `Bytes` field.
     #   @return [Types::Document]
     #
     # @!attribute [rw] feature_types
@@ -63,13 +66,13 @@ module Aws::Textract
       include Aws::Structure
     end
 
-    # A `Block` represents text that's recognized in a document within a
+    # A `Block` represents items that are recognized in a document within a
     # group of pixels close to each other. The information returned in a
     # `Block` depends on the type of operation. In document-text detection
     # (for example DetectDocumentText), you get information about the
     # detected words and lines of text. In text analysis (for example
-    # AnalyzeDocument), you can get information about the fields and tables
-    # that are detected in the document.
+    # AnalyzeDocument), you can also get information about the fields,
+    # tables and selection elements that are detected in the document.
     #
     # An array of `Block` objects is returned by both synchronous and
     # asynchronous operations. In synchronous operations, such as
@@ -77,37 +80,54 @@ module Aws::Textract
     # results. In asynchronous operations, such as GetDocumentAnalysis, the
     # array is returned over one or more responses.
     #
+    # For more information, see [How Amazon Textract Works][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/how-it-works.html
+    #
     # @!attribute [rw] block_type
     #   The type of text that's recognized in a block. In text-detection
     #   operations, the following types are returned:
     #
     #   * *PAGE* - Contains a list of the LINE Block objects that are
-    #     detected on a specific page.
+    #     detected on a document page.
     #
-    #   * *WORD* - One or more ISO basic Latin script characters that
-    #     aren't separated by spaces.
+    #   * *WORD* - A word detected on a document page. A word is one or more
+    #     ISO basic Latin script characters that aren't separated by
+    #     spaces.
     #
-    #   * *LINE* - A string of equally spaced words.
+    #   * *LINE* - A string of tab-delimited, contiguous words that's
+    #     detected on a document page.
     #
     #   In text analysis operations, the following types are returned:
     #
     #   * *PAGE* - Contains a list of child Block objects that are detected
-    #     on a specific page.
+    #     on a document page.
     #
     #   * *KEY\_VALUE\_SET* - Stores the KEY and VALUE Block objects for a
-    #     field that's detected in a document. Use the `EntityType` field
-    #     to determine if a KEY\_VALUE\_SET object is a KEY Block object or
-    #     a VALUE Block object.
+    #     field that's detected on a document page. Use the `EntityType`
+    #     field to determine if a KEY\_VALUE\_SET object is a KEY Block
+    #     object or a VALUE Block object.
     #
-    #   * *WORD* - One or more ISO basic Latin script characters that
-    #     aren't separated by spaces.
+    #   * *WORD* - A word detected on a document page. A word is one or more
+    #     ISO basic Latin script characters that aren't separated by spaces
+    #     that's detected on a document page.
     #
-    #   * *LINE* - A string of tab-delimited, contiguous words.
+    #   * *LINE* - A string of tab-delimited, contiguous words that's
+    #     detected on a document page.
     #
-    #   * *TABLE* - A table that's detected in the document.
+    #   * *TABLE* - A table that's detected on a document page. A table is
+    #     any grid-based information with 2 or more rows or columns with a
+    #     cell span of 1 row and 1 column each.
     #
     #   * *CELL* - A cell within a detected table. The cell is the parent of
     #     the block that contains the text in the cell.
+    #
+    #   * *SELECTION\_ELEMENT* - A selectable element such as a radio button
+    #     or checkbox that's detected on a document page. Use the value of
+    #     `SelectionStatus` to determine the status of the selection
+    #     element.
     #   @return [String]
     #
     # @!attribute [rw] confidence
@@ -176,8 +196,19 @@ module Aws::Textract
     #   `GetDocumentTextDetection`.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] selection_status
+    #   The selection status of a selectable element such as a radio button
+    #   or checkbox.
+    #   @return [String]
+    #
     # @!attribute [rw] page
-    #   The page in which a block was detected.
+    #   The page in which a block was detected. `Page` is returned by
+    #   asynchronous operations. Page values greater than 1 are only
+    #   returned for multi-page documents that are in PDF format. A scanned
+    #   image (JPG/PNG), even if it contains multiple document pages, is
+    #   always considered to be a single-page document and the value of
+    #   `Page` is always 1. Synchronous operations don't return `Page` as
+    #   every input document is considered to be a single-page document.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/Block AWS API Documentation
@@ -194,6 +225,7 @@ module Aws::Textract
       :id,
       :relationships,
       :entity_types,
+      :selection_status,
       :page)
       include Aws::Structure
     end
@@ -264,6 +296,9 @@ module Aws::Textract
     #   If you use the AWS CLI to call Amazon Textract operations, you
     #   can't pass image bytes. The document must be an image in JPG or PNG
     #   format.
+    #
+    #   If you are using an AWS SDK to call Amazon Textract, you might not
+    #   need to base64-encode image bytes passed using the `Bytes` field.
     #   @return [Types::Document]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/DetectDocumentTextRequest AWS API Documentation
@@ -305,7 +340,7 @@ module Aws::Textract
     # bucket don't need to be base64 encoded.
     #
     # The AWS Region for the S3 bucket that contains the S3 object must
-    # match the Region that you use for Amazon Textract operations.
+    # match the AWS Region that you use for Amazon Textract operations.
     #
     # If you use the AWS CLI to call Amazon Textract operations, passing
     # image bytes using the Bytes property isn't supported. You must first
@@ -328,8 +363,12 @@ module Aws::Textract
     #       }
     #
     # @!attribute [rw] bytes
-    #   A blob of documents bytes. The maximum size of a document that's
-    #   provided in a blob of bytes is 5 MB.
+    #   A blob of base-64 encoded documents bytes. The maximum size of a
+    #   document that's provided in a blob of bytes is 5 MB. The document
+    #   bytes must be in PNG or JPG format.
+    #
+    #   If you are using an AWS SDK to call Amazon Textract, you might not
+    #   need to base64-encode image bytes passed using the `Bytes` field.
     #   @return [String]
     #
     # @!attribute [rw] s3_object
@@ -715,7 +754,9 @@ module Aws::Textract
     #   to return information about the tables that are detected in the
     #   input document. Add FORMS to return detected fields and the
     #   associated text. To perform both types of analysis, add TABLES and
-    #   FORMS to `FeatureTypes`.
+    #   FORMS to `FeatureTypes`. All selectable elements
+    #   (`SELECTION_ELEMENT`) that are detected are returned, whatever the
+    #   value of `FeatureTypes`.
     #   @return [Array<String>]
     #
     # @!attribute [rw] client_request_token
@@ -726,8 +767,10 @@ module Aws::Textract
     #   @return [String]
     #
     # @!attribute [rw] job_tag
-    #   The unique identifier you specify to identify the job in the
-    #   completion status that's published to the Amazon SNS topic.
+    #   An identifier you specify that's included in the completion
+    #   notification that's published to the Amazon SNS topic. For example,
+    #   you can use `JobTag` to identify the type of document, such as a tax
+    #   form or a receipt, that the completion notification corresponds to.
     #   @return [String]
     #
     # @!attribute [rw] notification_channel
@@ -747,7 +790,7 @@ module Aws::Textract
     end
 
     # @!attribute [rw] job_id
-    #   The identifier for the document text-detection job. Use `JobId` to
+    #   The identifier for the document text detection job. Use `JobId` to
     #   identify the job in a subsequent call to `GetDocumentAnalysis`.
     #   @return [String]
     #
@@ -789,9 +832,10 @@ module Aws::Textract
     #   @return [String]
     #
     # @!attribute [rw] job_tag
-    #   A unique identifier you specify to identify the job in the
-    #   completion status that's published to the Amazon Simple
-    #   Notification Service (Amazon SNS) topic.
+    #   An identifier you specify that's included in the completion
+    #   notification that's published to the Amazon SNS topic. For example,
+    #   you can use `JobTag` to identify the type of document, such as a tax
+    #   form or a receipt, that the completion notification corresponds to.
     #   @return [String]
     #
     # @!attribute [rw] notification_channel

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-textract
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-21 00:00:00.000000000 Z
+date: 2019-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -59,7 +59,7 @@ files:
 - lib/aws-sdk-textract/errors.rb
 - lib/aws-sdk-textract/resource.rb
 - lib/aws-sdk-textract/types.rb
-homepage: http://github.com/aws/aws-sdk-ruby
+homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0
 metadata: