google-cloud-document_ai-v1 0.2.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24fbe2305962ad733b73b86b892f2cc056719f9b15ae68448b51af84f6f8e41e
-  data.tar.gz: 5ec64c940d4f4cee643127bcbf8574a87bceeebf170e2e329c9ba9d2ad9c28d2
+  metadata.gz: 562e387a9f1223223d1f86d8098518ae4182e5ecddaecb5c505f4d6b839925fb
+  data.tar.gz: 831dcae5c7bae6958388ede6eca2897a9aebe7f21dda4996fe70360072015f95
 SHA512:
-  metadata.gz: e0b706410acad88a8670fcd63053426d20a3de05d4aa97d1e573c583262af4bbe6394df875c26bcbe0c7e0cfa4550cf96988db55b1acbf8def5e9ac2e5b7eb30
-  data.tar.gz: 69bedf13c4c6362ca21903f79eafc347420b2222931a545679ecac9351e9df6dbb0224b09ae5ae2e87147028dbdc1e319a017910e3ae25a66e5ffb9bb9252d57
+  metadata.gz: 4c6b676f289b8221727d896f03af136309ac2ef9860773d3fc03f0a93bd9b40ffad204dbd5b44cf1c430f0247974aa754889b15d3d1c431a7a18fcf48bdae934
+  data.tar.gz: e98aebaebda84263d1b6bf788ccf105ac93d9948201f101016c6da1f998800953536c53b882e07754411fd321dc9d5a184be8004b68fec2b8e67bd403bd68724

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title=Document AI V1 API
+--title="Document AI V1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/AUTHENTICATION.md

@@ -120,15 +120,6 @@ To configure your system for this, simply:
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
 *should* only be used during development.
 
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
 ## Creating a Service Account
 
 Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
 [Google Cloud Platform environments](#google-cloud-platform-environments), you
 need a Google Developers service account.
 
-1. Visit the [Google Developers Console][dev-console].
+1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
 2. Create a new project or click on an existing project.
-3. Activate the slide-out navigation tray and select **API Manager**. From
+3. Activate the menu in the upper left and select **APIs & Services**. From
    here, you will enable the APIs that your application requires.
 
-   ![Enable the APIs that your application requires][enable-apis]
-
    *Note: You may need to enable billing in order to use these services.*
 
 4. Select **Credentials** from the side navigation.
 
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
+   Find the "Create credentials" drop down near the top of the page, and select
+   "Service account" to be guided through downloading a new JSON key file.
 
    If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
+   new key file. Just select the account you wish to re-use, click the pencil
+   tool on the right side to edit the service account, select the **Keys** tab,
+   and then select **Add Key**.
 
    The key file you download will be used by this library to authenticate API
    requests and should be stored in a secure location.

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::DocumentAI::V1::ProcessRequest.new # (request fields
 response = client.process_document request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-document_ai-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-document_ai-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/document-ai/)
@@ -69,16 +69,21 @@ module GRPC
 end
 ```
 
+
+## Google Cloud Samples
+
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
+
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.6+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.5
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
+in security maintenance, and not end of life. Older versions of Ruby _may_
+still work, but are unsupported and not recommended. See
+https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
+support schedule.
 
 ## Which client should I use?
 

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

@@ -153,6 +153,7 @@ module Google
 
               @operations_client = Operations.new do |config|
                 config.credentials = credentials
+                config.quota_project = @quota_project_id
                 config.endpoint = @config.endpoint
               end
 

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

@@ -95,6 +95,9 @@ module Google
                 channel_args: @config.channel_args,
                 interceptors: @config.interceptors
               )
+
+              # Used by an LRO wrapper for some methods of this service
+              @operations_client = self
             end
 
             # Service calls

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module DocumentAI
       module V1
-        VERSION = "0.2.3"
+        VERSION = "0.4.0"
       end
     end
   end

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

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/document_ai/v1"
       #     client = ::Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new
       #

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

@@ -1,7 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/documentai/v1/document_io.proto
 
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

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

@@ -1,6 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/documentai/v1/document.proto
 
+require 'google/protobuf'
+
 require 'google/api/field_behavior_pb'
 require 'google/cloud/documentai/v1/geometry_pb'
 require 'google/protobuf/timestamp_pb'
@@ -10,8 +12,6 @@ require 'google/type/date_pb'
 require 'google/type/datetime_pb'
 require 'google/type/money_pb'
 require 'google/type/postal_address_pb'
-require 'google/api/annotations_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/documentai/v1/document.proto", :syntax => :proto3) do
@@ -63,6 +63,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :visual_elements, :message, 9, "google.cloud.documentai.v1.Document.Page.VisualElement"
       repeated :tables, :message, 10, "google.cloud.documentai.v1.Document.Page.Table"
       repeated :form_fields, :message, 11, "google.cloud.documentai.v1.Document.Page.FormField"
+      repeated :symbols, :message, 12, "google.cloud.documentai.v1.Document.Page.Symbol"
       optional :provenance, :message, 16, "google.cloud.documentai.v1.Document.Provenance"
     end
     add_message "google.cloud.documentai.v1.Document.Page.Dimension" do
@@ -125,6 +126,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :WIDE_SPACE, 2
       value :HYPHEN, 3
     end
+    add_message "google.cloud.documentai.v1.Document.Page.Symbol" do
+      optional :layout, :message, 1, "google.cloud.documentai.v1.Document.Page.Layout"
+      repeated :detected_languages, :message, 2, "google.cloud.documentai.v1.Document.Page.DetectedLanguage"
+    end
     add_message "google.cloud.documentai.v1.Document.Page.VisualElement" do
       optional :layout, :message, 1, "google.cloud.documentai.v1.Document.Page.Layout"
       optional :type, :string, 2
@@ -275,6 +280,7 @@ module Google
         Document::Page::Token = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1.Document.Page.Token").msgclass
         Document::Page::Token::DetectedBreak = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1.Document.Page.Token.DetectedBreak").msgclass
         Document::Page::Token::DetectedBreak::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1.Document.Page.Token.DetectedBreak.Type").enummodule
+        Document::Page::Symbol = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1.Document.Page.Symbol").msgclass
         Document::Page::VisualElement = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1.Document.Page.VisualElement").msgclass
         Document::Page::Table = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1.Document.Page.Table").msgclass
         Document::Page::Table::TableRow = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.documentai.v1.Document.Page.Table.TableRow").msgclass

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

@@ -1,6 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/documentai/v1/document_processor_service.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -9,10 +11,8 @@ require 'google/cloud/documentai/v1/document_pb'
 require 'google/cloud/documentai/v1/document_io_pb'
 require 'google/cloud/documentai/v1/operation_metadata_pb'
 require 'google/longrunning/operations_pb'
-require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/documentai/v1/document_processor_service.proto", :syntax => :proto3) do
@@ -87,6 +87,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.documentai.v1.ReviewDocumentOperationMetadata" do
       optional :common_metadata, :message, 5, "google.cloud.documentai.v1.CommonOperationMetadata"
+      optional :question_id, :string, 6
     end
   end
 end

data/lib/google/cloud/documentai/v1/geometry_pb.rb

@@ -1,7 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/documentai/v1/geometry.proto
 
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

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

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/documentai/v1/operation_metadata.proto
 
-require 'google/protobuf/timestamp_pb'
-require 'google/api/annotations_pb'
 require 'google/protobuf'
 
+require 'google/protobuf/timestamp_pb'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/documentai/v1/operation_metadata.proto", :syntax => :proto3) do
     add_message "google.cloud.documentai.v1.CommonOperationMetadata" do

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of

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

@@ -54,11 +54,13 @@ module Google
         #     Visual page layout for the {::Google::Cloud::DocumentAI::V1::Document Document}.
         # @!attribute [rw] entities
         #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Entity>]
-        #     A list of entities detected on {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. For document shards,
-        #     entities in this list may cross shard boundaries.
+        #     A list of entities detected on
+        #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. For document
+        #     shards, entities in this list may cross shard boundaries.
         # @!attribute [rw] entity_relations
         #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::EntityRelation>]
-        #     Relationship among {::Google::Cloud::DocumentAI::V1::Document#entities Document.entities}.
+        #     Relationship among
+        #     {::Google::Cloud::DocumentAI::V1::Document#entities Document.entities}.
         # @!attribute [rw] text_changes
         #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::TextChange>]
         #     A list of text corrections made to [Document.text].  This is usually
@@ -89,7 +91,8 @@ module Google
           #     Total number of shards.
           # @!attribute [rw] text_offset
           #   @return [::Integer]
-          #     The index of the first character in {::Google::Cloud::DocumentAI::V1::Document#text Document.text} in the overall
+          #     The index of the first character in
+          #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text} in the overall
           #     document global text.
           class ShardInfo
             include ::Google::Protobuf::MessageExts
@@ -100,7 +103,8 @@ module Google
           # conventions as much as possible.
           # @!attribute [rw] text_anchor
           #   @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
-          #     Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
+          #     Text anchor indexing into the
+          #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
           # @!attribute [rw] color
           #   @return [::Google::Type::Color]
           #     Text color.
@@ -143,9 +147,11 @@ module Google
           # A page in a {::Google::Cloud::DocumentAI::V1::Document Document}.
           # @!attribute [rw] page_number
           #   @return [::Integer]
-          #     1-based index for current {::Google::Cloud::DocumentAI::V1::Document::Page Page} in a parent {::Google::Cloud::DocumentAI::V1::Document Document}.
-          #     Useful when a page is taken out of a {::Google::Cloud::DocumentAI::V1::Document Document} for individual
-          #     processing.
+          #     1-based index for current
+          #     {::Google::Cloud::DocumentAI::V1::Document::Page Page} in a parent
+          #     {::Google::Cloud::DocumentAI::V1::Document Document}. Useful when a page is
+          #     taken out of a {::Google::Cloud::DocumentAI::V1::Document Document} for
+          #     individual processing.
           # @!attribute [rw] image
           #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Image]
           #     Rendered image for this page. This image is preprocessed to remove any
@@ -190,6 +196,9 @@ module Google
           # @!attribute [rw] form_fields
           #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::FormField>]
           #     A list of visually detected form fields on the page.
+          # @!attribute [rw] symbols
+          #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::Symbol>]
+          #     A list of visually detected symbols on the page.
           # @!attribute [rw] provenance
           #   @return [::Google::Cloud::DocumentAI::V1::Document::Provenance]
           #     The history of this page.
@@ -255,18 +264,23 @@ module Google
             # Visual element describing a layout unit on a page.
             # @!attribute [rw] text_anchor
             #   @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
-            #     Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
+            #     Text anchor indexing into the
+            #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
             # @!attribute [rw] confidence
             #   @return [::Float]
-            #     Confidence of the current {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} within context of the object this
-            #     layout is for. e.g. confidence can be for a single token, a table,
-            #     a visual element, etc. depending on context. Range [0, 1].
+            #     Confidence of the current
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} within
+            #     context of the object this layout is for. e.g. confidence can be for a
+            #     single token, a table, a visual element, etc. depending on context.
+            #     Range [0, 1].
             # @!attribute [rw] bounding_poly
             #   @return [::Google::Cloud::DocumentAI::V1::BoundingPoly]
-            #     The bounding polygon for the {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
+            #     The bounding polygon for the
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
             # @!attribute [rw] orientation
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout::Orientation]
-            #     Detected orientation for the {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
+            #     Detected orientation for the
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout}.
             class Layout
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,7 +311,8 @@ module Google
             # common line-spacing and orientation.
             # @!attribute [rw] layout
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Block Block}.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Block Block}.
             # @!attribute [rw] detected_languages
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
             #     A list of detected languages together with confidence.
@@ -312,7 +327,8 @@ module Google
             # A collection of lines that a human would perceive as a paragraph.
             # @!attribute [rw] layout
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Paragraph Paragraph}.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Paragraph Paragraph}.
             # @!attribute [rw] detected_languages
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
             #     A list of detected languages together with confidence.
@@ -328,7 +344,8 @@ module Google
             # Does not cross column boundaries, can be horizontal, vertical, etc.
             # @!attribute [rw] layout
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Line Line}.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Line Line}.
             # @!attribute [rw] detected_languages
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
             #     A list of detected languages together with confidence.
@@ -343,10 +360,12 @@ module Google
             # A detected token.
             # @!attribute [rw] layout
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
             # @!attribute [rw] detected_break
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Token::DetectedBreak]
-            #     Detected break at the end of a {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
+            #     Detected break at the end of a
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
             # @!attribute [rw] detected_languages
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
             #     A list of detected languages together with confidence.
@@ -357,7 +376,8 @@ module Google
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
 
-              # Detected break at the end of a {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
+              # Detected break at the end of a
+              # {::Google::Cloud::DocumentAI::V1::Document::Page::Token Token}.
               # @!attribute [rw] type
               #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Token::DetectedBreak::Type]
               #     Detected break type.
@@ -382,14 +402,29 @@ module Google
               end
             end
 
+            # A detected symbol.
+            # @!attribute [rw] layout
+            #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Symbol Symbol}.
+            # @!attribute [rw] detected_languages
+            #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
+            #     A list of detected languages together with confidence.
+            class Symbol
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Detected non-text visual elements e.g. checkbox, signature etc. on the
             # page.
             # @!attribute [rw] layout
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
             # @!attribute [rw] type
             #   @return [::String]
-            #     Type of the {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
+            #     Type of the
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement VisualElement}.
             # @!attribute [rw] detected_languages
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
             #     A list of detected languages together with confidence.
@@ -401,7 +436,8 @@ module Google
             # A table representation similar to HTML table structure.
             # @!attribute [rw] layout
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Table Table}.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Table Table}.
             # @!attribute [rw] header_rows
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::Table::TableRow>]
             #     Header rows of the table.
@@ -427,7 +463,8 @@ module Google
               # A cell representation inside the table.
               # @!attribute [rw] layout
               #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-              #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for {::Google::Cloud::DocumentAI::V1::Document::Page::Table::TableCell TableCell}.
+              #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for
+              #     {::Google::Cloud::DocumentAI::V1::Document::Page::Table::TableCell TableCell}.
               # @!attribute [rw] row_span
               #   @return [::Integer]
               #     How many rows this cell spans.
@@ -446,11 +483,13 @@ module Google
             # A form field detected on the page.
             # @!attribute [rw] field_name
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} name. e.g. `Address`, `Email`,
-            #     `Grand total`, `Phone number`, etc.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} name.
+            #     e.g. `Address`, `Email`, `Grand total`, `Phone number`, etc.
             # @!attribute [rw] field_value
             #   @return [::Google::Cloud::DocumentAI::V1::Document::Page::Layout]
-            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} value.
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::Layout Layout} for the
+            #     {::Google::Cloud::DocumentAI::V1::Document::Page::FormField FormField} value.
             # @!attribute [rw] name_detected_languages
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::DetectedLanguage>]
             #     A list of detected languages for name together with confidence.
@@ -477,7 +516,7 @@ module Google
             #   @return [::String]
             #     The BCP-47 language code, such as "en-US" or "sr-Latn". For more
             #     information, see
-            #     http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+            #     https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
             # @!attribute [rw] confidence
             #   @return [::Float]
             #     Confidence of detected language. Range [0, 1].
@@ -487,18 +526,21 @@ module Google
             end
           end
 
-          # A phrase in the text that is a known entity type, such as a person, an
-          # organization, or location.
+          # An entity that could be a phrase in the text or a property that belongs to
+          # the document. It is a known entity type, such as a person, an organization,
+          # or location.
           # @!attribute [rw] text_anchor
           #   @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
           #     Optional. Provenance of the entity.
-          #     Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
+          #     Text anchor indexing into the
+          #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
           # @!attribute [rw] type
           #   @return [::String]
-          #     Entity type from a schema e.g. `Address`.
+          #     Required. Entity type from a schema e.g. `Address`.
           # @!attribute [rw] mention_text
           #   @return [::String]
-          #     Optional. Text value in the document e.g. `1600 Amphitheatre Pkwy`.
+          #     Optional. Text value in the document e.g. `1600 Amphitheatre Pkwy`. If
+          #     the entity is not present in the document, this field will be empty.
           # @!attribute [rw] mention_id
           #   @return [::String]
           #     Optional. Deprecated.  Use `id` field instead.
@@ -507,28 +549,29 @@ module Google
           #     Optional. Confidence of detected Schema entity. Range [0, 1].
           # @!attribute [rw] page_anchor
           #   @return [::Google::Cloud::DocumentAI::V1::Document::PageAnchor]
-          #     Optional. Represents the provenance of this entity wrt. the location on the
-          #     page where it was found.
+          #     Optional. Represents the provenance of this entity wrt. the location on
+          #     the page where it was found.
           # @!attribute [rw] id
           #   @return [::String]
           #     Optional. Canonical id. This will be a unique value in the entity list
           #     for this document.
           # @!attribute [rw] normalized_value
           #   @return [::Google::Cloud::DocumentAI::V1::Document::Entity::NormalizedValue]
-          #     Optional. Normalized entity value. Absent if the extracted value could not be
-          #     converted or the type (e.g. address) is not supported for certain
+          #     Optional. Normalized entity value. Absent if the extracted value could
+          #     not be converted or the type (e.g. address) is not supported for certain
           #     parsers. This field is also only populated for certain supported document
           #     types.
           # @!attribute [rw] properties
           #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Entity>]
-          #     Optional. Entities can be nested to form a hierarchical data structure representing
-          #     the content in the document.
+          #     Optional. Entities can be nested to form a hierarchical data structure
+          #     representing the content in the document.
           # @!attribute [rw] provenance
           #   @return [::Google::Cloud::DocumentAI::V1::Document::Provenance]
           #     Optional. The history of this annotation.
           # @!attribute [rw] redacted
           #   @return [::Boolean]
-          #     Optional. Whether the entity will be redacted for de-identification purposes.
+          #     Optional. Whether the entity will be redacted for de-identification
+          #     purposes.
           class Entity
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -556,10 +599,13 @@ module Google
             #     checkboxes.
             # @!attribute [rw] text
             #   @return [::String]
-            #     Required. Normalized entity value stored as a string. This field is populated for
-            #     supported document type (e.g. Invoice). For some entity types, one of
-            #     respective 'structured_value' fields may also be populated.
+            #     Optional. An optional field to store a normalized string.
+            #     For some entity types, one of respective `structured_value` fields may
+            #     also be populated. Also not all the types of `structured_value` will be
+            #     normalized. For example, some processors may not generate float
+            #     or int normalized text by default.
             #
+            #     Below are sample formats mapped to structured values.
             #     - Money/Currency type (`money_value`) is in the ISO 4217 text format.
             #     - Date type (`date_value`) is in the ISO 8601 text format.
             #     - Datetime type (`datetime_value`) is in the ISO 8601 text format.
@@ -569,7 +615,8 @@ module Google
             end
           end
 
-          # Relationship between {::Google::Cloud::DocumentAI::V1::Document::Entity Entities}.
+          # Relationship between
+          # {::Google::Cloud::DocumentAI::V1::Document::Entity Entities}.
           # @!attribute [rw] subject_id
           #   @return [::String]
           #     Subject entity id.
@@ -584,27 +631,35 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Text reference indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
+          # Text reference indexing into the
+          # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
           # @!attribute [rw] text_segments
           #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment>]
-          #     The text segments from the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
+          #     The text segments from the
+          #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
           # @!attribute [rw] content
           #   @return [::String]
           #     Contains the content of the text span so that users do
-          #     not have to look it up in the text_segments.
+          #     not have to look it up in the text_segments.  It is always
+          #     populated for formFields.
           class TextAnchor
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
-            # A text segment in the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. The indices may be out of bounds
-            # which indicate that the text extends into another document shard for
-            # large sharded documents. See {::Google::Cloud::DocumentAI::V1::Document::ShardInfo#text_offset ShardInfo.text_offset}
+            # A text segment in the
+            # {::Google::Cloud::DocumentAI::V1::Document#text Document.text}. The indices
+            # may be out of bounds which indicate that the text extends into another
+            # document shard for large sharded documents. See
+            # {::Google::Cloud::DocumentAI::V1::Document::ShardInfo#text_offset ShardInfo.text_offset}
             # @!attribute [rw] start_index
             #   @return [::Integer]
-            #     {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment} start UTF-8 char index in the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
+            #     {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment}
+            #     start UTF-8 char index in the
+            #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
             # @!attribute [rw] end_index
             #   @return [::Integer]
-            #     {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment} half open end UTF-8 char index in the
+            #     {::Google::Cloud::DocumentAI::V1::Document::TextAnchor::TextSegment TextSegment}
+            #     half open end UTF-8 char index in the
             #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
             class TextSegment
               include ::Google::Protobuf::MessageExts
@@ -612,9 +667,10 @@ module Google
             end
           end
 
-          # Referencing the visual context of the entity in the {::Google::Cloud::DocumentAI::V1::Document#pages Document.pages}.
-          # Page anchors can be cross-page, consist of multiple bounding polygons and
-          # optionally reference specific layout element types.
+          # Referencing the visual context of the entity in the
+          # {::Google::Cloud::DocumentAI::V1::Document#pages Document.pages}. Page anchors
+          # can be cross-page, consist of multiple bounding polygons and optionally
+          # reference specific layout element types.
           # @!attribute [rw] page_refs
           #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::PageAnchor::PageRef>]
           #     One or more references to visual page elements
@@ -625,22 +681,29 @@ module Google
             # Represents a weak reference to a page element within a document.
             # @!attribute [rw] page
             #   @return [::Integer]
-            #     Required. Index into the {::Google::Cloud::DocumentAI::V1::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
+            #     Required. Index into the
+            #     {::Google::Cloud::DocumentAI::V1::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::V1::Document::PageAnchor::PageRef::LayoutType]
-            #     Optional. The type of the layout element that is being referenced if any.
+            #     Optional. The type of the layout element that is being referenced if
+            #     any.
             # @!attribute [rw] layout_id
             #   @return [::String]
-            #     Optional. Deprecated.  Use {::Google::Cloud::DocumentAI::V1::Document::PageAnchor::PageRef#bounding_poly PageRef.bounding_poly} instead.
+            #     Optional. Deprecated.  Use
+            #     {::Google::Cloud::DocumentAI::V1::Document::PageAnchor::PageRef#bounding_poly PageRef.bounding_poly}
+            #     instead.
             # @!attribute [rw] bounding_poly
             #   @return [::Google::Cloud::DocumentAI::V1::BoundingPoly]
-            #     Optional. Identifies the bounding polygon of a layout element on the page.
+            #     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].
+            #     Optional. Confidence of detected page element, if applicable. Range [0,
+            #     1].
             class PageRef
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -650,25 +713,38 @@ module Google
                 # Layout Unspecified.
                 LAYOUT_TYPE_UNSPECIFIED = 0
 
-                # References a {::Google::Cloud::DocumentAI::V1::Document::Page#blocks Page.blocks} element.
+                # References a
+                # {::Google::Cloud::DocumentAI::V1::Document::Page#blocks Page.blocks}
+                # element.
                 BLOCK = 1
 
-                # References a {::Google::Cloud::DocumentAI::V1::Document::Page#paragraphs Page.paragraphs} element.
+                # References a
+                # {::Google::Cloud::DocumentAI::V1::Document::Page#paragraphs Page.paragraphs}
+                # element.
                 PARAGRAPH = 2
 
-                # References a {::Google::Cloud::DocumentAI::V1::Document::Page#lines Page.lines} element.
+                # References a
+                # {::Google::Cloud::DocumentAI::V1::Document::Page#lines Page.lines} element.
                 LINE = 3
 
-                # References a {::Google::Cloud::DocumentAI::V1::Document::Page#tokens Page.tokens} element.
+                # References a
+                # {::Google::Cloud::DocumentAI::V1::Document::Page#tokens Page.tokens}
+                # element.
                 TOKEN = 4
 
-                # References a {::Google::Cloud::DocumentAI::V1::Document::Page#visual_elements Page.visual_elements} element.
+                # References a
+                # {::Google::Cloud::DocumentAI::V1::Document::Page#visual_elements Page.visual_elements}
+                # element.
                 VISUAL_ELEMENT = 5
 
-                # Refrrences a {::Google::Cloud::DocumentAI::V1::Document::Page#tables Page.tables} element.
+                # Refrrences a
+                # {::Google::Cloud::DocumentAI::V1::Document::Page#tables Page.tables}
+                # element.
                 TABLE = 6
 
-                # References a {::Google::Cloud::DocumentAI::V1::Document::Page#form_fields Page.form_fields} element.
+                # References a
+                # {::Google::Cloud::DocumentAI::V1::Document::Page#form_fields Page.form_fields}
+                # element.
                 FORM_FIELD = 7
               end
             end
@@ -693,16 +769,15 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
-            # Structure for referencing parent provenances.  When an element replaces
-            # one of more other elements parent references identify the elements that
-            # are replaced.
+            # The parent element the current element is based on. Used for
+            # referencing/aligning, removal and replacement operations.
             # @!attribute [rw] revision
             #   @return [::Integer]
-            #     The index of the [Document.revisions] identifying the parent revision.
+            #     The index of the index into current revision's parent_ids list.
             # @!attribute [rw] index
             #   @return [::Integer]
-            #     The index of the parent revisions corresponding collection of items
-            #     (eg. list of entities, properties within entities, etc.)
+            #     The index of the parent item in the corresponding item list (eg. list
+            #     of entities, properties within entities, etc.) in the parent revision.
             # @!attribute [rw] id
             #   @return [::Integer]
             #     The id of the parent provenance.
@@ -713,19 +788,20 @@ module Google
 
             # If a processor or agent does an explicit operation on existing elements.
             module OperationType
-              # Operation type unspecified.
+              # Operation type unspecified. If no operation is specified a provenance
+              # entry is simply used to match against a `parent`.
               OPERATION_TYPE_UNSPECIFIED = 0
 
-              # Add an element.  Implicit if no `parents` are set for the provenance.
+              # Add an element.
               ADD = 1
 
-              # The element is removed.  No `parents` should be set.
+              # Remove an element identified by `parent`.
               REMOVE = 2
 
-              # Explicitly replaces the element(s) identified by `parents`.
+              # Replace an element identified by `parent`.
               REPLACE = 3
 
-              # Element is requested for human review.
+              # Request human review for the element identified by `parent`.
               EVAL_REQUESTED = 4
 
               # Element is reviewed and approved at human review, confidence will be
@@ -782,8 +858,9 @@ module Google
           # @!attribute [rw] text_anchor
           #   @return [::Google::Cloud::DocumentAI::V1::Document::TextAnchor]
           #     Provenance of the correction.
-          #     Text anchor indexing into the {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.  There can only be a
-          #     single `TextAnchor.text_segments` element.  If the start and
+          #     Text anchor indexing into the
+          #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.  There can
+          #     only be a single `TextAnchor.text_segments` element.  If the start and
           #     end index of the text segment are the same, the text change is inserted
           #     before that index.
           # @!attribute [rw] changed_text

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

@@ -227,6 +227,9 @@ module Google
         # @!attribute [rw] common_metadata
         #   @return [::Google::Cloud::DocumentAI::V1::CommonOperationMetadata]
         #     The basic metadata of the long running operation.
+        # @!attribute [rw] question_id
+        #   @return [::String]
+        #     The question ID.
         class ReviewDocumentOperationMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -44,7 +44,7 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
-    #  Example 3: Pack and unpack a message in Python.
+    # Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +54,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    #  Example 4: Pack and unpack a message in Go
+    # Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
     #
     #
     # JSON
-    # ====
+    #
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-document_ai-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.4.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2022-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,28 +50,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
 - !ruby/object:Gem::Dependency
   name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -196,7 +196,6 @@ files:
 - proto_docs/google/protobuf/any.rb
 - proto_docs/google/protobuf/duration.rb
 - proto_docs/google/protobuf/empty.rb
-- proto_docs/google/protobuf/field_mask.rb
 - proto_docs/google/protobuf/timestamp.rb
 - proto_docs/google/protobuf/wrappers.rb
 - proto_docs/google/rpc/status.rb
@@ -217,14 +216,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the Document AI V1 API

data/proto_docs/google/protobuf/field_mask.rb

@@ -1,229 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright 2021 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 Protobuf
-    # `FieldMask` represents a set of symbolic field paths, for example:
-    #
-    #     paths: "f.a"
-    #     paths: "f.b.d"
-    #
-    # Here `f` represents a field in some root message, `a` and `b`
-    # fields in the message found in `f`, and `d` a field found in the
-    # message in `f.b`.
-    #
-    # Field masks are used to specify a subset of fields that should be
-    # returned by a get operation or modified by an update operation.
-    # Field masks also have a custom JSON encoding (see below).
-    #
-    # # Field Masks in Projections
-    #
-    # When used in the context of a projection, a response message or
-    # sub-message is filtered by the API to only contain those fields as
-    # specified in the mask. For example, if the mask in the previous
-    # example is applied to a response message as follows:
-    #
-    #     f {
-    #       a : 22
-    #       b {
-    #         d : 1
-    #         x : 2
-    #       }
-    #       y : 13
-    #     }
-    #     z: 8
-    #
-    # The result will not contain specific values for fields x,y and z
-    # (their value will be set to the default, and omitted in proto text
-    # output):
-    #
-    #
-    #     f {
-    #       a : 22
-    #       b {
-    #         d : 1
-    #       }
-    #     }
-    #
-    # A repeated field is not allowed except at the last position of a
-    # paths string.
-    #
-    # If a FieldMask object is not present in a get operation, the
-    # operation applies to all fields (as if a FieldMask of all fields
-    # had been specified).
-    #
-    # Note that a field mask does not necessarily apply to the
-    # top-level response message. In case of a REST get operation, the
-    # field mask applies directly to the response, but in case of a REST
-    # list operation, the mask instead applies to each individual message
-    # in the returned resource list. In case of a REST custom method,
-    # other definitions may be used. Where the mask applies will be
-    # clearly documented together with its declaration in the API.  In
-    # any case, the effect on the returned resource/resources is required
-    # behavior for APIs.
-    #
-    # # Field Masks in Update Operations
-    #
-    # A field mask in update operations specifies which fields of the
-    # targeted resource are going to be updated. The API is required
-    # to only change the values of the fields as specified in the mask
-    # and leave the others untouched. If a resource is passed in to
-    # describe the updated values, the API ignores the values of all
-    # fields not covered by the mask.
-    #
-    # If a repeated field is specified for an update operation, new values will
-    # be appended to the existing repeated field in the target resource. Note that
-    # a repeated field is only allowed in the last position of a `paths` string.
-    #
-    # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then new value will be merged into the existing sub-message
-    # in the target resource.
-    #
-    # For example, given the target message:
-    #
-    #     f {
-    #       b {
-    #         d: 1
-    #         x: 2
-    #       }
-    #       c: [1]
-    #     }
-    #
-    # And an update message:
-    #
-    #     f {
-    #       b {
-    #         d: 10
-    #       }
-    #       c: [2]
-    #     }
-    #
-    # then if the field mask is:
-    #
-    #  paths: ["f.b", "f.c"]
-    #
-    # then the result will be:
-    #
-    #     f {
-    #       b {
-    #         d: 10
-    #         x: 2
-    #       }
-    #       c: [1, 2]
-    #     }
-    #
-    # An implementation may provide options to override this default behavior for
-    # repeated and message fields.
-    #
-    # In order to reset a field's value to the default, the field must
-    # be in the mask and set to the default value in the provided resource.
-    # Hence, in order to reset all fields of a resource, provide a default
-    # instance of the resource and set all fields in the mask, or do
-    # not provide a mask as described below.
-    #
-    # If a field mask is not present on update, the operation applies to
-    # all fields (as if a field mask of all fields has been specified).
-    # Note that in the presence of schema evolution, this may mean that
-    # fields the client does not know and has therefore not filled into
-    # the request will be reset to their default. If this is unwanted
-    # behavior, a specific service may require a client to always specify
-    # a field mask, producing an error if not.
-    #
-    # As with get operations, the location of the resource which
-    # describes the updated values in the request message depends on the
-    # operation kind. In any case, the effect of the field mask is
-    # required to be honored by the API.
-    #
-    # ## Considerations for HTTP REST
-    #
-    # The HTTP kind of an update operation which uses a field mask must
-    # be set to PATCH instead of PUT in order to satisfy HTTP semantics
-    # (PUT must only be used for full updates).
-    #
-    # # JSON Encoding of Field Masks
-    #
-    # In JSON, a field mask is encoded as a single string where paths are
-    # separated by a comma. Fields name in each path are converted
-    # to/from lower-camel naming conventions.
-    #
-    # As an example, consider the following message declarations:
-    #
-    #     message Profile {
-    #       User user = 1;
-    #       Photo photo = 2;
-    #     }
-    #     message User {
-    #       string display_name = 1;
-    #       string address = 2;
-    #     }
-    #
-    # In proto a field mask for `Profile` may look as such:
-    #
-    #     mask {
-    #       paths: "user.display_name"
-    #       paths: "photo"
-    #     }
-    #
-    # In JSON, the same mask is represented as below:
-    #
-    #     {
-    #       mask: "user.displayName,photo"
-    #     }
-    #
-    # # Field Masks and Oneof Fields
-    #
-    # Field masks treat fields in oneofs just as regular fields. Consider the
-    # following message:
-    #
-    #     message SampleMessage {
-    #       oneof test_oneof {
-    #         string name = 4;
-    #         SubMessage sub_message = 9;
-    #       }
-    #     }
-    #
-    # The field mask can be:
-    #
-    #     mask {
-    #       paths: "name"
-    #     }
-    #
-    # Or:
-    #
-    #     mask {
-    #       paths: "sub_message"
-    #     }
-    #
-    # Note that oneof type names ("test_oneof" in this case) cannot be used in
-    # paths.
-    #
-    # ## Field Mask Verification
-    #
-    # The implementation of any API method which has a FieldMask type field in the
-    # request should verify the included field paths, and return an
-    # `INVALID_ARGUMENT` error if any path is unmappable.
-    # @!attribute [rw] paths
-    #   @return [::Array<::String>]
-    #     The set of field mask paths.
-    class FieldMask
-      include ::Google::Protobuf::MessageExts
-      extend ::Google::Protobuf::MessageExts::ClassMethods
-    end
-  end
-end