google-cloud-document_ai-v1 1.11.0 → 1.12.1

data/proto_docs/google/api/client.rb

@@ -31,6 +31,8 @@ module Google
     # @!attribute [rw] selective_gapic_generation
     #   @return [::Google::Api::SelectiveGapicGeneration]
     #     Configuration for which RPCs should be generated in the GAPIC client.
+    #
+    #     Note: This field should not be used in most cases.
     class CommonLanguageSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -141,9 +143,10 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        java_settings:
-    #          library_package: com.google.cloud.pubsub.v1
+    #         publishing:
+    #           library_settings:
+    #             java_settings:
+    #               library_package: com.google.cloud.pubsub.v1
     # @!attribute [rw] service_class_names
     #   @return [::Google::Protobuf::Map{::String => ::String}]
     #     Configure the Java class name to use instead of the service's for its
@@ -155,11 +158,11 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        java_settings:
-    #          service_class_names:
-    #            - google.pubsub.v1.Publisher: TopicAdmin
-    #            - google.pubsub.v1.Subscriber: SubscriptionAdmin
+    #         publishing:
+    #           java_settings:
+    #             service_class_names:
+    #               - google.pubsub.v1.Publisher: TopicAdmin
+    #               - google.pubsub.v1.Subscriber: SubscriptionAdmin
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
@@ -190,6 +193,20 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] library_package
+    #   @return [::String]
+    #     The package name to use in Php. Clobbers the php_namespace option
+    #     set in the protobuf. This should be used **only** by APIs
+    #     who have already set the language_settings.php.package_name" field
+    #     in gapic.yaml. API teams should use the protobuf php_namespace option
+    #     where possible.
+    #
+    #     Example of a YAML configuration::
+    #
+    #         publishing:
+    #           library_settings:
+    #             php_settings:
+    #               library_package: Google\Cloud\PubSub\V1
     class PhpSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -318,10 +335,12 @@ module Google
     #     service names and values are the name to be used for the service client
     #     and call options.
     #
-    #     publishing:
-    #       go_settings:
-    #         renamed_services:
-    #           Publisher: TopicAdmin
+    #     Example:
+    #
+    #         publishing:
+    #           go_settings:
+    #             renamed_services:
+    #               Publisher: TopicAdmin
     class GoSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -344,10 +363,10 @@ module Google
     #
     #     Example:
     #
-    #        publishing:
-    #          method_settings:
-    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
-    #            # method settings for CreateFolder...
+    #         publishing:
+    #           method_settings:
+    #           - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #             # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -356,14 +375,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #        publishing:
-    #          method_settings:
-    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
-    #            long_running:
-    #              initial_poll_delay: 60s # 1 minute
-    #              poll_delay_multiplier: 1.5
-    #              max_poll_delay: 360s # 6 minutes
-    #              total_poll_timeout: 54000s # 90 minutes
+    #         publishing:
+    #           method_settings:
+    #           - selector: google.cloud.speech.v2.Speech.BatchRecognize
+    #             long_running:
+    #               initial_poll_delay: 60s # 1 minute
+    #               poll_delay_multiplier: 1.5
+    #               max_poll_delay: 360s # 6 minutes
+    #               total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -372,11 +391,24 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #        publishing:
-    #          method_settings:
-    #          - selector: google.example.v1.ExampleService.CreateExample
-    #            auto_populated_fields:
-    #            - request_id
+    #         publishing:
+    #           method_settings:
+    #           - selector: google.example.v1.ExampleService.CreateExample
+    #             auto_populated_fields:
+    #             - request_id
+    # @!attribute [rw] batching
+    #   @return [::Google::Api::BatchingConfigProto]
+    #     Batching configuration for an API method in client libraries.
+    #
+    #     Example of a YAML configuration:
+    #
+    #         publishing:
+    #           method_settings:
+    #           - selector: google.example.v1.ExampleService.BatchCreateExample
+    #             batching:
+    #               element_count_threshold: 1000
+    #               request_byte_threshold: 100000000
+    #               delay_threshold_millis: 10
     class MethodSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -411,6 +443,8 @@ module Google
 
     # This message is used to configure the generation of a subset of the RPCs in
     # a service for client libraries.
+    #
+    # Note: This feature should not be used in most cases.
     # @!attribute [rw] methods
     #   @return [::Array<::String>]
     #     An allowlist of the fully qualified names of RPCs that should be included
@@ -428,6 +462,77 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
+    # `BatchingConfigProto` defines the batching configuration for an API method.
+    # @!attribute [rw] thresholds
+    #   @return [::Google::Api::BatchingSettingsProto]
+    #     The thresholds which trigger a batched request to be sent.
+    # @!attribute [rw] batch_descriptor
+    #   @return [::Google::Api::BatchingDescriptorProto]
+    #     The request and response fields used in batching.
+    class BatchingConfigProto
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # `BatchingSettingsProto` specifies a set of batching thresholds, each of
+    # which acts as a trigger to send a batch of messages as a request. At least
+    # one threshold must be positive nonzero.
+    # @!attribute [rw] element_count_threshold
+    #   @return [::Integer]
+    #     The number of elements of a field collected into a batch which, if
+    #     exceeded, causes the batch to be sent.
+    # @!attribute [rw] request_byte_threshold
+    #   @return [::Integer]
+    #     The aggregated size of the batched field which, if exceeded, causes the
+    #     batch to be sent. This size is computed by aggregating the sizes of the
+    #     request field to be batched, not of the entire request message.
+    # @!attribute [rw] delay_threshold
+    #   @return [::Google::Protobuf::Duration]
+    #     The duration after which a batch should be sent, starting from the addition
+    #     of the first message to that batch.
+    # @!attribute [rw] element_count_limit
+    #   @return [::Integer]
+    #     The maximum number of elements collected in a batch that could be accepted
+    #     by server.
+    # @!attribute [rw] request_byte_limit
+    #   @return [::Integer]
+    #     The maximum size of the request that could be accepted by server.
+    # @!attribute [rw] flow_control_element_limit
+    #   @return [::Integer]
+    #     The maximum number of elements allowed by flow control.
+    # @!attribute [rw] flow_control_byte_limit
+    #   @return [::Integer]
+    #     The maximum size of data allowed by flow control.
+    # @!attribute [rw] flow_control_limit_exceeded_behavior
+    #   @return [::Google::Api::FlowControlLimitExceededBehaviorProto]
+    #     The behavior to take when the flow control limit is exceeded.
+    class BatchingSettingsProto
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # `BatchingDescriptorProto` specifies the fields of the request message to be
+    # used for batching, and, optionally, the fields of the response message to be
+    # used for demultiplexing.
+    # @!attribute [rw] batched_field
+    #   @return [::String]
+    #     The repeated field in the request message to be aggregated by batching.
+    # @!attribute [rw] discriminator_fields
+    #   @return [::Array<::String>]
+    #     A list of the fields in the request message. Two requests will be batched
+    #     together only if the values of every field specified in
+    #     `request_discriminator_fields` is equal between the two requests.
+    # @!attribute [rw] subresponse_field
+    #   @return [::String]
+    #     Optional. When present, indicates the field in the response message to be
+    #     used to demultiplex the response into multiple response messages, in
+    #     correspondence with the multiple request messages originally batched
+    #     together.
+    class BatchingDescriptorProto
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # The organization for which the client libraries are being published.
     # Affects the url where generated docs are published, etc.
     module ClientLibraryOrganization
@@ -469,5 +574,20 @@ module Google
       # Publish the library to package managers like nuget.org and npmjs.com.
       PACKAGE_MANAGER = 20
     end
+
+    # The behavior to take when the flow control limit is exceeded.
+    module FlowControlLimitExceededBehaviorProto
+      # Default behavior, system-defined.
+      UNSET_BEHAVIOR = 0
+
+      # Stop operation, raise error.
+      THROW_EXCEPTION = 1
+
+      # Pause operation until limit clears.
+      BLOCK = 2
+
+      # Continue operation, disregard limit.
+      IGNORE = 3
+    end
   end
 end

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

@@ -88,6 +88,12 @@ module Google
         # @!attribute [rw] chunked_document
         #   @return [::Google::Cloud::DocumentAI::V1::Document::ChunkedDocument]
         #     Document chunked based on chunking config.
+        # @!attribute [rw] blob_assets
+        #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::BlobAsset>]
+        #     Optional. The blob assets in this document. This is used to store the
+        #     content of the inline blobs in this document, for example, image bytes,
+        #     such that it can be referenced by other fields in the document via asset
+        #     id.
         # @!attribute [rw] entity_validation_output
         #   @return [::Google::Cloud::DocumentAI::V1::Document::EntityValidationOutput]
         #     The entity validation output for the document. This is the validation
@@ -102,7 +108,7 @@ module Google
         #     The entity revision ID that `document.entities` field is based on.
         #     If this field is set and `entities_revisions` is not empty, the entities in
         #     `document.entities` field are the entities in the entity revision with this
-        #     ID and `document.entity_validation_output` field is the
+        #     id and `document.entity_validation_output` field is the
         #     `entity_validation_output` field in this entity revision.
         class Document
           include ::Google::Protobuf::MessageExts
@@ -222,7 +228,7 @@ module Google
           #     A list of visually detected tokens on the page.
           # @!attribute [rw] visual_elements
           #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::VisualElement>]
-          #     A list of detected non-text visual elements e.g. checkbox,
+          #     A list of detected non-text visual elements, for example, checkbox,
           #     signature etc. on the page.
           # @!attribute [rw] tables
           #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::Page::Table>]
@@ -313,9 +319,9 @@ module Google
             #   @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]`.
+            #     context of the object this layout is for. For example, 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
@@ -521,8 +527,8 @@ module Google
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
-            # Detected non-text visual elements e.g. checkbox, signature etc. on the
-            # page.
+            # Detected non-text visual elements, for example, 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
@@ -595,7 +601,7 @@ module Google
             #   @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.
+            #     For example, `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
@@ -705,10 +711,11 @@ module Google
           #     {::Google::Cloud::DocumentAI::V1::Document#text Document.text}.
           # @!attribute [rw] type
           #   @return [::String]
-          #     Required. Entity type from a schema e.g. `Address`.
+          #     Required. Entity type from a schema, for example, `Address`.
           # @!attribute [rw] mention_text
           #   @return [::String]
-          #     Optional. Text value of the entity e.g. `1600 Amphitheatre Pkwy`.
+          #     Optional. Text value of the entity, for example, `1600 Amphitheatre
+          #     Pkwy`.
           # @!attribute [rw] mention_id
           #   @return [::String]
           #     Optional. Deprecated.  Use `id` field instead.
@@ -726,9 +733,9 @@ module Google
           # @!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
-          #     parsers. This field is also only populated for certain supported document
-          #     types.
+          #     not be converted or the type (for example, 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
@@ -790,6 +797,9 @@ module Google
             #     Note: The following fields are mutually exclusive: `float_value`, `money_value`, `date_value`, `datetime_value`, `address_value`, `boolean_value`, `integer_value`, `signature_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] signature_value
             #   @return [::Boolean]
+            #     A signature - a graphical representation of a person's name,
+            #     often used to sign a document.
+            #
             #     Note: The following fields are mutually exclusive: `signature_value`, `money_value`, `date_value`, `datetime_value`, `address_value`, `boolean_value`, `integer_value`, `float_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] text
             #   @return [::String]
@@ -1076,7 +1086,7 @@ module Google
             # Human Review information of the document.
             # @!attribute [rw] state
             #   @return [::String]
-            #     Human review state. e.g. `requested`, `succeeded`, `rejected`.
+            #     Human review state. For example, `requested`, `succeeded`, `rejected`.
             # @!attribute [rw] state_message
             #   @return [::String]
             #     A message providing more details about the current state of processing.
@@ -1108,6 +1118,15 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Represents the annotation of a block or a chunk.
+          # @!attribute [rw] description
+          #   @return [::String]
+          #     The description of the content with this annotation.
+          class Annotations
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Represents the parsed layout of a document as a collection of blocks that
           # the document is divided into.
           # @!attribute [rw] blocks
@@ -1123,17 +1142,22 @@ module Google
             #   @return [::Google::Cloud::DocumentAI::V1::Document::DocumentLayout::DocumentLayoutBlock::LayoutTextBlock]
             #     Block consisting of text content.
             #
-            #     Note: The following fields are mutually exclusive: `text_block`, `table_block`, `list_block`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `text_block`, `table_block`, `list_block`, `image_block`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] table_block
             #   @return [::Google::Cloud::DocumentAI::V1::Document::DocumentLayout::DocumentLayoutBlock::LayoutTableBlock]
             #     Block consisting of table content/structure.
             #
-            #     Note: The following fields are mutually exclusive: `table_block`, `text_block`, `list_block`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `table_block`, `text_block`, `list_block`, `image_block`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] list_block
             #   @return [::Google::Cloud::DocumentAI::V1::Document::DocumentLayout::DocumentLayoutBlock::LayoutListBlock]
             #     Block consisting of list content/structure.
             #
-            #     Note: The following fields are mutually exclusive: `list_block`, `text_block`, `table_block`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            #     Note: The following fields are mutually exclusive: `list_block`, `text_block`, `table_block`, `image_block`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] image_block
+            #   @return [::Google::Cloud::DocumentAI::V1::Document::DocumentLayout::DocumentLayoutBlock::LayoutImageBlock]
+            #     Block consisting of image content.
+            #
+            #     Note: The following fields are mutually exclusive: `image_block`, `text_block`, `table_block`, `list_block`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] block_id
             #   @return [::String]
             #     ID of the block.
@@ -1172,6 +1196,9 @@ module Google
               #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::DocumentLayout::DocumentLayoutBlock>]
               #     A text block could further have child blocks.
               #     Repeated blocks support further hierarchies and nested blocks.
+              # @!attribute [rw] annotations
+              #   @return [::Google::Cloud::DocumentAI::V1::Document::Annotations]
+              #     Annotation of the text block.
               class LayoutTextBlock
                 include ::Google::Protobuf::MessageExts
                 extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1187,6 +1214,9 @@ module Google
               # @!attribute [rw] caption
               #   @return [::String]
               #     Table caption/title.
+              # @!attribute [rw] annotations
+              #   @return [::Google::Cloud::DocumentAI::V1::Document::Annotations]
+              #     Annotation of the table block.
               class LayoutTableBlock
                 include ::Google::Protobuf::MessageExts
                 extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1239,6 +1269,43 @@ module Google
                 include ::Google::Protobuf::MessageExts
                 extend ::Google::Protobuf::MessageExts::ClassMethods
               end
+
+              # Represents an image type block.
+              # @!attribute [rw] blob_asset_id
+              #   @return [::String]
+              #     Optional. Asset id of the inline image. If set, find the image
+              #     content in the blob_assets field.
+              #
+              #     Note: The following fields are mutually exclusive: `blob_asset_id`, `gcs_uri`, `data_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              # @!attribute [rw] gcs_uri
+              #   @return [::String]
+              #     Optional. Google Cloud Storage uri of the image.
+              #
+              #     Note: The following fields are mutually exclusive: `gcs_uri`, `blob_asset_id`, `data_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              # @!attribute [rw] data_uri
+              #   @return [::String]
+              #     Optional. Data uri of the image.
+              #     It is composed of four parts: a prefix (data:), a MIME type
+              #     indicating the type of data, an optional base64 token if
+              #     non-textual, and the data itself:
+              #     data:[<mediatype>][;base64],<data>
+              #
+              #     Note: The following fields are mutually exclusive: `data_uri`, `blob_asset_id`, `gcs_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              # @!attribute [rw] mime_type
+              #   @return [::String]
+              #     Mime type of the image. An IANA published [media type (MIME type)]
+              #     (https://www.iana.org/assignments/media-types/media-types.xhtml).
+              # @!attribute [rw] image_text
+              #   @return [::String]
+              #     Text extracted from the image using OCR or alt text describing the
+              #     image.
+              # @!attribute [rw] annotations
+              #   @return [::Google::Cloud::DocumentAI::V1::Document::Annotations]
+              #     Annotation of the image block.
+              class LayoutImageBlock
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
             end
           end
 
@@ -1269,6 +1336,9 @@ module Google
             # @!attribute [rw] page_footers
             #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::ChunkedDocument::Chunk::ChunkPageFooter>]
             #     Page footers associated with the chunk.
+            # @!attribute [rw] chunk_fields
+            #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::ChunkedDocument::Chunk::ChunkField>]
+            #     Chunk fields inside this chunk.
             class Chunk
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1308,9 +1378,83 @@ module Google
                 include ::Google::Protobuf::MessageExts
                 extend ::Google::Protobuf::MessageExts::ClassMethods
               end
+
+              # The image chunk field in the chunk.
+              # @!attribute [rw] blob_asset_id
+              #   @return [::String]
+              #     Optional. Asset id of the inline image. If set, find the image
+              #     content in the blob_assets field.
+              #
+              #     Note: The following fields are mutually exclusive: `blob_asset_id`, `gcs_uri`, `data_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              # @!attribute [rw] gcs_uri
+              #   @return [::String]
+              #     Optional. Google Cloud Storage uri of the image.
+              #
+              #     Note: The following fields are mutually exclusive: `gcs_uri`, `blob_asset_id`, `data_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              # @!attribute [rw] data_uri
+              #   @return [::String]
+              #     Optional. Data uri of the image.
+              #     It is composed of four parts: a prefix (data:), a MIME type
+              #     indicating the type of data, an optional base64 token if
+              #     non-textual, and the data itself:
+              #     data:[<mediatype>][;base64],<data>
+              #
+              #     Note: The following fields are mutually exclusive: `data_uri`, `blob_asset_id`, `gcs_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              # @!attribute [rw] annotations
+              #   @return [::Google::Cloud::DocumentAI::V1::Document::Annotations]
+              #     Annotation of the image chunk field.
+              class ImageChunkField
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # The table chunk field in the chunk.
+              # @!attribute [rw] annotations
+              #   @return [::Google::Cloud::DocumentAI::V1::Document::Annotations]
+              #     Annotation of the table chunk field.
+              class TableChunkField
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # The chunk field in the chunk. A chunk field could be one of the various
+              # types (for example, image, table) supported.
+              # @!attribute [rw] image_chunk_field
+              #   @return [::Google::Cloud::DocumentAI::V1::Document::ChunkedDocument::Chunk::ImageChunkField]
+              #     The image chunk field in the chunk.
+              #
+              #     Note: The following fields are mutually exclusive: `image_chunk_field`, `table_chunk_field`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              # @!attribute [rw] table_chunk_field
+              #   @return [::Google::Cloud::DocumentAI::V1::Document::ChunkedDocument::Chunk::TableChunkField]
+              #     The table chunk field in the chunk.
+              #
+              #     Note: The following fields are mutually exclusive: `table_chunk_field`, `image_chunk_field`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+              class ChunkField
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
             end
           end
 
+          # Represents a blob asset. It's used to store the content of the inline blob
+          # in this document, for example, image bytes, such that it can be referenced
+          # by other fields in the document via asset ID.
+          # @!attribute [rw] asset_id
+          #   @return [::String]
+          #     Optional. The id of the blob asset.
+          # @!attribute [rw] content
+          #   @return [::String]
+          #     Optional. The content of the blob asset, for example, image bytes.
+          # @!attribute [rw] mime_type
+          #   @return [::String]
+          #     The mime type of the blob asset.
+          #     An IANA published [media type (MIME
+          #     type)](https://www.iana.org/assignments/media-types/media-types.xhtml).
+          class BlobAsset
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The output of the validation given the document and the validation rules.
           # @!attribute [rw] validation_results
           #   @return [::Array<::Google::Cloud::DocumentAI::V1::Document::EntityValidationOutput::ValidationResult>]

data/proto_docs/google/protobuf/wrappers.rb

@@ -22,6 +22,9 @@ module Google
     # Wrapper message for `double`.
     #
     # The JSON representation for `DoubleValue` is JSON number.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::Float]
     #     The double value.
@@ -33,6 +36,9 @@ module Google
     # Wrapper message for `float`.
     #
     # The JSON representation for `FloatValue` is JSON number.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::Float]
     #     The float value.
@@ -44,6 +50,9 @@ module Google
     # Wrapper message for `int64`.
     #
     # The JSON representation for `Int64Value` is JSON string.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::Integer]
     #     The int64 value.
@@ -55,6 +64,9 @@ module Google
     # Wrapper message for `uint64`.
     #
     # The JSON representation for `UInt64Value` is JSON string.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::Integer]
     #     The uint64 value.
@@ -66,6 +78,9 @@ module Google
     # Wrapper message for `int32`.
     #
     # The JSON representation for `Int32Value` is JSON number.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::Integer]
     #     The int32 value.
@@ -77,6 +92,9 @@ module Google
     # Wrapper message for `uint32`.
     #
     # The JSON representation for `UInt32Value` is JSON number.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::Integer]
     #     The uint32 value.
@@ -88,6 +106,9 @@ module Google
     # Wrapper message for `bool`.
     #
     # The JSON representation for `BoolValue` is JSON `true` and `false`.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::Boolean]
     #     The bool value.
@@ -99,6 +120,9 @@ module Google
     # Wrapper message for `string`.
     #
     # The JSON representation for `StringValue` is JSON string.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::String]
     #     The string value.
@@ -110,6 +134,9 @@ module Google
     # Wrapper message for `bytes`.
     #
     # The JSON representation for `BytesValue` is JSON string.
+    #
+    # Not recommended for use in new APIs, but still useful for legacy APIs and
+    # has no plan to be removed.
     # @!attribute [rw] value
     #   @return [::String]
     #     The bytes value.

data/proto_docs/google/type/color.rb

@@ -20,22 +20,22 @@
 module Google
   module Type
     # Represents a color in the RGBA color space. This representation is designed
-    # for simplicity of conversion to/from color representations in various
+    # for simplicity of conversion to and from color representations in various
     # languages over compactness. For example, the fields of this representation
     # can be trivially provided to the constructor of `java.awt.Color` in Java; it
     # can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
     # method in iOS; and, with just a little work, it can be easily formatted into
     # a CSS `rgba()` string in JavaScript.
     #
-    # This reference page doesn't carry information about the absolute color
-    # space
-    # that should be used to interpret the RGB value (e.g. sRGB, Adobe RGB,
-    # DCI-P3, BT.2020, etc.). By default, applications should assume the sRGB color
+    # This reference page doesn't have information about the absolute color
+    # space that should be used to interpret the RGB value—for example, sRGB,
+    # Adobe RGB,
+    # DCI-P3, and BT.2020. By default, applications should assume the sRGB color
     # space.
     #
-    # When color equality needs to be decided, implementations, unless
-    # documented otherwise, treat two colors as equal if all their red,
-    # green, blue, and alpha values each differ by at most 1e-5.
+    # When color equality needs to be decided, implementations, unless documented
+    # otherwise, treat two colors as equal if all their red, green, blue, and alpha
+    # values each differ by at most `1e-5`.
     #
     # Example (Java):
     #