aws-sdk-textract 1.24.0 → 1.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 894a866db6b005111e1da8f5710c4a8266b93f61be9034dcb9b574b16b8d9b35
-  data.tar.gz: b8fb8856f22fc326aa503a7923fd6fe2be11d1bc574347489467194b131b4d0c
+  metadata.gz: 4407b51ac41473054e7a4ecf865a72886d9564aef97c1525f8ac29b3c878afd3
+  data.tar.gz: 0ab236473f861694b100af2c06a4e40bcb29557d33ce0f7c307b3bc7cdc23a0d
 SHA512:
-  metadata.gz: 4e0e9c989b841c7b6fe477c19c6b3d79eea0e72e0c07340e3321113c77536f6b5274d2c5beefa97335ad5ba252afb442717eddacb62e702413e64e9813ef3f6f
-  data.tar.gz: dc9cb076bd4925dddfbb1a99c49424522b2bf04284ba6f1cdc23e53af6a0b3e7dd1c6969968748f0bc3c3f9cc9c502462908630e7444142288b8516f5a0b2d24
+  metadata.gz: 1100d59f3f1f051e175289087cd599562850d2524bb51ed46e96a1b46e31d5d5a2bb78d15e1f54a754998f2c5db52dede16297296d1c82420abbe43c92180db1
+  data.tar.gz: f2a03d26c08509cf5ef86858ef1922620be657be09cc46d8e863fc6c8a23ff61f6cf71c0d031d198b2529796b8cf2f97dc7e9bbc3a2249aead5a5ec2ba13a7ed

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.25.0 (2021-07-26)
+------------------
+
+* Feature - Adds support for AnalyzeExpense, a new API to extract relevant data such as contact information, items purchased, and vendor name, from almost any invoice or receipt without the need for any templates or configuration.
+
 1.24.0 (2021-03-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.24.0
+1.25.0

data/lib/aws-sdk-textract.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-textract/customizations'
 # @!group service
 module Aws::Textract
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.25.0'
 
 end

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

@@ -467,6 +467,124 @@ module Aws::Textract
       req.send_request(options)
     end
 
+    # Analyzes an input document for financially related relationships
+    # between text.
+    #
+    # Information is returned as `ExpenseDocuments` and seperated as
+    # follows.
+    #
+    # * `LineItemGroups`- A data set containing `LineItems` which store
+    #   information about the lines of text, such as an item purchased and
+    #   its price on a receipt.
+    #
+    # * `SummaryFields`- Contains all other information a receipt, such as
+    #   header information or the vendors name.
+    #
+    # @option params [required, Types::Document] :document
+    #   The input document, either as bytes or as an S3 object.
+    #
+    #   You pass image bytes to an Amazon Textract API operation by using the
+    #   `Bytes` property. For example, you would use the `Bytes` property to
+    #   pass a document loaded from a local file system. Image bytes passed by
+    #   using the `Bytes` property must be base64 encoded. Your code might not
+    #   need to encode document file bytes if you're using an AWS SDK to call
+    #   Amazon Textract API operations.
+    #
+    #   You pass images stored in an S3 bucket to an Amazon Textract API
+    #   operation by using the `S3Object` property. Documents stored in an S3
+    #   bucket don't need to be base64 encoded.
+    #
+    #   The AWS Region for the S3 bucket that contains the S3 object must
+    #   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
+    #   upload the document to an Amazon S3 bucket, and then call the
+    #   operation using the S3Object property.
+    #
+    #   For Amazon Textract to process an S3 object, the user must have
+    #   permission to access the S3 object.
+    #
+    # @return [Types::AnalyzeExpenseResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::AnalyzeExpenseResponse#document_metadata #document_metadata} => Types::DocumentMetadata
+    #   * {Types::AnalyzeExpenseResponse#expense_documents #expense_documents} => Array<Types::ExpenseDocument>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.analyze_expense({
+    #     document: { # required
+    #       bytes: "data",
+    #       s3_object: {
+    #         bucket: "S3Bucket",
+    #         name: "S3ObjectName",
+    #         version: "S3ObjectVersion",
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.document_metadata.pages #=> Integer
+    #   resp.expense_documents #=> Array
+    #   resp.expense_documents[0].expense_index #=> Integer
+    #   resp.expense_documents[0].summary_fields #=> Array
+    #   resp.expense_documents[0].summary_fields[0].type.text #=> String
+    #   resp.expense_documents[0].summary_fields[0].type.confidence #=> Float
+    #   resp.expense_documents[0].summary_fields[0].label_detection.text #=> String
+    #   resp.expense_documents[0].summary_fields[0].label_detection.geometry.bounding_box.width #=> Float
+    #   resp.expense_documents[0].summary_fields[0].label_detection.geometry.bounding_box.height #=> Float
+    #   resp.expense_documents[0].summary_fields[0].label_detection.geometry.bounding_box.left #=> Float
+    #   resp.expense_documents[0].summary_fields[0].label_detection.geometry.bounding_box.top #=> Float
+    #   resp.expense_documents[0].summary_fields[0].label_detection.geometry.polygon #=> Array
+    #   resp.expense_documents[0].summary_fields[0].label_detection.geometry.polygon[0].x #=> Float
+    #   resp.expense_documents[0].summary_fields[0].label_detection.geometry.polygon[0].y #=> Float
+    #   resp.expense_documents[0].summary_fields[0].label_detection.confidence #=> Float
+    #   resp.expense_documents[0].summary_fields[0].value_detection.text #=> String
+    #   resp.expense_documents[0].summary_fields[0].value_detection.geometry.bounding_box.width #=> Float
+    #   resp.expense_documents[0].summary_fields[0].value_detection.geometry.bounding_box.height #=> Float
+    #   resp.expense_documents[0].summary_fields[0].value_detection.geometry.bounding_box.left #=> Float
+    #   resp.expense_documents[0].summary_fields[0].value_detection.geometry.bounding_box.top #=> Float
+    #   resp.expense_documents[0].summary_fields[0].value_detection.geometry.polygon #=> Array
+    #   resp.expense_documents[0].summary_fields[0].value_detection.geometry.polygon[0].x #=> Float
+    #   resp.expense_documents[0].summary_fields[0].value_detection.geometry.polygon[0].y #=> Float
+    #   resp.expense_documents[0].summary_fields[0].value_detection.confidence #=> Float
+    #   resp.expense_documents[0].summary_fields[0].page_number #=> Integer
+    #   resp.expense_documents[0].line_item_groups #=> Array
+    #   resp.expense_documents[0].line_item_groups[0].line_item_group_index #=> Integer
+    #   resp.expense_documents[0].line_item_groups[0].line_items #=> Array
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields #=> Array
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].type.text #=> String
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].type.confidence #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.text #=> String
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.geometry.bounding_box.width #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.geometry.bounding_box.height #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.geometry.bounding_box.left #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.geometry.bounding_box.top #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.geometry.polygon #=> Array
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.geometry.polygon[0].x #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.geometry.polygon[0].y #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].label_detection.confidence #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.text #=> String
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.geometry.bounding_box.width #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.geometry.bounding_box.height #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.geometry.bounding_box.left #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.geometry.bounding_box.top #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.geometry.polygon #=> Array
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.geometry.polygon[0].x #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.geometry.polygon[0].y #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].value_detection.confidence #=> Float
+    #   resp.expense_documents[0].line_item_groups[0].line_items[0].line_item_expense_fields[0].page_number #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/AnalyzeExpense AWS API Documentation
+    #
+    # @overload analyze_expense(params = {})
+    # @param [Hash] params ({})
+    def analyze_expense(params = {}, options = {})
+      req = build_request(:analyze_expense, params)
+      req.send_request(options)
+    end
+
     # 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 JPEG or PNG format. `DetectDocumentText` returns
@@ -1029,7 +1147,7 @@ module Aws::Textract
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-textract'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.25.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -16,6 +16,8 @@ module Aws::Textract
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     AnalyzeDocumentRequest = Shapes::StructureShape.new(name: 'AnalyzeDocumentRequest')
     AnalyzeDocumentResponse = Shapes::StructureShape.new(name: 'AnalyzeDocumentResponse')
+    AnalyzeExpenseRequest = Shapes::StructureShape.new(name: 'AnalyzeExpenseRequest')
+    AnalyzeExpenseResponse = Shapes::StructureShape.new(name: 'AnalyzeExpenseResponse')
     BadDocumentException = Shapes::StructureShape.new(name: 'BadDocumentException')
     Block = Shapes::StructureShape.new(name: 'Block')
     BlockList = Shapes::ListShape.new(name: 'BlockList')
@@ -33,6 +35,12 @@ module Aws::Textract
     EntityType = Shapes::StringShape.new(name: 'EntityType')
     EntityTypes = Shapes::ListShape.new(name: 'EntityTypes')
     ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
+    ExpenseDetection = Shapes::StructureShape.new(name: 'ExpenseDetection')
+    ExpenseDocument = Shapes::StructureShape.new(name: 'ExpenseDocument')
+    ExpenseDocumentList = Shapes::ListShape.new(name: 'ExpenseDocumentList')
+    ExpenseField = Shapes::StructureShape.new(name: 'ExpenseField')
+    ExpenseFieldList = Shapes::ListShape.new(name: 'ExpenseFieldList')
+    ExpenseType = Shapes::StructureShape.new(name: 'ExpenseType')
     FeatureType = Shapes::StringShape.new(name: 'FeatureType')
     FeatureTypes = Shapes::ListShape.new(name: 'FeatureTypes')
     Float = Shapes::FloatShape.new(name: 'Float')
@@ -64,6 +72,10 @@ module Aws::Textract
     JobTag = Shapes::StringShape.new(name: 'JobTag')
     KMSKeyId = Shapes::StringShape.new(name: 'KMSKeyId')
     LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
+    LineItemFields = Shapes::StructureShape.new(name: 'LineItemFields')
+    LineItemGroup = Shapes::StructureShape.new(name: 'LineItemGroup')
+    LineItemGroupList = Shapes::ListShape.new(name: 'LineItemGroupList')
+    LineItemList = Shapes::ListShape.new(name: 'LineItemList')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
     NonEmptyString = Shapes::StringShape.new(name: 'NonEmptyString')
     NotificationChannel = Shapes::StructureShape.new(name: 'NotificationChannel')
@@ -110,6 +122,13 @@ module Aws::Textract
     AnalyzeDocumentResponse.add_member(:analyze_document_model_version, Shapes::ShapeRef.new(shape: String, location_name: "AnalyzeDocumentModelVersion"))
     AnalyzeDocumentResponse.struct_class = Types::AnalyzeDocumentResponse
 
+    AnalyzeExpenseRequest.add_member(:document, Shapes::ShapeRef.new(shape: Document, required: true, location_name: "Document"))
+    AnalyzeExpenseRequest.struct_class = Types::AnalyzeExpenseRequest
+
+    AnalyzeExpenseResponse.add_member(:document_metadata, Shapes::ShapeRef.new(shape: DocumentMetadata, location_name: "DocumentMetadata"))
+    AnalyzeExpenseResponse.add_member(:expense_documents, Shapes::ShapeRef.new(shape: ExpenseDocumentList, location_name: "ExpenseDocuments"))
+    AnalyzeExpenseResponse.struct_class = Types::AnalyzeExpenseResponse
+
     BadDocumentException.struct_class = Types::BadDocumentException
 
     Block.add_member(:block_type, Shapes::ShapeRef.new(shape: BlockType, location_name: "BlockType"))
@@ -160,6 +179,30 @@ module Aws::Textract
 
     EntityTypes.member = Shapes::ShapeRef.new(shape: EntityType)
 
+    ExpenseDetection.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "Text"))
+    ExpenseDetection.add_member(:geometry, Shapes::ShapeRef.new(shape: Geometry, location_name: "Geometry"))
+    ExpenseDetection.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
+    ExpenseDetection.struct_class = Types::ExpenseDetection
+
+    ExpenseDocument.add_member(:expense_index, Shapes::ShapeRef.new(shape: UInteger, location_name: "ExpenseIndex"))
+    ExpenseDocument.add_member(:summary_fields, Shapes::ShapeRef.new(shape: ExpenseFieldList, location_name: "SummaryFields"))
+    ExpenseDocument.add_member(:line_item_groups, Shapes::ShapeRef.new(shape: LineItemGroupList, location_name: "LineItemGroups"))
+    ExpenseDocument.struct_class = Types::ExpenseDocument
+
+    ExpenseDocumentList.member = Shapes::ShapeRef.new(shape: ExpenseDocument)
+
+    ExpenseField.add_member(:type, Shapes::ShapeRef.new(shape: ExpenseType, location_name: "Type"))
+    ExpenseField.add_member(:label_detection, Shapes::ShapeRef.new(shape: ExpenseDetection, location_name: "LabelDetection"))
+    ExpenseField.add_member(:value_detection, Shapes::ShapeRef.new(shape: ExpenseDetection, location_name: "ValueDetection"))
+    ExpenseField.add_member(:page_number, Shapes::ShapeRef.new(shape: UInteger, location_name: "PageNumber"))
+    ExpenseField.struct_class = Types::ExpenseField
+
+    ExpenseFieldList.member = Shapes::ShapeRef.new(shape: ExpenseField)
+
+    ExpenseType.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "Text"))
+    ExpenseType.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
+    ExpenseType.struct_class = Types::ExpenseType
+
     FeatureTypes.member = Shapes::ShapeRef.new(shape: FeatureType)
 
     Geometry.add_member(:bounding_box, Shapes::ShapeRef.new(shape: BoundingBox, location_name: "BoundingBox"))
@@ -230,6 +273,17 @@ module Aws::Textract
 
     LimitExceededException.struct_class = Types::LimitExceededException
 
+    LineItemFields.add_member(:line_item_expense_fields, Shapes::ShapeRef.new(shape: ExpenseFieldList, location_name: "LineItemExpenseFields"))
+    LineItemFields.struct_class = Types::LineItemFields
+
+    LineItemGroup.add_member(:line_item_group_index, Shapes::ShapeRef.new(shape: UInteger, location_name: "LineItemGroupIndex"))
+    LineItemGroup.add_member(:line_items, Shapes::ShapeRef.new(shape: LineItemList, location_name: "LineItems"))
+    LineItemGroup.struct_class = Types::LineItemGroup
+
+    LineItemGroupList.member = Shapes::ShapeRef.new(shape: LineItemGroup)
+
+    LineItemList.member = Shapes::ShapeRef.new(shape: LineItemFields)
+
     NotificationChannel.add_member(:sns_topic_arn, Shapes::ShapeRef.new(shape: SNSTopicArn, required: true, location_name: "SNSTopicArn"))
     NotificationChannel.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "RoleArn"))
     NotificationChannel.struct_class = Types::NotificationChannel
@@ -328,6 +382,23 @@ module Aws::Textract
         o.errors << Shapes::ShapeRef.new(shape: HumanLoopQuotaExceededException)
       end)
 
+      api.add_operation(:analyze_expense, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "AnalyzeExpense"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: AnalyzeExpenseRequest)
+        o.output = Shapes::ShapeRef.new(shape: AnalyzeExpenseResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidS3ObjectException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedDocumentException)
+        o.errors << Shapes::ShapeRef.new(shape: DocumentTooLargeException)
+        o.errors << Shapes::ShapeRef.new(shape: BadDocumentException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+      end)
+
       api.add_operation(:detect_document_text, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DetectDocumentText"
         o.http_method = "POST"
@@ -358,6 +429,7 @@ module Aws::Textract
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidS3ObjectException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidKMSKeyException)
       end)
 
       api.add_operation(:get_document_text_detection, Seahorse::Model::Operation.new.tap do |o|
@@ -373,6 +445,7 @@ module Aws::Textract
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidS3ObjectException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidKMSKeyException)
       end)
 
       api.add_operation(:start_document_analysis, Seahorse::Model::Operation.new.tap do |o|

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

@@ -103,6 +103,71 @@ module Aws::Textract
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass AnalyzeExpenseRequest
+    #   data as a hash:
+    #
+    #       {
+    #         document: { # required
+    #           bytes: "data",
+    #           s3_object: {
+    #             bucket: "S3Bucket",
+    #             name: "S3ObjectName",
+    #             version: "S3ObjectVersion",
+    #           },
+    #         },
+    #       }
+    #
+    # @!attribute [rw] document
+    #   The input document, either as bytes or as an S3 object.
+    #
+    #   You pass image bytes to an Amazon Textract API operation by using
+    #   the `Bytes` property. For example, you would use the `Bytes`
+    #   property to pass a document loaded from a local file system. Image
+    #   bytes passed by using the `Bytes` property must be base64 encoded.
+    #   Your code might not need to encode document file bytes if you're
+    #   using an AWS SDK to call Amazon Textract API operations.
+    #
+    #   You pass images stored in an S3 bucket to an Amazon Textract API
+    #   operation by using the `S3Object` property. Documents stored in an
+    #   S3 bucket don't need to be base64 encoded.
+    #
+    #   The AWS Region for the S3 bucket that contains the S3 object must
+    #   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 upload the document to an Amazon S3 bucket, and then call the
+    #   operation using the S3Object property.
+    #
+    #   For Amazon Textract to process an S3 object, the user must have
+    #   permission to access the S3 object.
+    #   @return [Types::Document]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/AnalyzeExpenseRequest AWS API Documentation
+    #
+    class AnalyzeExpenseRequest < Struct.new(
+      :document)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] document_metadata
+    #   Information about the input document.
+    #   @return [Types::DocumentMetadata]
+    #
+    # @!attribute [rw] expense_documents
+    #   The expenses detected by Amazon Textract.
+    #   @return [Array<Types::ExpenseDocument>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/AnalyzeExpenseResponse AWS API Documentation
+    #
+    class AnalyzeExpenseResponse < Struct.new(
+      :document_metadata,
+      :expense_documents)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Amazon Textract isn't able to read the document. For more information
     # on the document limits in Amazon Textract, see limits.
     #
@@ -499,6 +564,111 @@ module Aws::Textract
     #
     class DocumentTooLargeException < Aws::EmptyStructure; end
 
+    # An object used to store information about the Value or Label detected
+    # by Amazon Textract.
+    #
+    # @!attribute [rw] text
+    #   The word or line of text recognized by Amazon Textract
+    #   @return [String]
+    #
+    # @!attribute [rw] geometry
+    #   Information about where the following items are located on a
+    #   document page: detected page, text, key-value pairs, tables, table
+    #   cells, and selection elements.
+    #   @return [Types::Geometry]
+    #
+    # @!attribute [rw] confidence
+    #   The confidence in detection, as a percentage
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/ExpenseDetection AWS API Documentation
+    #
+    class ExpenseDetection < Struct.new(
+      :text,
+      :geometry,
+      :confidence)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The structure holding all the information returned by AnalyzeExpense
+    #
+    # @!attribute [rw] expense_index
+    #   Denotes which invoice or receipt in the document the information is
+    #   coming from. First document will be 1, the second 2, and so on.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] summary_fields
+    #   Any information found outside of a table by Amazon Textract.
+    #   @return [Array<Types::ExpenseField>]
+    #
+    # @!attribute [rw] line_item_groups
+    #   Information detected on each table of a document, seperated into
+    #   `LineItems`.
+    #   @return [Array<Types::LineItemGroup>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/ExpenseDocument AWS API Documentation
+    #
+    class ExpenseDocument < Struct.new(
+      :expense_index,
+      :summary_fields,
+      :line_item_groups)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Breakdown of detected information, seperated into the catagories Type,
+    # LableDetection, and ValueDetection
+    #
+    # @!attribute [rw] type
+    #   The implied label of a detected element. Present alongside
+    #   LabelDetection for explicit elements.
+    #   @return [Types::ExpenseType]
+    #
+    # @!attribute [rw] label_detection
+    #   The explicitly stated label of a detected element.
+    #   @return [Types::ExpenseDetection]
+    #
+    # @!attribute [rw] value_detection
+    #   The value of a detected element. Present in explicit and implicit
+    #   elements.
+    #   @return [Types::ExpenseDetection]
+    #
+    # @!attribute [rw] page_number
+    #   The page number the value was detected on.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/ExpenseField AWS API Documentation
+    #
+    class ExpenseField < Struct.new(
+      :type,
+      :label_detection,
+      :value_detection,
+      :page_number)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # An object used to store information about the Type detected by Amazon
+    # Textract.
+    #
+    # @!attribute [rw] text
+    #   The word or line of text detected by Amazon Textract.
+    #   @return [String]
+    #
+    # @!attribute [rw] confidence
+    #   The confidence of accuracy, as a percentage.
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/ExpenseType AWS API Documentation
+    #
+    class ExpenseType < Struct.new(
+      :text,
+      :confidence)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Information about where the following items are located on a document
     # page: detected page, text, key-value pairs, tables, table cells, and
     # selection elements.
@@ -869,6 +1039,44 @@ module Aws::Textract
     #
     class LimitExceededException < Aws::EmptyStructure; end
 
+    # A structure that holds information about the different lines found in
+    # a document's tables.
+    #
+    # @!attribute [rw] line_item_expense_fields
+    #   ExpenseFields used to show information from detected lines on a
+    #   table.
+    #   @return [Array<Types::ExpenseField>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/LineItemFields AWS API Documentation
+    #
+    class LineItemFields < Struct.new(
+      :line_item_expense_fields)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A grouping of tables which contain LineItems, with each table
+    # identified by the table's `LineItemGroupIndex`.
+    #
+    # @!attribute [rw] line_item_group_index
+    #   The number used to identify a specific table in a document. The
+    #   first table encountered will have a LineItemGroupIndex of 1, the
+    #   second 2, etc.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] line_items
+    #   The breakdown of information on a particular line of a table.
+    #   @return [Array<Types::LineItemFields>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/LineItemGroup AWS API Documentation
+    #
+    class LineItemGroup < Struct.new(
+      :line_item_group_index,
+      :line_items)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The Amazon Simple Notification Service (Amazon SNS) topic to which
     # Amazon Textract publishes the completion status of an asynchronous
     # document operation, such as StartDocumentTextDetection.
@@ -903,6 +1111,31 @@ module Aws::Textract
     # Sets whether or not your output will go to a user created bucket. Used
     # to set the name of the bucket, and the prefix on the output file.
     #
+    # `OutputConfig` is an optional parameter which lets you adjust where
+    # your output will be placed. By default, Amazon Textract will store the
+    # results internally and can only be accessed by the Get API operations.
+    # With OutputConfig enabled, you can set the name of the bucket the
+    # output will be sent to and the file prefix of the results where you
+    # can download your results. Additionally, you can set the `KMSKeyID`
+    # parameter to a customer master key (CMK) to encrypt your output.
+    # Without this parameter set Amazon Textract will encrypt server-side
+    # using the AWS managed CMK for Amazon S3.
+    #
+    # Decryption of Customer Content is necessary for processing of the
+    # documents by Amazon Textract. If your account is opted out under an AI
+    # services opt out policy then all unencrypted Customer Content is
+    # immediately and permanently deleted after the Customer Content has
+    # been processed by the service. No copy of of the output is retained by
+    # Amazon Textract. For information about how to opt out, see [ Managing
+    # AI services opt-out policy. ][1]
+    #
+    # For more information on data privacy, see the [Data Privacy FAQ][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html
+    # [2]: https://aws.amazon.com/compliance/data-privacy-faq/
+    #
     # @note When making an API call, you may pass OutputConfig
     #   data as a hash:
     #
@@ -1013,7 +1246,8 @@ module Aws::Textract
     #       }
     #
     # @!attribute [rw] bucket
-    #   The name of the S3 bucket.
+    #   The name of the S3 bucket. Note that the # character is not valid in
+    #   the file name.
     #   @return [String]
     #
     # @!attribute [rw] name

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-textract
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.25.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-10 00:00:00.000000000 Z
+date: 2021-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -66,8 +66,8 @@ homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0
 metadata:
-  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-textract
-  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-textract/CHANGELOG.md
+  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-textract
+  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-textract/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -83,8 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - Amazon Textract