google-cloud-document_ai-v1beta3 0.6.0 → 0.9.1

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

@@ -82,7 +82,7 @@ module Google
               # Create credentials
               credentials = @config.credentials
               credentials ||= Credentials.default scope: @config.scope
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -396,9 +396,9 @@ module Google
             end
 
             ##
-            # Waits for the specified long-running operation until it is done or reaches
-            # at most a specified timeout, returning the latest state.  If the operation
-            # is already done, the latest state is immediately returned.  If the timeout
+            # Waits until the specified long-running operation is done or reaches at most
+            # a specified timeout, returning the latest state.  If the operation is
+            # already done, the latest state is immediately returned.  If the timeout
             # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
             # timeout is used.  If the server does not support this method, it returns
             # `google.rpc.Code.UNIMPLEMENTED`.
@@ -500,7 +500,7 @@ module Google
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
-            #   Defaults to `"us-documentai.googleapis.com"`.
+            #   Defaults to `"documentai.googleapis.com"`.
             #   @return [::String]
             # @!attribute [rw] credentials
             #   Credentials to send with calls. You may provide any of the following types:
@@ -551,7 +551,7 @@ module Google
             class Configuration
               extend ::Gapic::Config
 
-              config_attr :endpoint,      "us-documentai.googleapis.com", ::String
+              config_attr :endpoint,      "documentai.googleapis.com", ::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/v1beta3/document_processor_service/paths.rb

@@ -43,6 +43,23 @@ module Google
               "projects/#{project}/locations/#{location}/processors/#{processor}/humanReviewConfig"
             end
 
+            ##
+            # Create a fully-qualified Location resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}`
+            #
+            # @param project [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def location_path project:, location:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}"
+            end
+
             ##
             # Create a fully-qualified Processor 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.6.0"
+        VERSION = "0.9.1"
       end
     end
   end

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

@@ -63,6 +63,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :visual_elements, :message, 9, "google.cloud.documentai.v1beta3.Document.Page.VisualElement"
       repeated :tables, :message, 10, "google.cloud.documentai.v1beta3.Document.Page.Table"
       repeated :form_fields, :message, 11, "google.cloud.documentai.v1beta3.Document.Page.FormField"
+      optional :provenance, :message, 16, "google.cloud.documentai.v1beta3.Document.Provenance"
     end
     add_message "google.cloud.documentai.v1beta3.Document.Page.Dimension" do
       optional :width, :float, 1
@@ -150,6 +151,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :name_detected_languages, :message, 3, "google.cloud.documentai.v1beta3.Document.Page.DetectedLanguage"
       repeated :value_detected_languages, :message, 4, "google.cloud.documentai.v1beta3.Document.Page.DetectedLanguage"
       optional :value_type, :string, 5
+      optional :provenance, :message, 8, "google.cloud.documentai.v1beta3.Document.Provenance"
     end
     add_message "google.cloud.documentai.v1beta3.Document.Page.DetectedLanguage" do
       optional :language_code, :string, 1
@@ -199,6 +201,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :layout_type, :enum, 2, "google.cloud.documentai.v1beta3.Document.PageAnchor.PageRef.LayoutType"
       optional :layout_id, :string, 3
       optional :bounding_poly, :message, 4, "google.cloud.documentai.v1beta3.BoundingPoly"
+      optional :confidence, :float, 5
     end
     add_enum "google.cloud.documentai.v1beta3.Document.PageAnchor.PageRef.LayoutType" do
       value :LAYOUT_TYPE_UNSPECIFIED, 0
@@ -218,6 +221,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.documentai.v1beta3.Document.Provenance.Parent" do
       optional :revision, :int32, 1
+      optional :index, :int32, 3
       optional :id, :int32, 2
     end
     add_enum "google.cloud.documentai.v1beta3.Document.Provenance.OperationType" do
@@ -227,6 +231,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :REPLACE, 3
       value :EVAL_REQUESTED, 4
       value :EVAL_APPROVED, 5
+      value :EVAL_SKIPPED, 6
     end
     add_message "google.cloud.documentai.v1beta3.Document.Revision" do
       optional :id, :string, 1

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

@@ -9,6 +9,9 @@ require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/documentai/v1beta3/document_pb'
 require 'google/cloud/documentai/v1beta3/document_io_pb'
+require 'google/cloud/documentai/v1beta3/operation_metadata_pb'
+require 'google/cloud/documentai/v1beta3/processor_pb'
+require 'google/cloud/documentai/v1beta3/processor_type_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
@@ -81,13 +84,60 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :CANCELLED, 5
       value :FAILED, 6
     end
+    add_message "google.cloud.documentai.v1beta3.FetchProcessorTypesRequest" do
+      optional :parent, :string, 1
+    end
+    add_message "google.cloud.documentai.v1beta3.FetchProcessorTypesResponse" do
+      repeated :processor_types, :message, 1, "google.cloud.documentai.v1beta3.ProcessorType"
+    end
+    add_message "google.cloud.documentai.v1beta3.ListProcessorsRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.documentai.v1beta3.ListProcessorsResponse" do
+      repeated :processors, :message, 1, "google.cloud.documentai.v1beta3.Processor"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.cloud.documentai.v1beta3.CreateProcessorRequest" do
+      optional :parent, :string, 1
+      optional :processor, :message, 2, "google.cloud.documentai.v1beta3.Processor"
+    end
+    add_message "google.cloud.documentai.v1beta3.DeleteProcessorRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.documentai.v1beta3.DeleteProcessorMetadata" do
+      optional :common_metadata, :message, 5, "google.cloud.documentai.v1beta3.CommonOperationMetadata"
+    end
+    add_message "google.cloud.documentai.v1beta3.EnableProcessorRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.documentai.v1beta3.EnableProcessorResponse" do
+    end
+    add_message "google.cloud.documentai.v1beta3.EnableProcessorMetadata" do
+      optional :common_metadata, :message, 5, "google.cloud.documentai.v1beta3.CommonOperationMetadata"
+    end
+    add_message "google.cloud.documentai.v1beta3.DisableProcessorRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.documentai.v1beta3.DisableProcessorResponse" do
+    end
+    add_message "google.cloud.documentai.v1beta3.DisableProcessorMetadata" do
+      optional :common_metadata, :message, 5, "google.cloud.documentai.v1beta3.CommonOperationMetadata"
+    end
     add_message "google.cloud.documentai.v1beta3.ReviewDocumentRequest" do
       optional :human_review_config, :string, 1
       optional :document, :message, 2, "google.cloud.documentai.v1beta3.Document"
+      optional :enable_schema_validation, :bool, 3
+      optional :priority, :enum, 5, "google.cloud.documentai.v1beta3.ReviewDocumentRequest.Priority"
       oneof :source do
         optional :inline_document, :message, 4, "google.cloud.documentai.v1beta3.Document"
       end
     end
+    add_enum "google.cloud.documentai.v1beta3.ReviewDocumentRequest.Priority" do
+      value :DEFAULT, 0
+      value :URGENT, 1
+    end
     add_message "google.cloud.documentai.v1beta3.ReviewDocumentResponse" do
       optional :gcs_destination, :string, 1
     end
@@ -106,20 +156,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :FAILED, 4
       value :CANCELLED, 5
     end
-    add_message "google.cloud.documentai.v1beta3.CommonOperationMetadata" do
-      optional :state, :enum, 1, "google.cloud.documentai.v1beta3.CommonOperationMetadata.State"
-      optional :state_message, :string, 2
-      optional :create_time, :message, 3, "google.protobuf.Timestamp"
-      optional :update_time, :message, 4, "google.protobuf.Timestamp"
-    end
-    add_enum "google.cloud.documentai.v1beta3.CommonOperationMetadata.State" do
-      value :STATE_UNSPECIFIED, 0
-      value :RUNNING, 1
-      value :CANCELLING, 2
-      value :SUCCEEDED, 3
-      value :FAILED, 4
-      value :CANCELLED, 5
-    end
   end
 end
 
@@ -138,12 +174,24 @@ module Google
         BatchProcessMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.BatchProcessMetadata").msgclass
         BatchProcessMetadata::IndividualProcessStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.BatchProcessMetadata.IndividualProcessStatus").msgclass
         BatchProcessMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.BatchProcessMetadata.State").enummodule
+        FetchProcessorTypesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.FetchProcessorTypesRequest").msgclass
+        FetchProcessorTypesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.FetchProcessorTypesResponse").msgclass
+        ListProcessorsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ListProcessorsRequest").msgclass
+        ListProcessorsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ListProcessorsResponse").msgclass
+        CreateProcessorRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.CreateProcessorRequest").msgclass
+        DeleteProcessorRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.DeleteProcessorRequest").msgclass
+        DeleteProcessorMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.DeleteProcessorMetadata").msgclass
+        EnableProcessorRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.EnableProcessorRequest").msgclass
+        EnableProcessorResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.EnableProcessorResponse").msgclass
+        EnableProcessorMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.EnableProcessorMetadata").msgclass
+        DisableProcessorRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.DisableProcessorRequest").msgclass
+        DisableProcessorResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.DisableProcessorResponse").msgclass
+        DisableProcessorMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.DisableProcessorMetadata").msgclass
         ReviewDocumentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ReviewDocumentRequest").msgclass
+        ReviewDocumentRequest::Priority = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ReviewDocumentRequest.Priority").enummodule
         ReviewDocumentResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ReviewDocumentResponse").msgclass
         ReviewDocumentOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ReviewDocumentOperationMetadata").msgclass
         ReviewDocumentOperationMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ReviewDocumentOperationMetadata.State").enummodule
-        CommonOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.CommonOperationMetadata").msgclass
-        CommonOperationMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.CommonOperationMetadata.State").enummodule
       end
     end
   end

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

@@ -41,6 +41,20 @@ module Google
             # LRO endpoint to batch process many documents. The output is written
             # to Cloud Storage as JSON in the [Document] format.
             rpc :BatchProcessDocuments, ::Google::Cloud::DocumentAI::V1beta3::BatchProcessRequest, ::Google::Longrunning::Operation
+            # Fetches processor types.
+            rpc :FetchProcessorTypes, ::Google::Cloud::DocumentAI::V1beta3::FetchProcessorTypesRequest, ::Google::Cloud::DocumentAI::V1beta3::FetchProcessorTypesResponse
+            # Lists all processors which belong to this project.
+            rpc :ListProcessors, ::Google::Cloud::DocumentAI::V1beta3::ListProcessorsRequest, ::Google::Cloud::DocumentAI::V1beta3::ListProcessorsResponse
+            # Creates a processor from the type processor that the user chose.
+            # The processor will be at "ENABLED" state by default after its creation.
+            rpc :CreateProcessor, ::Google::Cloud::DocumentAI::V1beta3::CreateProcessorRequest, ::Google::Cloud::DocumentAI::V1beta3::Processor
+            # Deletes the processor, unloads all deployed model artifacts if it was
+            # enabled and then deletes all artifacts associated with this processor.
+            rpc :DeleteProcessor, ::Google::Cloud::DocumentAI::V1beta3::DeleteProcessorRequest, ::Google::Longrunning::Operation
+            # Enables a processor
+            rpc :EnableProcessor, ::Google::Cloud::DocumentAI::V1beta3::EnableProcessorRequest, ::Google::Longrunning::Operation
+            # Disables a processor
+            rpc :DisableProcessor, ::Google::Cloud::DocumentAI::V1beta3::DisableProcessorRequest, ::Google::Longrunning::Operation
             # Send a document for Human Review. The input document should be processed by
             # the specified processor.
             rpc :ReviewDocument, ::Google::Cloud::DocumentAI::V1beta3::ReviewDocumentRequest, ::Google::Longrunning::Operation

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

@@ -0,0 +1,36 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/documentai/v1beta3/operation_metadata.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/documentai/v1beta3/operation_metadata.proto", :syntax => :proto3) do
+    add_message "google.cloud.documentai.v1beta3.CommonOperationMetadata" do
+      optional :state, :enum, 1, "google.cloud.documentai.v1beta3.CommonOperationMetadata.State"
+      optional :state_message, :string, 2
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+      optional :update_time, :message, 4, "google.protobuf.Timestamp"
+    end
+    add_enum "google.cloud.documentai.v1beta3.CommonOperationMetadata.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :RUNNING, 1
+      value :CANCELLING, 2
+      value :SUCCEEDED, 3
+      value :FAILED, 4
+      value :CANCELLED, 5
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module DocumentAI
+      module V1beta3
+        CommonOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.CommonOperationMetadata").msgclass
+        CommonOperationMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.CommonOperationMetadata.State").enummodule
+      end
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/documentai/v1beta3/processor.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/documentai/v1beta3/document_io_pb'
+require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/documentai/v1beta3/processor.proto", :syntax => :proto3) do
+    add_message "google.cloud.documentai.v1beta3.Processor" do
+      optional :name, :string, 1
+      optional :type, :string, 2
+      optional :display_name, :string, 3
+      optional :state, :enum, 4, "google.cloud.documentai.v1beta3.Processor.State"
+      optional :default_processor_version, :string, 9
+      optional :process_endpoint, :string, 6
+      optional :create_time, :message, 7, "google.protobuf.Timestamp"
+      optional :kms_key_name, :string, 8
+    end
+    add_enum "google.cloud.documentai.v1beta3.Processor.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :ENABLED, 1
+      value :DISABLED, 2
+      value :ENABLING, 3
+      value :DISABLING, 4
+      value :CREATING, 5
+      value :FAILED, 6
+      value :DELETING, 7
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module DocumentAI
+      module V1beta3
+        Processor = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Processor").msgclass
+        Processor::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.Processor.State").enummodule
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/documentai/v1beta3/processor_type.proto
+
+require 'google/protobuf'
+
+require 'google/api/resource_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/documentai/v1beta3/processor_type.proto", :syntax => :proto3) do
+    add_message "google.cloud.documentai.v1beta3.ProcessorType" do
+      optional :name, :string, 1
+      optional :type, :string, 2
+      optional :category, :string, 3
+      repeated :available_locations, :message, 4, "google.cloud.documentai.v1beta3.ProcessorType.LocationInfo"
+      optional :allow_creation, :bool, 6
+    end
+    add_message "google.cloud.documentai.v1beta3.ProcessorType.LocationInfo" do
+      optional :location_id, :string, 1
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module DocumentAI
+      module V1beta3
+        ProcessorType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ProcessorType").msgclass
+        ProcessorType::LocationInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1beta3.ProcessorType.LocationInfo").msgclass
+      end
+    end
+  end
+end

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # Denotes that a (repeated) field is an unordered list.
       # This indicates that the service may provide the elements of the list
-      # in any arbitrary order, rather than the order the user originally
+      # in any arbitrary  order, rather than the order the user originally
       # provided. Additionally, the list's order may or may not be stable.
       UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

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

@@ -28,14 +28,14 @@ module Google
         # optimize for quality.
         # @!attribute [rw] uri
         #   @return [::String]
-        #     Currently supports Google Cloud Storage URI of the form
+        #     Optional. Currently supports Google Cloud Storage URI of the form
         #        `gs://bucket_name/object_name`. Object versioning is not supported.
         #        See [Google Cloud Storage Request
         #        URIs](https://cloud.google.com/storage/docs/reference-uris) for more
         #        info.
         # @!attribute [rw] content
         #   @return [::String]
-        #     Inline document content, represented as a stream of bytes.
+        #     Optional. Inline document content, represented as a stream of bytes.
         #     Note: As with all `bytes` fields, protobuffers use a pure binary
         #     representation, whereas JSON representations use base64.
         # @!attribute [rw] mime_type
@@ -45,7 +45,7 @@ module Google
         #     https://www.iana.org/assignments/media-types/media-types.xhtml.
         # @!attribute [rw] text
         #   @return [::String]
-        #     UTF-8 encoded text in reading order from the document.
+        #     Optional. UTF-8 encoded text in reading order from the document.
         # @!attribute [rw] text_styles
         #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Document::Style>]
         #     Styles for the {::Google::Cloud::DocumentAI::V1beta3::Document#text Document.text}.
@@ -190,6 +190,9 @@ module Google
           # @!attribute [rw] form_fields
           #   @return [::Array<::Google::Cloud::DocumentAI::V1beta3::Document::Page::FormField>]
           #     A list of visually detected form fields on the page.
+          # @!attribute [rw] provenance
+          #   @return [::Google::Cloud::DocumentAI::V1beta3::Document::Provenance]
+          #     The history of this page.
           class Page
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -461,6 +464,9 @@ module Google
             #     - blank (this indicates the field_value is normal text)
             #     - "unfilled_checkbox"
             #     - "filled_checkbox"
+            # @!attribute [rw] provenance
+            #   @return [::Google::Cloud::DocumentAI::V1beta3::Document::Provenance]
+            #     The history of this annotation.
             class FormField
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -485,17 +491,17 @@ module Google
           # organization, or location.
           # @!attribute [rw] text_anchor
           #   @return [::Google::Cloud::DocumentAI::V1beta3::Document::TextAnchor]
-          #     Provenance of the entity.
+          #     Optional. Provenance of the entity.
           #     Text anchor indexing into the {::Google::Cloud::DocumentAI::V1beta3::Document#text Document.text}.
           # @!attribute [rw] type
           #   @return [::String]
           #     Entity type from a schema e.g. `Address`.
           # @!attribute [rw] mention_text
           #   @return [::String]
-          #     Text value in the document e.g. `1600 Amphitheatre Pkwy`.
+          #     Optional. Text value in the document e.g. `1600 Amphitheatre Pkwy`.
           # @!attribute [rw] mention_id
           #   @return [::String]
-          #     Deprecated.  Use `id` field instead.
+          #     Optional. Deprecated.  Use `id` field instead.
           # @!attribute [rw] confidence
           #   @return [::Float]
           #     Optional. Confidence of detected Schema entity. Range [0, 1].
@@ -531,27 +537,19 @@ module Google
             # @!attribute [rw] money_value
             #   @return [::Google::Type::Money]
             #     Money value. See also:
-            #
-            #     https:
-            #     github.com/googleapis/googleapis/blob/master/google/type/money.proto
+            #     https://github.com/googleapis/googleapis/blob/master/google/type/money.proto
             # @!attribute [rw] date_value
             #   @return [::Google::Type::Date]
             #     Date value. Includes year, month, day. See also:
-            #
-            #     https:
-            #     github.com/googleapis/googleapis/blob/master/google/type/date.proto
+            #     https://github.com/googleapis/googleapis/blob/master/google/type/date.proto
             # @!attribute [rw] datetime_value
             #   @return [::Google::Type::DateTime]
             #     DateTime value. Includes date, time, and timezone. See also:
-            #
-            #     https:
-            #     github.com/googleapis/googleapis/blob/master/google/type/datetime.proto
+            #     https://github.com/googleapis/googleapis/blob/master/google/type/datetime.proto
             # @!attribute [rw] address_value
             #   @return [::Google::Type::PostalAddress]
             #     Postal address. See also:
-            #
-            #     https:
-            #     github.com/googleapis/googleapis/blob/master/google/type/postal_address.proto
+            #     https://github.com/googleapis/googleapis/blob/master/google/type/postal_address.proto
             # @!attribute [rw] boolean_value
             #   @return [::Boolean]
             #     Boolean value. Can be used for entities with binary values, or for
@@ -629,6 +627,8 @@ module Google
             #   @return [::Integer]
             #     Required. Index into the {::Google::Cloud::DocumentAI::V1beta3::Document#pages Document.pages} element, for example using
             #     [Document.pages][page_refs.page] to locate the related page element.
+            #     This field is skipped when its value is the default 0. See
+            #     https://developers.google.com/protocol-buffers/docs/proto3#json.
             # @!attribute [rw] layout_type
             #   @return [::Google::Cloud::DocumentAI::V1beta3::Document::PageAnchor::PageRef::LayoutType]
             #     Optional. The type of the layout element that is being referenced if any.
@@ -638,6 +638,9 @@ module Google
             # @!attribute [rw] bounding_poly
             #   @return [::Google::Cloud::DocumentAI::V1beta3::BoundingPoly]
             #     Optional. Identifies the bounding polygon of a layout element on the page.
+            # @!attribute [rw] confidence
+            #   @return [::Float]
+            #     Optional. Confidence of detected page element, if applicable. Range [0, 1].
             class PageRef
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -696,6 +699,10 @@ module Google
             # @!attribute [rw] revision
             #   @return [::Integer]
             #     The index of the [Document.revisions] identifying the parent revision.
+            # @!attribute [rw] index
+            #   @return [::Integer]
+            #     The index of the parent revisions corresponding collection of items
+            #     (eg. list of entities, properties within entities, etc.)
             # @!attribute [rw] id
             #   @return [::Integer]
             #     The id of the parent provenance.
@@ -721,9 +728,12 @@ module Google
               # Element is requested for human review.
               EVAL_REQUESTED = 4
 
-              # Element is review and approved at human review, confidence will be set
-              # to 1.0
+              # Element is reviewed and approved at human review, confidence will be
+              # set to 1.0.
               EVAL_APPROVED = 5
+
+              # Element is skipped in the validation process.
+              EVAL_SKIPPED = 6
             end
           end