google-cloud-document_ai-v1beta3 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f73c064f8aeb55219eabce72ddea4e6878bb6cb9e509322f06bddda3d0372bc
-  data.tar.gz: 8ff59c1e1afcacbad59be672ecf1008085d184fac33c4ec4f4139f86acd18cac
+  metadata.gz: 650cea67e4769baacc82734ac1c7513dfb44dd66f5b1a0f5dcacb1004afceefb
+  data.tar.gz: 64eff21575a82eb59761a3106e331fac1f695a19481706f23bdf5090453cfc43
 SHA512:
-  metadata.gz: ea14acb6b93210b7e0e755dcdc3e10763f6b24208fd21d852d2ddd41fe6ec028f44d40ba5ac4e00473f50b1d6d8dcb854c963cd8f9e8526a0168aec5dd687b01
-  data.tar.gz: 295a33772ea212a8abdbcfc4eddbb1a984b3cf0782e64f7ab35a214daf15249982e2b532d58f127fc20a47af3efa71cee6c98e4f7e8a51fe7c54631251438497
+  metadata.gz: b6d068b41fde80dc672fbcac3ffe1f93cd9c58607f3f93e74245c24abacac36c867a2ea1750e4a4002be7494a22654f8e0a504b81f7f06876da4ac589780d760
+  data.tar.gz: 15468d06286b4e322096d32a703c2f5233c83e1fff08df6fcc697057bd9776739e1e0dbf343672e45fc81bee6269428e69049881a28143a1e823ac7a68fe3aef

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/lib/google/cloud/document_ai/v1beta3/document_processor_service/client.rb

@@ -225,6 +225,8 @@ module Google
             #     false.
             #   @param field_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Specifies which fields to include in ProcessResponse's document.
+            #     Only supports top level document and pages field so it must be in the form
+            #     of `{document_field_name}` or `pages.{page_field_name}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DocumentAI::V1beta3::ProcessResponse]
@@ -772,6 +774,112 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Trains a new processor version.
+            # Operation metadata is returned as
+            # cloud_documentai_core.TrainProcessorVersionMetadata.
+            #
+            # @overload train_processor_version(request, options = nil)
+            #   Pass arguments to `train_processor_version` via a request object, either of type
+            #   {::Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload train_processor_version(parent: nil, processor_version: nil, document_schema: nil, input_data: nil, base_processor_version: nil)
+            #   Pass arguments to `train_processor_version` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param parent [::String]
+            #     Required. The parent (project, location and processor) to create the new version for.
+            #     Format: `projects/{project}/locations/{location}/processors/{processor}`.
+            #   @param processor_version [::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion, ::Hash]
+            #     Required. The processor version to be created.
+            #   @param document_schema [::Google::Cloud::DocumentAI::V1beta3::DocumentSchema, ::Hash]
+            #     Optional. The schema the processor version will be trained with.
+            #   @param input_data [::Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionRequest::InputData, ::Hash]
+            #     Optional. The input data used to train the `ProcessorVersion`.
+            #   @param base_processor_version [::String]
+            #     Optional. The processor version to use as a base for training. This processor version
+            #     must be a child of `parent`. Format:
+            #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/document_ai/v1beta3"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DocumentAI::V1beta3::DocumentProcessorService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionRequest.new
+            #
+            #   # Call the train_processor_version method.
+            #   result = client.train_processor_version request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
+            def train_processor_version request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DocumentAI::V1beta3::TrainProcessorVersionRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.train_processor_version.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DocumentAI::V1beta3::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.train_processor_version.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.train_processor_version.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @document_processor_service_stub.call_rpc :train_processor_version, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Gets a processor version detail.
             #
@@ -1811,6 +1919,290 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Evaluates a ProcessorVersion against annotated documents, producing an
+            # Evaluation.
+            #
+            # @overload evaluate_processor_version(request, options = nil)
+            #   Pass arguments to `evaluate_processor_version` via a request object, either of type
+            #   {::Google::Cloud::DocumentAI::V1beta3::EvaluateProcessorVersionRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DocumentAI::V1beta3::EvaluateProcessorVersionRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload evaluate_processor_version(processor_version: nil, evaluation_documents: nil)
+            #   Pass arguments to `evaluate_processor_version` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param processor_version [::String]
+            #     Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion ProcessorVersion} to evaluate.
+            #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
+            #   @param evaluation_documents [::Google::Cloud::DocumentAI::V1beta3::BatchDocumentsInputConfig, ::Hash]
+            #     Optional. The documents used in the evaluation. If unspecified, use the processor's
+            #     dataset as evaluation input.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/document_ai/v1beta3"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DocumentAI::V1beta3::DocumentProcessorService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DocumentAI::V1beta3::EvaluateProcessorVersionRequest.new
+            #
+            #   # Call the evaluate_processor_version method.
+            #   result = client.evaluate_processor_version request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
+            def evaluate_processor_version request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DocumentAI::V1beta3::EvaluateProcessorVersionRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.evaluate_processor_version.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DocumentAI::V1beta3::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.processor_version
+                header_params["processor_version"] = request.processor_version
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.evaluate_processor_version.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.evaluate_processor_version.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @document_processor_service_stub.call_rpc :evaluate_processor_version, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Retrieves a specific evaluation.
+            #
+            # @overload get_evaluation(request, options = nil)
+            #   Pass arguments to `get_evaluation` via a request object, either of type
+            #   {::Google::Cloud::DocumentAI::V1beta3::GetEvaluationRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DocumentAI::V1beta3::GetEvaluationRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload get_evaluation(name: nil)
+            #   Pass arguments to `get_evaluation` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::Evaluation Evaluation} to get.
+            #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}/evaluations/{evaluation}`
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DocumentAI::V1beta3::Evaluation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DocumentAI::V1beta3::Evaluation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/document_ai/v1beta3"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DocumentAI::V1beta3::DocumentProcessorService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DocumentAI::V1beta3::GetEvaluationRequest.new
+            #
+            #   # Call the get_evaluation method.
+            #   result = client.get_evaluation request
+            #
+            #   # The returned object is of type Google::Cloud::DocumentAI::V1beta3::Evaluation.
+            #   p result
+            #
+            def get_evaluation request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DocumentAI::V1beta3::GetEvaluationRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.get_evaluation.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DocumentAI::V1beta3::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.get_evaluation.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.get_evaluation.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @document_processor_service_stub.call_rpc :get_evaluation, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Retrieves a set of evaluations for a given processor version.
+            #
+            # @overload list_evaluations(request, options = nil)
+            #   Pass arguments to `list_evaluations` via a request object, either of type
+            #   {::Google::Cloud::DocumentAI::V1beta3::ListEvaluationsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DocumentAI::V1beta3::ListEvaluationsRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload list_evaluations(parent: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_evaluations` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param parent [::String]
+            #     Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion ProcessorVersion} to list evaluations for.
+            #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
+            #   @param page_size [::Integer]
+            #     The standard list page size.
+            #     If unspecified, at most 5 evaluations will be returned.
+            #     The maximum value is 100; values above 100 will be coerced to 100.
+            #   @param page_token [::String]
+            #     A page token, received from a previous `ListEvaluations` call.
+            #     Provide this to retrieve the subsequent page.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DocumentAI::V1beta3::Evaluation>]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::PagedEnumerable<::Google::Cloud::DocumentAI::V1beta3::Evaluation>]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/document_ai/v1beta3"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DocumentAI::V1beta3::DocumentProcessorService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DocumentAI::V1beta3::ListEvaluationsRequest.new
+            #
+            #   # Call the list_evaluations method.
+            #   result = client.list_evaluations request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::DocumentAI::V1beta3::Evaluation.
+            #     p response
+            #   end
+            #
+            def list_evaluations request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DocumentAI::V1beta3::ListEvaluationsRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.list_evaluations.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DocumentAI::V1beta3::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.list_evaluations.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.list_evaluations.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @document_processor_service_stub.call_rpc :list_evaluations, request, options: options do |response, operation|
+                response = ::Gapic::PagedEnumerable.new @document_processor_service_stub, :list_evaluations, request, response, operation, options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the DocumentProcessorService API.
             #
@@ -1977,6 +2369,11 @@ module Google
                 #
                 attr_reader :get_processor
                 ##
+                # RPC-specific configuration for `train_processor_version`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :train_processor_version
+                ##
                 # RPC-specific configuration for `get_processor_version`
                 # @return [::Gapic::Config::Method]
                 #
@@ -2031,6 +2428,21 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :review_document
+                ##
+                # RPC-specific configuration for `evaluate_processor_version`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :evaluate_processor_version
+                ##
+                # RPC-specific configuration for `get_evaluation`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :get_evaluation
+                ##
+                # RPC-specific configuration for `list_evaluations`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :list_evaluations
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -2046,6 +2458,8 @@ module Google
                   @list_processors = ::Gapic::Config::Method.new list_processors_config
                   get_processor_config = parent_rpcs.get_processor if parent_rpcs.respond_to? :get_processor
                   @get_processor = ::Gapic::Config::Method.new get_processor_config
+                  train_processor_version_config = parent_rpcs.train_processor_version if parent_rpcs.respond_to? :train_processor_version
+                  @train_processor_version = ::Gapic::Config::Method.new train_processor_version_config
                   get_processor_version_config = parent_rpcs.get_processor_version if parent_rpcs.respond_to? :get_processor_version
                   @get_processor_version = ::Gapic::Config::Method.new get_processor_version_config
                   list_processor_versions_config = parent_rpcs.list_processor_versions if parent_rpcs.respond_to? :list_processor_versions
@@ -2068,6 +2482,12 @@ module Google
                   @set_default_processor_version = ::Gapic::Config::Method.new set_default_processor_version_config
                   review_document_config = parent_rpcs.review_document if parent_rpcs.respond_to? :review_document
                   @review_document = ::Gapic::Config::Method.new review_document_config
+                  evaluate_processor_version_config = parent_rpcs.evaluate_processor_version if parent_rpcs.respond_to? :evaluate_processor_version
+                  @evaluate_processor_version = ::Gapic::Config::Method.new evaluate_processor_version_config
+                  get_evaluation_config = parent_rpcs.get_evaluation if parent_rpcs.respond_to? :get_evaluation
+                  @get_evaluation = ::Gapic::Config::Method.new get_evaluation_config
+                  list_evaluations_config = parent_rpcs.list_evaluations if parent_rpcs.respond_to? :list_evaluations
+                  @list_evaluations = ::Gapic::Config::Method.new list_evaluations_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/document_ai/v1beta3/document_processor_service/paths.rb

@@ -24,6 +24,29 @@ module Google
         module DocumentProcessorService
           # Path helper methods for the DocumentProcessorService API.
           module Paths
+            ##
+            # Create a fully-qualified Evaluation resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processor_version}/evaluations/{evaluation}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param processor [String]
+            # @param processor_version [String]
+            # @param evaluation [String]
+            #
+            # @return [::String]
+            def evaluation_path project:, location:, processor:, processor_version:, evaluation:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "processor cannot contain /" if processor.to_s.include? "/"
+              raise ::ArgumentError, "processor_version cannot contain /" if processor_version.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/processors/#{processor}/processorVersions/#{processor_version}/evaluations/#{evaluation}"
+            end
+
             ##
             # Create a fully-qualified HumanReviewConfig resource string.
             #

data/lib/google/cloud/document_ai/v1beta3/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module DocumentAI
       module V1beta3
-        VERSION = "0.13.0"
+        VERSION = "0.14.0"
       end
     end
   end

data/lib/google/cloud/documentai/v1beta3/document_io_pb.rb

@@ -3,6 +3,8 @@
 
 require 'google/protobuf'
 
+require 'google/protobuf/field_mask_pb'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/documentai/v1beta3/document_io.proto", :syntax => :proto3) do
     add_message "google.cloud.documentai.v1beta3.RawDocument" do
@@ -32,6 +34,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.documentai.v1beta3.DocumentOutputConfig.GcsOutputConfig" do
       optional :gcs_uri, :string, 1
+      optional :field_mask, :message, 2, "google.protobuf.FieldMask"
     end
   end
 end

data/lib/google/cloud/documentai/v1beta3/document_pb.rb

@@ -45,6 +45,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :text_style, :string, 5
       optional :text_decoration, :string, 6
       optional :font_size, :message, 7, "google.cloud.documentai.v1beta3.Document.Style.FontSize"
+      optional :font_family, :string, 8
     end
     add_message "google.cloud.documentai.v1beta3.Document.Style.FontSize" do
       optional :size, :float, 1
@@ -66,6 +67,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :form_fields, :message, 11, "google.cloud.documentai.v1beta3.Document.Page.FormField"
       repeated :symbols, :message, 12, "google.cloud.documentai.v1beta3.Document.Page.Symbol"
       repeated :detected_barcodes, :message, 15, "google.cloud.documentai.v1beta3.Document.Page.DetectedBarcode"
+      optional :image_quality_scores, :message, 17, "google.cloud.documentai.v1beta3.Document.Page.ImageQualityScores"
       optional :provenance, :message, 16, "google.cloud.documentai.v1beta3.Document.Provenance"
     end
     add_message "google.cloud.documentai.v1beta3.Document.Page.Dimension" do
@@ -142,6 +144,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :header_rows, :message, 2, "google.cloud.documentai.v1beta3.Document.Page.Table.TableRow"
       repeated :body_rows, :message, 3, "google.cloud.documentai.v1beta3.Document.Page.Table.TableRow"
       repeated :detected_languages, :message, 4, "google.cloud.documentai.v1beta3.Document.Page.DetectedLanguage"
+      optional :provenance, :message, 5, "google.cloud.documentai.v1beta3.Document.Provenance"
     end
     add_message "google.cloud.documentai.v1beta3.Document.Page.Table.TableRow" do
       repeated :cells, :message, 1, "google.cloud.documentai.v1beta3.Document.Page.Table.TableCell"
@@ -170,6 +173,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :language_code, :string, 1
       optional :confidence, :float, 2
     end
+    add_message "google.cloud.documentai.v1beta3.Document.Page.ImageQualityScores" do
+      optional :quality_score, :float, 1
+      repeated :detected_defects, :message, 2, "google.cloud.documentai.v1beta3.Document.Page.ImageQualityScores.DetectedDefect"
+    end
+    add_message "google.cloud.documentai.v1beta3.Document.Page.ImageQualityScores.DetectedDefect" do
+      optional :type, :string, 1
+      optional :confidence, :float, 2
+    end
     add_message "google.cloud.documentai.v1beta3.Document.Entity" do
       optional :text_anchor, :message, 1, "google.cloud.documentai.v1beta3.Document.TextAnchor"
       optional :type, :string, 2
@@ -299,6 +310,8 @@ module Google
         Document::Page::FormField = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.Page.FormField").msgclass
         Document::Page::DetectedBarcode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.Page.DetectedBarcode").msgclass
         Document::Page::DetectedLanguage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.Page.DetectedLanguage").msgclass
+        Document::Page::ImageQualityScores = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.Page.ImageQualityScores").msgclass
+        Document::Page::ImageQualityScores::DetectedDefect = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.Page.ImageQualityScores.DetectedDefect").msgclass
         Document::Entity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.Entity").msgclass
         Document::Entity::NormalizedValue = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.Entity.NormalizedValue").msgclass
         Document::EntityRelation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Document.EntityRelation").msgclass