google-cloud-document_ai-v1 0.11.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 251281326fb60fc4e0e5b2f5831ebb7af4234f98082f8a5efae4abb3da9fa6e5
-  data.tar.gz: 2b3cff5ce885e12637553dcfec4f33299cb155d0703c9a5053c57b26ab30a33d
+  metadata.gz: 449e75a7a1b950ae4260619b686ba845cf7cf85787e39ccf958bf37ee0b924b6
+  data.tar.gz: f8401aa0633d45d197c9b1cb047f1137262bbd6be99995a3b475495cb57dd1af
 SHA512:
-  metadata.gz: 22c5aa4127fc7169720f64e710b00b8692bcef130d6c5083b9e8e36b56aba8d3b6d58d1b3431974428c6e66e9b833b88f3b4ef8dc5f63ac049cbc9bed0661c0b
-  data.tar.gz: 5da3e5606fac798b999a9d7a34ce0f864025b923a5f7a4876d86406c51f6f01e56bd155aa2ccb580b86bc64dfcbedfc8eea87c86ea794400819d1d705699d054
+  metadata.gz: 7515548ea2fee15be368e028f4ae0781b743409b2124df389428e12296f2d2dd7f854ee96392aed7f81531d435b2ef5865287b44c3b863e5f316c9806036cd5d
+  data.tar.gz: 7b0be4d480ded4b18eaafc6bc02ede7308c886416794df30a823acc1ce0584c89b24c1a526b3ac1b9e71ec72f120d159f92f98f6b5f4b27a85313c9bf53e69d4

data/README.md

@@ -47,7 +47,7 @@ for general usage information.
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

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

@@ -28,7 +28,7 @@ module Google
           ##
           # Client for the DocumentProcessorService service.
           #
-          # Service to call Cloud DocumentAI to process documents according to the
+          # Service to call Document AI to process documents according to the
           # processor's definition. Processors are built using state-of-the-art Google
           # AI such as natural language, computer vision, and translation to extract
           # structured information from unstructured or semi-structured documents.
@@ -68,7 +68,7 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
-                default_config.rpcs.process_document.timeout = 120.0
+                default_config.rpcs.process_document.timeout = 300.0
                 default_config.rpcs.process_document.retry_policy = {
                   initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                 }
@@ -142,7 +142,7 @@ module Google
               credentials = @config.credentials
               # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
@@ -223,12 +223,13 @@ module Google
             #     or
             #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
             #   @param skip_human_review [::Boolean]
-            #     Whether Human Review feature should be skipped for this request. Default to
-            #     false.
+            #     Whether human review should be skipped for this request. Default to
+            #     `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}`.
+            #     Specifies which fields to include in the
+            #     {::Google::Cloud::DocumentAI::V1::ProcessResponse#document ProcessResponse.document}
+            #     output. 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::V1::ProcessResponse]
@@ -321,12 +322,16 @@ module Google
             #     or
             #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
             #   @param input_documents [::Google::Cloud::DocumentAI::V1::BatchDocumentsInputConfig, ::Hash]
-            #     The input documents for batch process.
+            #     The input documents for the
+            #     {::Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#batch_process_documents BatchProcessDocuments}
+            #     method.
             #   @param document_output_config [::Google::Cloud::DocumentAI::V1::DocumentOutputConfig, ::Hash]
-            #     The overall output config for batch process.
+            #     The output configuration for the
+            #     {::Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#batch_process_documents BatchProcessDocuments}
+            #     method.
             #   @param skip_human_review [::Boolean]
-            #     Whether Human Review feature should be skipped for this request. Default to
-            #     false.
+            #     Whether human review should be skipped for this request. Default to
+            #     `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -401,8 +406,9 @@ module Google
             end
 
             ##
-            # Fetches processor types. Note that we do not use ListProcessorTypes here
-            # because it is not paginated.
+            # Fetches processor types. Note that we don't use
+            # {::Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#list_processor_types ListProcessorTypes}
+            # here, because it isn't paginated.
             #
             # @overload fetch_processor_types(request, options = nil)
             #   Pass arguments to `fetch_processor_types` via a request object, either of type
@@ -420,9 +426,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project of processor type to list.
-            #     The available processor types may depend on the allow-listing on projects.
-            #     Format: `projects/{project}/locations/{location}`
+            #     Required. The location of processor types to list.
+            #     Format: `projects/{project}/locations/{location}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DocumentAI::V1::FetchProcessorTypesResponse]
@@ -507,13 +512,12 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The location of processor type to list.
-            #     The available processor types may depend on the allow-listing on projects.
-            #     Format: `projects/{project}/locations/{location}`
+            #     Required. The location of processor types to list.
+            #     Format: `projects/{project}/locations/{location}`.
             #   @param page_size [::Integer]
             #     The maximum number of processor types to return.
-            #     If unspecified, at most 100 processor types will be returned.
-            #     The maximum value is 500; values above 500 will be coerced to 500.
+            #     If unspecified, at most `100` processor types will be returned.
+            #     The maximum value is `500`. Values above `500` will be coerced to `500`.
             #   @param page_token [::String]
             #     Used to retrieve the next page of results, empty if at the end of the list.
             #
@@ -694,8 +698,8 @@ module Google
             #     Processors. Format: `projects/{project}/locations/{location}`
             #   @param page_size [::Integer]
             #     The maximum number of processors to return.
-            #     If unspecified, at most 50 processors will be returned.
-            #     The maximum value is 100; values above 100 will be coerced to 100.
+            #     If unspecified, at most `50` processors will be returned.
+            #     The maximum value is `100`. Values above `100` will be coerced to `100`.
             #   @param page_token [::String]
             #     We will return the processors sorted by creation time. The page token
             #     will point to the next processor.
@@ -857,7 +861,7 @@ module Google
             ##
             # Trains a new processor version.
             # Operation metadata is returned as
-            # cloud_documentai_core.TrainProcessorVersionMetadata.
+            # {::Google::Cloud::DocumentAI::V1::TrainProcessorVersionMetadata TrainProcessorVersionMetadata}.
             #
             # @overload train_processor_version(request, options = nil)
             #   Pass arguments to `train_processor_version` via a request object, either of type
@@ -883,7 +887,8 @@ module Google
             #   @param document_schema [::Google::Cloud::DocumentAI::V1::DocumentSchema, ::Hash]
             #     Optional. The schema the processor version will be trained with.
             #   @param input_data [::Google::Cloud::DocumentAI::V1::TrainProcessorVersionRequest::InputData, ::Hash]
-            #     Optional. The input data used to train the `ProcessorVersion`.
+            #     Optional. The input data used to train the
+            #     {::Google::Cloud::DocumentAI::V1::ProcessorVersion 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:
@@ -1070,8 +1075,8 @@ module Google
             #     `projects/{project}/locations/{location}/processors/{processor}`
             #   @param page_size [::Integer]
             #     The maximum number of processor versions to return.
-            #     If unspecified, at most 10 processor versions will be returned.
-            #     The maximum value is 20; values above 20 will be coerced to 20.
+            #     If unspecified, at most `10` processor versions will be returned.
+            #     The maximum value is `20`. Values above `20` will be coerced to `20`.
             #   @param page_token [::String]
             #     We will return the processor versions sorted by creation time. The page
             #     token will point to the next processor version.
@@ -1426,8 +1431,9 @@ module Google
             end
 
             ##
-            # Creates a processor from the type processor that the user chose.
-            # The processor will be at "ENABLED" state by default after its creation.
+            # Creates a processor from the
+            # {::Google::Cloud::DocumentAI::V1::ProcessorType ProcessorType} provided. The
+            # processor will be at `ENABLED` state by default after its creation.
             #
             # @overload create_processor(request, options = nil)
             #   Pass arguments to `create_processor` via a request object, either of type
@@ -1448,9 +1454,11 @@ module Google
             #     Required. The parent (project and location) under which to create the
             #     processor. Format: `projects/{project}/locations/{location}`
             #   @param processor [::Google::Cloud::DocumentAI::V1::Processor, ::Hash]
-            #     Required. The processor to be created, requires [processor_type] and
-            #     [display_name] to be set. Also, the processor is under CMEK if CMEK fields
-            #     are set.
+            #     Required. The processor to be created, requires
+            #     {::Google::Cloud::DocumentAI::V1::Processor#type Processor.type} and
+            #     [Processor.display_name]][] to be set. Also, the
+            #     {::Google::Cloud::DocumentAI::V1::Processor#kms_key_name Processor.kms_key_name}
+            #     field must be set if the processor is under CMEK.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DocumentAI::V1::Processor]
@@ -1922,8 +1930,9 @@ module Google
             #   @param inline_document [::Google::Cloud::DocumentAI::V1::Document, ::Hash]
             #     An inline document proto.
             #   @param human_review_config [::String]
-            #     Required. The resource name of the HumanReviewConfig that the document will
-            #     be reviewed with.
+            #     Required. The resource name of the
+            #     [HumanReviewConfig][google.cloud.documentai.v1.HumanReviewConfig] that the
+            #     document will be reviewed with.
             #   @param enable_schema_validation [::Boolean]
             #     Whether the validation should be performed on the ad-hoc review request.
             #   @param priority [::Google::Cloud::DocumentAI::V1::ReviewDocumentRequest::Priority]
@@ -2215,8 +2224,8 @@ module Google
             #     `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.
+            #     If unspecified, at most `5` evaluations are returned.
+            #     The maximum value is `100`. Values above `100` are coerced to `100`.
             #   @param page_token [::String]
             #     A page token, received from a previous `ListEvaluations` call.
             #     Provide this to retrieve the subsequent page.
@@ -2328,9 +2337,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
@@ -2372,7 +2381,9 @@ module Google
             class Configuration
               extend ::Gapic::Config
 
-              config_attr :endpoint,      "documentai.googleapis.com", ::String
+              DEFAULT_ENDPOINT = "documentai.googleapis.com"
+
+              config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
               config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC

data/lib/google/cloud/document_ai/v1/document_processor_service/operations.rb

@@ -620,9 +620,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
@@ -664,7 +664,9 @@ module Google
             class Configuration
               extend ::Gapic::Config
 
-              config_attr :endpoint,      "documentai.googleapis.com", ::String
+              DEFAULT_ENDPOINT = "documentai.googleapis.com"
+
+              config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
               config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC

data/lib/google/cloud/document_ai/v1/document_processor_service/rest/client.rb

@@ -30,7 +30,7 @@ module Google
             ##
             # REST client for the DocumentProcessorService service.
             #
-            # Service to call Cloud DocumentAI to process documents according to the
+            # Service to call Document AI to process documents according to the
             # processor's definition. Processors are built using state-of-the-art Google
             # AI such as natural language, computer vision, and translation to extract
             # structured information from unstructured or semi-structured documents.
@@ -70,7 +70,7 @@ module Google
                                   end
                   default_config = Client::Configuration.new parent_config
 
-                  default_config.rpcs.process_document.timeout = 120.0
+                  default_config.rpcs.process_document.timeout = 300.0
                   default_config.rpcs.process_document.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
@@ -138,7 +138,7 @@ module Google
                 credentials = @config.credentials
                 # Use self-signed JWT if the endpoint is unchanged from default,
                 # but only if the default endpoint does not have a region prefix.
-                enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
+                enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
                                          !@config.endpoint.split(".").first.include?("-")
                 credentials ||= Credentials.default scope: @config.scope,
                                                     enable_self_signed_jwt: enable_self_signed_jwt
@@ -215,12 +215,13 @@ module Google
               #     or
               #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
               #   @param skip_human_review [::Boolean]
-              #     Whether Human Review feature should be skipped for this request. Default to
-              #     false.
+              #     Whether human review should be skipped for this request. Default to
+              #     `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}`.
+              #     Specifies which fields to include in the
+              #     {::Google::Cloud::DocumentAI::V1::ProcessResponse#document ProcessResponse.document}
+              #     output. 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 [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DocumentAI::V1::ProcessResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -290,12 +291,16 @@ module Google
               #     or
               #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
               #   @param input_documents [::Google::Cloud::DocumentAI::V1::BatchDocumentsInputConfig, ::Hash]
-              #     The input documents for batch process.
+              #     The input documents for the
+              #     {::Google::Cloud::DocumentAI::V1::DocumentProcessorService::Rest::Client#batch_process_documents BatchProcessDocuments}
+              #     method.
               #   @param document_output_config [::Google::Cloud::DocumentAI::V1::DocumentOutputConfig, ::Hash]
-              #     The overall output config for batch process.
+              #     The output configuration for the
+              #     {::Google::Cloud::DocumentAI::V1::DocumentProcessorService::Rest::Client#batch_process_documents BatchProcessDocuments}
+              #     method.
               #   @param skip_human_review [::Boolean]
-              #     Whether Human Review feature should be skipped for this request. Default to
-              #     false.
+              #     Whether human review should be skipped for this request. Default to
+              #     `false`.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -340,8 +345,9 @@ module Google
               end
 
               ##
-              # Fetches processor types. Note that we do not use ListProcessorTypes here
-              # because it is not paginated.
+              # Fetches processor types. Note that we don't use
+              # {::Google::Cloud::DocumentAI::V1::DocumentProcessorService::Rest::Client#list_processor_types ListProcessorTypes}
+              # here, because it isn't paginated.
               #
               # @overload fetch_processor_types(request, options = nil)
               #   Pass arguments to `fetch_processor_types` via a request object, either of type
@@ -359,9 +365,8 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The project of processor type to list.
-              #     The available processor types may depend on the allow-listing on projects.
-              #     Format: `projects/{project}/locations/{location}`
+              #     Required. The location of processor types to list.
+              #     Format: `projects/{project}/locations/{location}`.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DocumentAI::V1::FetchProcessorTypesResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -423,13 +428,12 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The location of processor type to list.
-              #     The available processor types may depend on the allow-listing on projects.
-              #     Format: `projects/{project}/locations/{location}`
+              #     Required. The location of processor types to list.
+              #     Format: `projects/{project}/locations/{location}`.
               #   @param page_size [::Integer]
               #     The maximum number of processor types to return.
-              #     If unspecified, at most 100 processor types will be returned.
-              #     The maximum value is 500; values above 500 will be coerced to 500.
+              #     If unspecified, at most `100` processor types will be returned.
+              #     The maximum value is `500`. Values above `500` will be coerced to `500`.
               #   @param page_token [::String]
               #     Used to retrieve the next page of results, empty if at the end of the list.
               # @yield [result, operation] Access the result along with the TransportOperation object
@@ -560,8 +564,8 @@ module Google
               #     Processors. Format: `projects/{project}/locations/{location}`
               #   @param page_size [::Integer]
               #     The maximum number of processors to return.
-              #     If unspecified, at most 50 processors will be returned.
-              #     The maximum value is 100; values above 100 will be coerced to 100.
+              #     If unspecified, at most `50` processors will be returned.
+              #     The maximum value is `100`. Values above `100` will be coerced to `100`.
               #   @param page_token [::String]
               #     We will return the processors sorted by creation time. The page token
               #     will point to the next processor.
@@ -673,7 +677,7 @@ module Google
               ##
               # Trains a new processor version.
               # Operation metadata is returned as
-              # cloud_documentai_core.TrainProcessorVersionMetadata.
+              # {::Google::Cloud::DocumentAI::V1::TrainProcessorVersionMetadata TrainProcessorVersionMetadata}.
               #
               # @overload train_processor_version(request, options = nil)
               #   Pass arguments to `train_processor_version` via a request object, either of type
@@ -699,7 +703,8 @@ module Google
               #   @param document_schema [::Google::Cloud::DocumentAI::V1::DocumentSchema, ::Hash]
               #     Optional. The schema the processor version will be trained with.
               #   @param input_data [::Google::Cloud::DocumentAI::V1::TrainProcessorVersionRequest::InputData, ::Hash]
-              #     Optional. The input data used to train the `ProcessorVersion`.
+              #     Optional. The input data used to train the
+              #     {::Google::Cloud::DocumentAI::V1::ProcessorVersion 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:
@@ -833,8 +838,8 @@ module Google
               #     `projects/{project}/locations/{location}/processors/{processor}`
               #   @param page_size [::Integer]
               #     The maximum number of processor versions to return.
-              #     If unspecified, at most 10 processor versions will be returned.
-              #     The maximum value is 20; values above 20 will be coerced to 20.
+              #     If unspecified, at most `10` processor versions will be returned.
+              #     The maximum value is `20`. Values above `20` will be coerced to `20`.
               #   @param page_token [::String]
               #     We will return the processor versions sorted by creation time. The page
               #     token will point to the next processor version.
@@ -1072,8 +1077,9 @@ module Google
               end
 
               ##
-              # Creates a processor from the type processor that the user chose.
-              # The processor will be at "ENABLED" state by default after its creation.
+              # Creates a processor from the
+              # {::Google::Cloud::DocumentAI::V1::ProcessorType ProcessorType} provided. The
+              # processor will be at `ENABLED` state by default after its creation.
               #
               # @overload create_processor(request, options = nil)
               #   Pass arguments to `create_processor` via a request object, either of type
@@ -1094,9 +1100,11 @@ module Google
               #     Required. The parent (project and location) under which to create the
               #     processor. Format: `projects/{project}/locations/{location}`
               #   @param processor [::Google::Cloud::DocumentAI::V1::Processor, ::Hash]
-              #     Required. The processor to be created, requires [processor_type] and
-              #     [display_name] to be set. Also, the processor is under CMEK if CMEK fields
-              #     are set.
+              #     Required. The processor to be created, requires
+              #     {::Google::Cloud::DocumentAI::V1::Processor#type Processor.type} and
+              #     [Processor.display_name]][] to be set. Also, the
+              #     {::Google::Cloud::DocumentAI::V1::Processor#kms_key_name Processor.kms_key_name}
+              #     field must be set if the processor is under CMEK.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DocumentAI::V1::Processor]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1425,8 +1433,9 @@ module Google
               #   @param inline_document [::Google::Cloud::DocumentAI::V1::Document, ::Hash]
               #     An inline document proto.
               #   @param human_review_config [::String]
-              #     Required. The resource name of the HumanReviewConfig that the document will
-              #     be reviewed with.
+              #     Required. The resource name of the
+              #     [HumanReviewConfig][google.cloud.documentai.v1.HumanReviewConfig] that the
+              #     document will be reviewed with.
               #   @param enable_schema_validation [::Boolean]
               #     Whether the validation should be performed on the ad-hoc review request.
               #   @param priority [::Google::Cloud::DocumentAI::V1::ReviewDocumentRequest::Priority]
@@ -1635,8 +1644,8 @@ module Google
               #     `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.
+              #     If unspecified, at most `5` evaluations are returned.
+              #     The maximum value is `100`. Values above `100` are coerced to `100`.
               #   @param page_token [::String]
               #     A page token, received from a previous `ListEvaluations` call.
               #     Provide this to retrieve the subsequent page.
@@ -1721,9 +1730,9 @@ module Google
               #    *  (`String`) The path to a service account key file in JSON format
               #    *  (`Hash`) A service account key as a Hash
               #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-              #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+              #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-              #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+              #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope
@@ -1756,7 +1765,9 @@ module Google
               class Configuration
                 extend ::Gapic::Config
 
-                config_attr :endpoint,      "documentai.googleapis.com", ::String
+                DEFAULT_ENDPOINT = "documentai.googleapis.com"
+
+                config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
                 config_attr :credentials,   nil do |value|
                   allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                   allowed.any? { |klass| klass === value }

data/lib/google/cloud/document_ai/v1/document_processor_service/rest/operations.rb

@@ -411,9 +411,9 @@ module Google
               #    *  (`String`) The path to a service account key file in JSON format
               #    *  (`Hash`) A service account key as a Hash
               #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-              #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+              #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-              #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+              #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope
@@ -446,7 +446,9 @@ module Google
               class Configuration
                 extend ::Gapic::Config
 
-                config_attr :endpoint,      "documentai.googleapis.com", ::String
+                DEFAULT_ENDPOINT = "documentai.googleapis.com"
+
+                config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
                 config_attr :credentials,   nil do |value|
                   allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                   allowed.any? { |klass| klass === value }
@@ -567,7 +569,7 @@ module Google
 
                 verb, uri, query_string_params, body = OperationsServiceStub.transcode_list_operations_request request_pb
                 query_string_params = if query_string_params.any?
-                                        query_string_params.to_h { |p| p.split("=", 2) }
+                                        query_string_params.to_h { |p| p.split "=", 2 }
                                       else
                                         {}
                                       end
@@ -605,7 +607,7 @@ module Google
 
                 verb, uri, query_string_params, body = OperationsServiceStub.transcode_get_operation_request request_pb
                 query_string_params = if query_string_params.any?
-                                        query_string_params.to_h { |p| p.split("=", 2) }
+                                        query_string_params.to_h { |p| p.split "=", 2 }
                                       else
                                         {}
                                       end
@@ -643,7 +645,7 @@ module Google
 
                 verb, uri, query_string_params, body = OperationsServiceStub.transcode_delete_operation_request request_pb
                 query_string_params = if query_string_params.any?
-                                        query_string_params.to_h { |p| p.split("=", 2) }
+                                        query_string_params.to_h { |p| p.split "=", 2 }
                                       else
                                         {}
                                       end
@@ -681,7 +683,7 @@ module Google
 
                 verb, uri, query_string_params, body = OperationsServiceStub.transcode_cancel_operation_request request_pb
                 query_string_params = if query_string_params.any?
-                                        query_string_params.to_h { |p| p.split("=", 2) }
+                                        query_string_params.to_h { |p| p.split "=", 2 }
                                       else
                                         {}
                                       end