aws-sdk-textract 1.29.0 → 1.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21745a57da0d542599a55a2e970fe622d03aab5ca36a68beefeba1d646742e77
-  data.tar.gz: cc8f2bd26c1e1d5abd46f3a713127ca33422feb9a553c4ce82412d702d5c60a1
+  metadata.gz: 3d0b690ceb075951b6884a12dbc959fc4a2afc3e3b0c8b15fc7963e05ade796b
+  data.tar.gz: 40c09ec33575d5a86cd59b5e09b1b52030dc9e5eafc92dcd90e29b40056f05fb
 SHA512:
-  metadata.gz: b160a4d857d91a1b33251482cf1a40e7b1a09cf353144e39f28c848d2a6e58ea03cf8cafd2d5bea67f274ee27fc0c3135bbef81ffd1a759213704bc071ad3858
-  data.tar.gz: 6fe0cef5fd5d1bc68eab3bfdf4bcb00122f55362e7852488c641bb374cbb7eef7e397881df6d66fdf6c3cb9679b37e284146f1d860ae8be58bf858d10b9af33d
+  metadata.gz: 92c046737672802cee1e2dcccc6e80d6180cea52c238eebe05d739fda4b5e2328e630ab8c4f0591d1e2aa6ad6c659f1fca7a7242f12e17bb852bbd774fe600e2
+  data.tar.gz: 7a869aae95ad4de28aab94f48ada58412d8d1ea0e60c05b346c2ead09f38dec11106adb72a86f1bf2b1d5aedc2cf04a36479442fc4def931e3df3de010e982d9

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.30.0 (2021-10-27)
+------------------
+
+* Feature - This release adds support for asynchronously analyzing invoice and receipt documents through two new APIs: StartExpenseAnalysis and GetExpenseAnalysis
+
 1.29.0 (2021-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.29.0
+1.30.0

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

@@ -922,14 +922,148 @@ module Aws::Textract
       req.send_request(options)
     end
 
+    # Gets the results for an Amazon Textract asynchronous operation that
+    # analyzes invoices and receipts. Amazon Textract finds contact
+    # information, items purchased, and vendor name, from input invoices and
+    # receipts.
+    #
+    # You start asynchronous invoice/receipt analysis by calling
+    # StartExpenseAnalysis, which returns a job identifier (`JobId`). Upon
+    # completion of the invoice/receipt analysis, Amazon Textract publishes
+    # the completion status to the Amazon Simple Notification Service
+    # (Amazon SNS) topic. This topic must be registered in the initial call
+    # to `StartExpenseAnalysis`. To get the results of the invoice/receipt
+    # analysis operation, first ensure that the status value published to
+    # the Amazon SNS topic is `SUCCEEDED`. If so, call `GetExpenseAnalysis`,
+    # and pass the job identifier (`JobId`) from the initial call to
+    # `StartExpenseAnalysis`.
+    #
+    # Use the MaxResults parameter to limit the number of blocks that are
+    # returned. If there are more results than specified in `MaxResults`,
+    # the value of `NextToken` in the operation response contains a
+    # pagination token for getting the next set of results. To get the next
+    # page of results, call `GetExpenseAnalysis`, and populate the
+    # `NextToken` request parameter with the token value that's returned
+    # from the previous call to `GetExpenseAnalysis`.
+    #
+    # For more information, see [Analyzing Invoices and Receipts][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html
+    #
+    # @option params [required, String] :job_id
+    #   A unique identifier for the text detection job. The `JobId` is
+    #   returned from `StartExpenseAnalysis`. A `JobId` value is only valid
+    #   for 7 days.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return per paginated call. The
+    #   largest value you can specify is 20. If you specify a value greater
+    #   than 20, a maximum of 20 results is returned. The default value is 20.
+    #
+    # @option params [String] :next_token
+    #   If the previous response was incomplete (because there are more blocks
+    #   to retrieve), Amazon Textract returns a pagination token in the
+    #   response. You can use this pagination token to retrieve the next set
+    #   of blocks.
+    #
+    # @return [Types::GetExpenseAnalysisResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetExpenseAnalysisResponse#document_metadata #document_metadata} => Types::DocumentMetadata
+    #   * {Types::GetExpenseAnalysisResponse#job_status #job_status} => String
+    #   * {Types::GetExpenseAnalysisResponse#next_token #next_token} => String
+    #   * {Types::GetExpenseAnalysisResponse#expense_documents #expense_documents} => Array<Types::ExpenseDocument>
+    #   * {Types::GetExpenseAnalysisResponse#warnings #warnings} => Array<Types::Warning>
+    #   * {Types::GetExpenseAnalysisResponse#status_message #status_message} => String
+    #   * {Types::GetExpenseAnalysisResponse#analyze_expense_model_version #analyze_expense_model_version} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_expense_analysis({
+    #     job_id: "JobId", # required
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.document_metadata.pages #=> Integer
+    #   resp.job_status #=> String, one of "IN_PROGRESS", "SUCCEEDED", "FAILED", "PARTIAL_SUCCESS"
+    #   resp.next_token #=> String
+    #   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
+    #   resp.warnings #=> Array
+    #   resp.warnings[0].error_code #=> String
+    #   resp.warnings[0].pages #=> Array
+    #   resp.warnings[0].pages[0] #=> Integer
+    #   resp.status_message #=> String
+    #   resp.analyze_expense_model_version #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/GetExpenseAnalysis AWS API Documentation
+    #
+    # @overload get_expense_analysis(params = {})
+    # @param [Hash] params ({})
+    def get_expense_analysis(params = {}, options = {})
+      req = build_request(:get_expense_analysis, params)
+      req.send_request(options)
+    end
+
     # Starts the asynchronous analysis of an input document for
     # relationships between detected items such as key-value pairs, tables,
     # and selection elements.
     #
     # `StartDocumentAnalysis` can analyze text in documents that are in
-    # JPEG, 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.
+    # JPEG, PNG, TIFF, 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
@@ -1037,9 +1171,9 @@ module Aws::Textract
     # text.
     #
     # `StartDocumentTextDetection` can analyze text in documents that are in
-    # JPEG, 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.
+    # JPEG, PNG, TIFF, 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,
@@ -1134,6 +1268,108 @@ module Aws::Textract
       req.send_request(options)
     end
 
+    # Starts the asynchronous analysis of invoices or receipts for data like
+    # contact information, items purchased, and vendor names.
+    #
+    # `StartExpenseAnalysis` can analyze text in documents that are in JPEG,
+    # PNG, and PDF format. The documents must be stored in an Amazon S3
+    # bucket. Use the DocumentLocation parameter to specify the name of your
+    # S3 bucket and the name of the document in that bucket.
+    #
+    # `StartExpenseAnalysis` returns a job identifier (`JobId`) that you
+    # will provide to `GetExpenseAnalysis` to retrieve the results of the
+    # operation. When the analysis of the input invoices/receipts is
+    # finished, Amazon Textract publishes a completion status to the Amazon
+    # Simple Notification Service (Amazon SNS) topic that you provide to the
+    # `NotificationChannel`. To obtain the results of the invoice and
+    # receipt analysis operation, ensure that the status value published to
+    # the Amazon SNS topic is `SUCCEEDED`. If so, call GetExpenseAnalysis,
+    # and pass the job identifier (`JobId`) that was returned by your call
+    # to `StartExpenseAnalysis`.
+    #
+    # For more information, see [Analyzing Invoices and Receipts][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/textract/latest/dg/invoice-receipts.html
+    #
+    # @option params [required, Types::DocumentLocation] :document_location
+    #   The location of the document to be processed.
+    #
+    # @option params [String] :client_request_token
+    #   The idempotent token that's used to identify the start request. If
+    #   you use the same token with multiple `StartDocumentTextDetection`
+    #   requests, the same `JobId` is returned. Use `ClientRequestToken` to
+    #   prevent the same job from being accidentally started more than once.
+    #   For more information, see [Calling Amazon Textract Asynchronous
+    #   Operations][1]
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/textract/latest/dg/api-async.html
+    #
+    # @option params [String] :job_tag
+    #   An identifier you specify that's included in the completion
+    #   notification published to the Amazon SNS topic. For example, you can
+    #   use `JobTag` to identify the type of document that the completion
+    #   notification corresponds to (such as a tax form or a receipt).
+    #
+    # @option params [Types::NotificationChannel] :notification_channel
+    #   The Amazon SNS topic ARN that you want Amazon Textract to publish the
+    #   completion status of the operation to.
+    #
+    # @option params [Types::OutputConfig] :output_config
+    #   Sets if the output will go to a customer defined bucket. By default,
+    #   Amazon Textract will save the results internally to be accessed by the
+    #   `GetExpenseAnalysis` operation.
+    #
+    # @option params [String] :kms_key_id
+    #   The KMS key used to encrypt the inference results. This can be in
+    #   either Key ID or Key Alias format. When a KMS key is provided, the KMS
+    #   key will be used for server-side encryption of the objects in the
+    #   customer bucket. When this parameter is not enabled, the result will
+    #   be encrypted server side,using SSE-S3.
+    #
+    # @return [Types::StartExpenseAnalysisResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartExpenseAnalysisResponse#job_id #job_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_expense_analysis({
+    #     document_location: { # required
+    #       s3_object: {
+    #         bucket: "S3Bucket",
+    #         name: "S3ObjectName",
+    #         version: "S3ObjectVersion",
+    #       },
+    #     },
+    #     client_request_token: "ClientRequestToken",
+    #     job_tag: "JobTag",
+    #     notification_channel: {
+    #       sns_topic_arn: "SNSTopicArn", # required
+    #       role_arn: "RoleArn", # required
+    #     },
+    #     output_config: {
+    #       s3_bucket: "S3Bucket", # required
+    #       s3_prefix: "S3ObjectName",
+    #     },
+    #     kms_key_id: "KMSKeyId",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/StartExpenseAnalysis AWS API Documentation
+    #
+    # @overload start_expense_analysis(params = {})
+    # @param [Hash] params ({})
+    def start_expense_analysis(params = {}, options = {})
+      req = build_request(:start_expense_analysis, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -1147,7 +1383,7 @@ module Aws::Textract
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-textract'
-      context[:gem_version] = '1.29.0'
+      context[:gem_version] = '1.30.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -50,6 +50,8 @@ module Aws::Textract
     GetDocumentAnalysisResponse = Shapes::StructureShape.new(name: 'GetDocumentAnalysisResponse')
     GetDocumentTextDetectionRequest = Shapes::StructureShape.new(name: 'GetDocumentTextDetectionRequest')
     GetDocumentTextDetectionResponse = Shapes::StructureShape.new(name: 'GetDocumentTextDetectionResponse')
+    GetExpenseAnalysisRequest = Shapes::StructureShape.new(name: 'GetExpenseAnalysisRequest')
+    GetExpenseAnalysisResponse = Shapes::StructureShape.new(name: 'GetExpenseAnalysisResponse')
     HumanLoopActivationConditionsEvaluationResults = Shapes::StringShape.new(name: 'HumanLoopActivationConditionsEvaluationResults')
     HumanLoopActivationOutput = Shapes::StructureShape.new(name: 'HumanLoopActivationOutput')
     HumanLoopActivationReason = Shapes::StringShape.new(name: 'HumanLoopActivationReason')
@@ -100,6 +102,8 @@ module Aws::Textract
     StartDocumentAnalysisResponse = Shapes::StructureShape.new(name: 'StartDocumentAnalysisResponse')
     StartDocumentTextDetectionRequest = Shapes::StructureShape.new(name: 'StartDocumentTextDetectionRequest')
     StartDocumentTextDetectionResponse = Shapes::StructureShape.new(name: 'StartDocumentTextDetectionResponse')
+    StartExpenseAnalysisRequest = Shapes::StructureShape.new(name: 'StartExpenseAnalysisRequest')
+    StartExpenseAnalysisResponse = Shapes::StructureShape.new(name: 'StartExpenseAnalysisResponse')
     StatusMessage = Shapes::StringShape.new(name: 'StatusMessage')
     String = Shapes::StringShape.new(name: 'String')
     TextType = Shapes::StringShape.new(name: 'TextType')
@@ -237,6 +241,20 @@ module Aws::Textract
     GetDocumentTextDetectionResponse.add_member(:detect_document_text_model_version, Shapes::ShapeRef.new(shape: String, location_name: "DetectDocumentTextModelVersion"))
     GetDocumentTextDetectionResponse.struct_class = Types::GetDocumentTextDetectionResponse
 
+    GetExpenseAnalysisRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location_name: "JobId"))
+    GetExpenseAnalysisRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
+    GetExpenseAnalysisRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
+    GetExpenseAnalysisRequest.struct_class = Types::GetExpenseAnalysisRequest
+
+    GetExpenseAnalysisResponse.add_member(:document_metadata, Shapes::ShapeRef.new(shape: DocumentMetadata, location_name: "DocumentMetadata"))
+    GetExpenseAnalysisResponse.add_member(:job_status, Shapes::ShapeRef.new(shape: JobStatus, location_name: "JobStatus"))
+    GetExpenseAnalysisResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
+    GetExpenseAnalysisResponse.add_member(:expense_documents, Shapes::ShapeRef.new(shape: ExpenseDocumentList, location_name: "ExpenseDocuments"))
+    GetExpenseAnalysisResponse.add_member(:warnings, Shapes::ShapeRef.new(shape: Warnings, location_name: "Warnings"))
+    GetExpenseAnalysisResponse.add_member(:status_message, Shapes::ShapeRef.new(shape: StatusMessage, location_name: "StatusMessage"))
+    GetExpenseAnalysisResponse.add_member(:analyze_expense_model_version, Shapes::ShapeRef.new(shape: String, location_name: "AnalyzeExpenseModelVersion"))
+    GetExpenseAnalysisResponse.struct_class = Types::GetExpenseAnalysisResponse
+
     HumanLoopActivationOutput.add_member(:human_loop_arn, Shapes::ShapeRef.new(shape: HumanLoopArn, location_name: "HumanLoopArn"))
     HumanLoopActivationOutput.add_member(:human_loop_activation_reasons, Shapes::ShapeRef.new(shape: HumanLoopActivationReasons, location_name: "HumanLoopActivationReasons"))
     HumanLoopActivationOutput.add_member(:human_loop_activation_conditions_evaluation_results, Shapes::ShapeRef.new(shape: HumanLoopActivationConditionsEvaluationResults, location_name: "HumanLoopActivationConditionsEvaluationResults", metadata: {"jsonvalue"=>true}))
@@ -336,6 +354,17 @@ module Aws::Textract
     StartDocumentTextDetectionResponse.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, location_name: "JobId"))
     StartDocumentTextDetectionResponse.struct_class = Types::StartDocumentTextDetectionResponse
 
+    StartExpenseAnalysisRequest.add_member(:document_location, Shapes::ShapeRef.new(shape: DocumentLocation, required: true, location_name: "DocumentLocation"))
+    StartExpenseAnalysisRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
+    StartExpenseAnalysisRequest.add_member(:job_tag, Shapes::ShapeRef.new(shape: JobTag, location_name: "JobTag"))
+    StartExpenseAnalysisRequest.add_member(:notification_channel, Shapes::ShapeRef.new(shape: NotificationChannel, location_name: "NotificationChannel"))
+    StartExpenseAnalysisRequest.add_member(:output_config, Shapes::ShapeRef.new(shape: OutputConfig, location_name: "OutputConfig"))
+    StartExpenseAnalysisRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KMSKeyId, location_name: "KMSKeyId"))
+    StartExpenseAnalysisRequest.struct_class = Types::StartExpenseAnalysisRequest
+
+    StartExpenseAnalysisResponse.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, location_name: "JobId"))
+    StartExpenseAnalysisResponse.struct_class = Types::StartExpenseAnalysisResponse
+
     ThrottlingException.struct_class = Types::ThrottlingException
 
     UnsupportedDocumentException.struct_class = Types::UnsupportedDocumentException
@@ -448,6 +477,22 @@ module Aws::Textract
         o.errors << Shapes::ShapeRef.new(shape: InvalidKMSKeyException)
       end)
 
+      api.add_operation(:get_expense_analysis, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetExpenseAnalysis"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetExpenseAnalysisRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetExpenseAnalysisResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidJobIdException)
+        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|
         o.name = "StartDocumentAnalysis"
         o.http_method = "POST"
@@ -487,6 +532,26 @@ module Aws::Textract
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
       end)
+
+      api.add_operation(:start_expense_analysis, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StartExpenseAnalysis"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: StartExpenseAnalysisRequest)
+        o.output = Shapes::ShapeRef.new(shape: StartExpenseAnalysisResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidS3ObjectException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidKMSKeyException)
+        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: IdempotentParameterMismatchException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+      end)
     end
 
   end

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

@@ -322,11 +322,12 @@ module Aws::Textract
     # @!attribute [rw] page
     #   The page on which a block was detected. `Page` is returned by
     #   asynchronous operations. Page values greater than 1 are only
-    #   returned for multipage documents that are in PDF format. A scanned
-    #   image (JPEG/PNG), even if it contains multiple document pages, is
-    #   considered to be a single-page document. The value of `Page` is
-    #   always 1. Synchronous operations don't return `Page` because every
-    #   input document is considered to be a single-page document.
+    #   returned for multipage documents that are in PDF or TIFF format. A
+    #   scanned image (JPEG/PNG), even if it contains multiple document
+    #   pages, is considered to be a single-page document. The value of
+    #   `Page` is always 1. Synchronous operations don't return `Page`
+    #   because 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
@@ -864,6 +865,93 @@ module Aws::Textract
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetExpenseAnalysisRequest
+    #   data as a hash:
+    #
+    #       {
+    #         job_id: "JobId", # required
+    #         max_results: 1,
+    #         next_token: "PaginationToken",
+    #       }
+    #
+    # @!attribute [rw] job_id
+    #   A unique identifier for the text detection job. The `JobId` is
+    #   returned from `StartExpenseAnalysis`. A `JobId` value is only valid
+    #   for 7 days.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return per paginated call. The
+    #   largest value you can specify is 20. If you specify a value greater
+    #   than 20, a maximum of 20 results is returned. The default value is
+    #   20.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   If the previous response was incomplete (because there are more
+    #   blocks to retrieve), Amazon Textract returns a pagination token in
+    #   the response. You can use this pagination token to retrieve the next
+    #   set of blocks.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/GetExpenseAnalysisRequest AWS API Documentation
+    #
+    class GetExpenseAnalysisRequest < Struct.new(
+      :job_id,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] document_metadata
+    #   Information about a document that Amazon Textract processed.
+    #   `DocumentMetadata` is returned in every page of paginated responses
+    #   from an Amazon Textract operation.
+    #   @return [Types::DocumentMetadata]
+    #
+    # @!attribute [rw] job_status
+    #   The current status of the text detection job.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   If the response is truncated, Amazon Textract returns this token.
+    #   You can use this token in the subsequent request to retrieve the
+    #   next set of text-detection results.
+    #   @return [String]
+    #
+    # @!attribute [rw] expense_documents
+    #   The expenses detected by Amazon Textract.
+    #   @return [Array<Types::ExpenseDocument>]
+    #
+    # @!attribute [rw] warnings
+    #   A list of warnings that occurred during the text-detection operation
+    #   for the document.
+    #   @return [Array<Types::Warning>]
+    #
+    # @!attribute [rw] status_message
+    #   Returns if the detection job could not be completed. Contains
+    #   explanation for what error occured.
+    #   @return [String]
+    #
+    # @!attribute [rw] analyze_expense_model_version
+    #   The current model version of AnalyzeExpense.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/GetExpenseAnalysisResponse AWS API Documentation
+    #
+    class GetExpenseAnalysisResponse < Struct.new(
+      :document_metadata,
+      :job_status,
+      :next_token,
+      :expense_documents,
+      :warnings,
+      :status_message,
+      :analyze_expense_model_version)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Shows the results of the human in the loop evaluation. If there is no
     # HumanLoopArn, the input did not trigger human review.
     #
@@ -1253,7 +1341,7 @@ module Aws::Textract
     # @!attribute [rw] name
     #   The file name of the input document. Synchronous operations can use
     #   image files that are in JPEG or PNG format. Asynchronous operations
-    #   also support PDF format files.
+    #   also support PDF and TIFF format files.
     #   @return [String]
     #
     # @!attribute [rw] version
@@ -1472,6 +1560,100 @@ module Aws::Textract
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass StartExpenseAnalysisRequest
+    #   data as a hash:
+    #
+    #       {
+    #         document_location: { # required
+    #           s3_object: {
+    #             bucket: "S3Bucket",
+    #             name: "S3ObjectName",
+    #             version: "S3ObjectVersion",
+    #           },
+    #         },
+    #         client_request_token: "ClientRequestToken",
+    #         job_tag: "JobTag",
+    #         notification_channel: {
+    #           sns_topic_arn: "SNSTopicArn", # required
+    #           role_arn: "RoleArn", # required
+    #         },
+    #         output_config: {
+    #           s3_bucket: "S3Bucket", # required
+    #           s3_prefix: "S3ObjectName",
+    #         },
+    #         kms_key_id: "KMSKeyId",
+    #       }
+    #
+    # @!attribute [rw] document_location
+    #   The location of the document to be processed.
+    #   @return [Types::DocumentLocation]
+    #
+    # @!attribute [rw] client_request_token
+    #   The idempotent token that's used to identify the start request. If
+    #   you use the same token with multiple `StartDocumentTextDetection`
+    #   requests, the same `JobId` is returned. Use `ClientRequestToken` to
+    #   prevent the same job from being accidentally started more than once.
+    #   For more information, see [Calling Amazon Textract Asynchronous
+    #   Operations][1]
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/textract/latest/dg/api-async.html
+    #   @return [String]
+    #
+    # @!attribute [rw] job_tag
+    #   An identifier you specify that's included in the completion
+    #   notification published to the Amazon SNS topic. For example, you can
+    #   use `JobTag` to identify the type of document that the completion
+    #   notification corresponds to (such as a tax form or a receipt).
+    #   @return [String]
+    #
+    # @!attribute [rw] notification_channel
+    #   The Amazon SNS topic ARN that you want Amazon Textract to publish
+    #   the completion status of the operation to.
+    #   @return [Types::NotificationChannel]
+    #
+    # @!attribute [rw] output_config
+    #   Sets if the output will go to a customer defined bucket. By default,
+    #   Amazon Textract will save the results internally to be accessed by
+    #   the `GetExpenseAnalysis` operation.
+    #   @return [Types::OutputConfig]
+    #
+    # @!attribute [rw] kms_key_id
+    #   The KMS key used to encrypt the inference results. This can be in
+    #   either Key ID or Key Alias format. When a KMS key is provided, the
+    #   KMS key will be used for server-side encryption of the objects in
+    #   the customer bucket. When this parameter is not enabled, the result
+    #   will be encrypted server side,using SSE-S3.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/StartExpenseAnalysisRequest AWS API Documentation
+    #
+    class StartExpenseAnalysisRequest < Struct.new(
+      :document_location,
+      :client_request_token,
+      :job_tag,
+      :notification_channel,
+      :output_config,
+      :kms_key_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] job_id
+    #   A unique identifier for the text detection job. The `JobId` is
+    #   returned from `StartExpenseAnalysis`. A `JobId` value is only valid
+    #   for 7 days.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/StartExpenseAnalysisResponse AWS API Documentation
+    #
+    class StartExpenseAnalysisResponse < Struct.new(
+      :job_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Amazon Textract is temporarily unable to process the request. Try your
     # call again.
     #

data/lib/aws-sdk-textract.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-textract
 version: !ruby/object:Gem::Version
-  version: 1.29.0
+  version: 1.30.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-18 00:00:00.000000000 Z
+date: 2021-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core