google-cloud-document_ai-v1beta3 0.12.0 → 0.13.0

data/proto_docs/google/cloud/documentai/v1beta3/document_processor_service.rb

@@ -30,7 +30,12 @@ module Google
         #     A raw document content (bytes).
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The processor resource name.
+        #     Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::Processor Processor} or
+        #     {::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion ProcessorVersion}
+        #     to use for processing. If a {::Google::Cloud::DocumentAI::V1beta3::Processor Processor} is specified, the server will use
+        #     its {::Google::Cloud::DocumentAI::V1beta3::Processor#default_processor_version default version}. Format:
+        #     `projects/{project}/locations/{location}/processors/{processor}`, or
+        #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
         # @!attribute [rw] document
         #   @return [::Google::Cloud::DocumentAI::V1beta3::Document]
         #     The document payload, the [content] and [mime_type] fields must be set.
@@ -38,6 +43,9 @@ module Google
         #   @return [::Boolean]
         #     Whether Human Review feature should be skipped for this request. Default to
         #     false.
+        # @!attribute [rw] field_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Specifies which fields to include in ProcessResponse's document.
         class ProcessRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -104,7 +112,11 @@ module Google
         # Request message for batch process document method.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The processor resource name.
+        #     Required. The resource name of {::Google::Cloud::DocumentAI::V1beta3::Processor Processor} or
+        #     {::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion ProcessorVersion}.
+        #     Format: `projects/{project}/locations/{location}/processors/{processor}`,
+        #     or
+        #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
         # @!attribute [rw] input_configs
         #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::BatchProcessRequest::BatchInputConfig>]
         #     The input config for each single document in the batch process.
@@ -185,10 +197,10 @@ module Google
           #     document during the process.
           # @!attribute [rw] status
           #   @return [::Google::Rpc::Status]
-          #     The status of the processing of the document.
+          #     The status processing the document.
           # @!attribute [rw] output_gcs_destination
           #   @return [::String]
-          #     The output_gcs_destination (in the request as 'output_gcs_destination')
+          #     The output_gcs_destination (in the request as `output_gcs_destination`)
           #     of the processed document if it was successful, otherwise empty.
           # @!attribute [rw] human_review_operation
           #   @return [::String]
@@ -233,7 +245,8 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The project of processor type to list.
-        #     Format: projects/\\{project}/locations/\\{location}
+        #     The available processor types may depend on the allow-listing on projects.
+        #     Format: `projects/{project}/locations/{location}`
         class FetchProcessorTypesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -248,11 +261,42 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for list processor types.
+        # @!attribute [rw] parent
+        #   @return [::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}`
+        # @!attribute [rw] page_size
+        #   @return [::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.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Used to retrieve the next page of results, empty if at the end of the list.
+        class ListProcessorTypesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for list processor types.
+        # @!attribute [rw] processor_types
+        #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::ProcessorType>]
+        #     The processor types.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Points to the next page, otherwise empty.
+        class ListProcessorTypesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for list all processors belongs to a project.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent (project and location) which owns this collection of Processors.
-        #     Format: projects/\\{project}/locations/\\{location}
+        #     Format: `projects/{project}/locations/{location}`
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     The maximum number of processors to return.
@@ -279,13 +323,129 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for get processor.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The processor resource name.
+        class GetProcessorRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for get processor version.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The processor resource name.
+        class GetProcessorVersionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for list all processor versions belongs to a processor.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent (project, location and processor) to list all versions.
+        #     Format: `projects/{project}/locations/{location}/processors/{processor}`
+        # @!attribute [rw] page_size
+        #   @return [::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.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     We will return the processor versions sorted by creation time. The page
+        #     token will point to the next processor version.
+        class ListProcessorVersionsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for list processors.
+        # @!attribute [rw] processor_versions
+        #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion>]
+        #     The list of processors.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Points to the next processor, otherwise empty.
+        class ListProcessorVersionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the delete processor version method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The processor version resource name to be deleted.
+        class DeleteProcessorVersionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The long running operation metadata for delete processor version method.
+        # @!attribute [rw] common_metadata
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::CommonOperationMetadata]
+        #     The basic metadata of the long running operation.
+        class DeleteProcessorVersionMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the deploy processor version method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The processor version resource name to be deployed.
+        class DeployProcessorVersionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for the deploy processor version method.
+        class DeployProcessorVersionResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The long running operation metadata for deploy processor version method.
+        # @!attribute [rw] common_metadata
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::CommonOperationMetadata]
+        #     The basic metadata of the long running operation.
+        class DeployProcessorVersionMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the undeploy processor version method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The processor version resource name to be undeployed.
+        class UndeployProcessorVersionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for the undeploy processor version method.
+        class UndeployProcessorVersionResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The long running operation metadata for the undeploy processor version
+        # method.
+        # @!attribute [rw] common_metadata
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::CommonOperationMetadata]
+        #     The basic metadata of the long running operation.
+        class UndeployProcessorVersionMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for create a processor. Notice this request is sent to
         # a regionalized backend service, and if the processor type is not available
         # on that region, the creation will fail.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent (project and location) under which to create the processor.
-        #     Format: projects/\\{project}/locations/\\{location}
+        #     Format: `projects/{project}/locations/{location}`
         # @!attribute [rw] processor
         #   @return [::Google::Cloud::DocumentAI::V1beta3::Processor]
         #     Required. The processor to be created, requires [processor_type] and [display_name]
@@ -323,6 +483,7 @@ module Google
         end
 
         # Response message for the enable processor method.
+        # Intentionally empty proto for adding fields in future.
         class EnableProcessorResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -347,6 +508,7 @@ module Google
         end
 
         # Response message for the disable processor method.
+        # Intentionally empty proto for adding fields in future.
         class DisableProcessorResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -361,8 +523,37 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for the set default processor version method.
+        # @!attribute [rw] processor
+        #   @return [::String]
+        #     Required. The resource name of the {::Google::Cloud::DocumentAI::V1beta3::Processor Processor} to change default version.
+        # @!attribute [rw] default_processor_version
+        #   @return [::String]
+        #     Required. The resource name of child {::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion ProcessorVersion} to use as default.
+        #     Format:
+        #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{version}`
+        class SetDefaultProcessorVersionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for set default processor version method.
+        class SetDefaultProcessorVersionResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The long running operation metadata for set default processor version
+        # method.
+        # @!attribute [rw] common_metadata
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::CommonOperationMetadata]
+        #     The basic metadata of the long running operation.
+        class SetDefaultProcessorVersionMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for review document method.
-        # Next Id: 6.
         # @!attribute [rw] inline_document
         #   @return [::Google::Cloud::DocumentAI::V1beta3::Document]
         #     An inline document proto.
@@ -379,6 +570,9 @@ module Google
         # @!attribute [rw] priority
         #   @return [::Google::Cloud::DocumentAI::V1beta3::ReviewDocumentRequest::Priority]
         #     The priority of the human review task.
+        # @!attribute [rw] document_schema
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::DocumentSchema]
+        #     The document schema of the human review task.
         class ReviewDocumentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -397,10 +591,29 @@ module Google
         # Response message for review document method.
         # @!attribute [rw] gcs_destination
         #   @return [::String]
-        #     The Cloud Storage uri for the human reviewed document.
+        #     The Cloud Storage uri for the human reviewed document if the review is
+        #     succeeded.
+        # @!attribute [rw] state
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::ReviewDocumentResponse::State]
+        #     The state of the review operation.
+        # @!attribute [rw] rejection_reason
+        #   @return [::String]
+        #     The reason why the review is rejected by reviewer.
         class ReviewDocumentResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Possible states of the review operation.
+          module State
+            # The default value. This value is used if the state is omitted.
+            STATE_UNSPECIFIED = 0
+
+            # The review operation is rejected by the reviewer.
+            REJECTED = 1
+
+            # The review operation is succeeded.
+            SUCCEEDED = 2
+          end
         end
 
         # The long running operation metadata for review document method.
@@ -422,7 +635,7 @@ module Google
         #     The basic metadata of the long running operation.
         # @!attribute [rw] question_id
         #   @return [::String]
-        #     The question ID.
+        #     The Crowd Compute question ID.
         class ReviewDocumentOperationMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/documentai/v1beta3/document_schema.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module DocumentAI
+      module V1beta3
+        # The schema defines the output of the processed document by a processor.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Display name to show to users.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Description of the schema.
+        # @!attribute [rw] entity_types
+        #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::DocumentSchema::EntityType>]
+        #     Entity types of the schema.
+        # @!attribute [rw] metadata
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::DocumentSchema::Metadata]
+        #     Metadata of the schema.
+        class DocumentSchema
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # EntityType is the wrapper of a label of the corresponding model with
+          # detailed attributes and limitations for entity-based processors. Multiple
+          # types can also compose a dependency tree to represent nested types.
+          # @!attribute [rw] enum_values
+          #   @return [::Google::Cloud::DocumentAI::V1beta3::DocumentSchema::EntityType::EnumValues]
+          #     If specified, lists all the possible values for this entity.  This
+          #     should not be more than a handful of values.  If the number of values
+          #     is >10 or could change frequently use the `EntityType.value_ontology`
+          #     field and specify a list of all possible values in a value ontology
+          #     file.
+          # @!attribute [rw] display_name
+          #   @return [::String]
+          #     User defined name for the type.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Name of the type. It must be unique within the schema file and
+          #     cannot be a 'Common Type'.  Besides that we use the following naming
+          #     conventions:
+          #     - *use snake_casing*
+          #     - name matching is case-insensitive
+          #     - Maximum 64 characters.
+          #     - Must start with a letter.
+          #     - Allowed characters: ASCII letters `[a-z0-9_-]`.  (For backward
+          #       compatibility internal infrastructure and tooling can handle any ascii
+          #       character)
+          #     - The '/' is sometimes used to denote a property of a type.  For example
+          #       line_item/amount.  This convention is deprecated, but will still be
+          #       honored for backward compatibility.
+          # @!attribute [rw] base_types
+          #   @return [::Array<::String>]
+          #     The entity type that this type is derived from.  For now, one and only
+          #     one should be set.
+          # @!attribute [rw] properties
+          #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::DocumentSchema::EntityType::Property>]
+          #     Describing the nested structure, or composition of an entity.
+          class EntityType
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Defines the a list of enum values.
+            # @!attribute [rw] values
+            #   @return [::Array<::String>]
+            #     The individual values that this enum values type can include.
+            class EnumValues
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Defines properties that can be part of the entity type.
+            # @!attribute [rw] name
+            #   @return [::String]
+            #     The name of the property.  Follows the same guidelines as the
+            #     EntityType name.
+            # @!attribute [rw] value_type
+            #   @return [::String]
+            #     A reference to the value type of the property.  This type is subject
+            #     to the same conventions as the `Entity.base_types` field.
+            # @!attribute [rw] occurrence_type
+            #   @return [::Google::Cloud::DocumentAI::V1beta3::DocumentSchema::EntityType::Property::OccurrenceType]
+            #     Occurrence type limits the number of instances an entity type appears
+            #     in the document.
+            class Property
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Types of occurrences of the entity type in the document.  Note: this
+              # represents the number of instances of an entity types, not number of
+              # mentions of a given entity instance.
+              module OccurrenceType
+                # Unspecified occurrence type.
+                OCCURRENCE_TYPE_UNSPECIFIED = 0
+
+                # There will be zero or one instance of this entity type.
+                OPTIONAL_ONCE = 1
+
+                # The entity type will appear zero or multiple times.
+                OPTIONAL_MULTIPLE = 2
+
+                # The entity type will only appear exactly once.
+                REQUIRED_ONCE = 3
+
+                # The entity type will appear once or more times.
+                REQUIRED_MULTIPLE = 4
+              end
+            end
+          end
+
+          # Metadata for global schema behavior.
+          # @!attribute [rw] document_splitter
+          #   @return [::Boolean]
+          #     If true, a `document` entity type can be applied to subdocument (
+          #     splitting). Otherwise, it can only be applied to the entire document
+          #     (classification).
+          # @!attribute [rw] document_allow_multiple_labels
+          #   @return [::Boolean]
+          #     If true, on a given page, there can be multiple `document` annotations
+          #     covering it.
+          # @!attribute [rw] prefixed_naming_on_properties
+          #   @return [::Boolean]
+          #     If set, all the nested entities must be prefixed with the parents.
+          # @!attribute [rw] skip_naming_validation
+          #   @return [::Boolean]
+          #     If set, we will skip the naming format validation in the schema. So the
+          #     string values in `DocumentSchema.EntityType.name` and
+          #     `DocumentSchema.EntityType.Property.name` will not be checked.
+          class Metadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/documentai/v1beta3/operation_metadata.rb

@@ -28,6 +28,9 @@ module Google
         # @!attribute [rw] state_message
         #   @return [::String]
         #     A message providing more details about the current state of processing.
+        # @!attribute [rw] resource
+        #   @return [::String]
+        #     A related resource to this operation.
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The creation time of the operation.

data/proto_docs/google/cloud/documentai/v1beta3/processor.rb

@@ -21,15 +21,92 @@ module Google
   module Cloud
     module DocumentAI
       module V1beta3
-        # The first-class citizen for DocumentAI. Each processor defines how to extract
-        # structural information from a document.
+        # A processor version is an implementation of a processor. Each processor
+        # can have multiple versions, pre-trained by Google internally or up-trained
+        # by the customer. At a time, a processor can only have one default version
+        # version. So the processor's behavior (when processing documents) is defined
+        # by a default version
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The resource name of the processor version.
+        #     Format:
+        #     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processor_version}`
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     The display name of the processor version.
+        # @!attribute [rw] state
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion::State]
+        #     The state of the processor version.
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time the processor version was created.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     The KMS key name used for encryption.
+        # @!attribute [rw] kms_key_version_name
+        #   @return [::String]
+        #     The KMS key version with which data is encrypted.
+        # @!attribute [rw] google_managed
+        #   @return [::Boolean]
+        #     Denotes that this ProcessorVersion is managed by google.
+        # @!attribute [rw] deprecation_info
+        #   @return [::Google::Cloud::DocumentAI::V1beta3::ProcessorVersion::DeprecationInfo]
+        #     If set, information about the eventual deprecation of this version.
+        class ProcessorVersion
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Information about the upcoming deprecation of this processor version.
+          # @!attribute [rw] deprecation_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time at which this processor version will be deprecated.
+          # @!attribute [rw] replacement_processor_version
+          #   @return [::String]
+          #     If set, the processor version that will be used as a replacement.
+          class DeprecationInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The possible states of the processor version.
+          module State
+            # The processor version is in an unspecified state.
+            STATE_UNSPECIFIED = 0
+
+            # The processor version is deployed and can be used for processing.
+            DEPLOYED = 1
+
+            # The processor version is being deployed.
+            DEPLOYING = 2
+
+            # The processor version is not deployed and cannot be used for processing.
+            UNDEPLOYED = 3
+
+            # The processor version is being undeployed.
+            UNDEPLOYING = 4
+
+            # The processor version is being created.
+            CREATING = 5
+
+            # The processor version is being deleted.
+            DELETING = 6
+
+            # The processor version failed and is in an indeterminate state.
+            FAILED = 7
+          end
+        end
+
+        # The first-class citizen for Document AI. Each processor defines how to
+        # extract structural information from a document.
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. Immutable. The resource name of the processor.
-        #     Format: projects/\\{project}/locations/\\{location}/processors/\\{processor}
+        #     Format: `projects/{project}/locations/{location}/processors/{processor}`
         # @!attribute [rw] type
         #   @return [::String]
-        #     The processor type.
+        #     The processor type, e.g., OCR_PROCESSOR, INVOICE_PROCESSOR, etc.
+        #     To get a list of processors types, see
+        #     {::Google::Cloud::DocumentAI::V1beta3::DocumentProcessorService::Client#fetch_processor_types FetchProcessorTypes}.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     The display name of the processor.
@@ -58,7 +135,9 @@ module Google
             # The processor is in an unspecified state.
             STATE_UNSPECIFIED = 0
 
-            # The processor is enabled.
+            # The processor is enabled, i.e., has an enabled version which can
+            # currently serve processing requests and all the feature dependencies have
+            # been successfully initialized.
             ENABLED = 1
 
             # The processor is disabled.
@@ -70,10 +149,16 @@ module Google
             # The processor is being disabled, will become DISABLED if successful.
             DISABLING = 4
 
-            # The processor is being created.
+            # The processor is being created, will become either ENABLED (for
+            # successful creation) or FAILED (for failed ones).
+            # Once a processor is in this state, it can then be used for document
+            # processing, but the feature dependencies of the processor might not be
+            # fully created yet.
             CREATING = 5
 
-            # The processor failed during creation.
+            # The processor failed during creation or initialization of feature
+            # dependencies. The user should delete the processor and recreate one as
+            # all the functionalities of the processor are disabled.
             FAILED = 6
 
             # The processor is being deleted, will be removed if successful.

data/proto_docs/google/cloud/documentai/v1beta3/processor_type.rb

@@ -26,20 +26,23 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     The resource name of the processor type.
+        #     Format: projects/\\{project}/processorTypes/\\{processor_type}
         # @!attribute [rw] type
         #   @return [::String]
-        #     The type of the processor.
+        #     The type of the processor, e.g., "invoice_parsing".
         # @!attribute [rw] category
         #   @return [::String]
-        #     The processor category.
+        #     The processor category, used by UI to group processor types.
         # @!attribute [rw] available_locations
         #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::ProcessorType::LocationInfo>]
         #     The locations in which this processor is available.
         # @!attribute [rw] allow_creation
         #   @return [::Boolean]
-        #     Whether the processor type allows creation. If yes, user can create a
-        #     processor of this processor type. Otherwise, user needs to require for
-        #     whitelisting.
+        #     Whether the processor type allows creation. If true, users can create a
+        #     processor of this processor type. Otherwise, users need to request access.
+        # @!attribute [rw] launch_stage
+        #   @return [::Google::Api::LaunchStage]
+        #     Launch stage of the processor type
         class ProcessorType
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -47,7 +50,7 @@ module Google
           # The location information about where the processor is available.
           # @!attribute [rw] location_id
           #   @return [::String]
-          #     The location id.
+          #     The location id, currently must be one of [us, eu].
           class LocationInfo
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods