google-cloud-firestore-v1 0.10.0 → 0.11.0

data/proto_docs/google/api/client.rb

@@ -21,6 +21,7 @@ module Google
   module Api
     # Required information for every language.
     # @!attribute [rw] reference_docs_uri
+    #   @deprecated This field is deprecated and may be removed in the next major version update.
     #   @return [::String]
     #     Link to automatically generated reference documentation.  Example:
     #     https://cloud.google.com/nodejs/docs/reference/asset/latest
@@ -35,7 +36,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -81,7 +84,7 @@ module Google
     #     long-running operation pattern.
     # @!attribute [rw] new_issue_uri
     #   @return [::String]
-    #     Link to a place that API users can report issues.  Example:
+    #     Link to a *public* URI where users can report issues.  Example:
     #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
     # @!attribute [rw] documentation_uri
     #   @return [::String]
@@ -111,6 +114,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +210,57 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from original service names to renamed versions.
+    #     This is used when the default generated types
+    #     would cause a naming conflict. (Neither name is
+    #     fully-qualified.)
+    #     Example: Subscriber to SubscriberServiceApi.
+    # @!attribute [rw] renamed_resources
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from full resource types to the effective short name
+    #     for the resource. This is used when otherwise resource
+    #     named from different services would cause naming collisions.
+    #     Example entry:
+    #     "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
+    # @!attribute [rw] ignored_resources
+    #   @return [::Array<::String>]
+    #     List of full resource types to ignore during generation.
+    #     This is typically used for API-specific Location resources,
+    #     which should be handled by the generator as if they were actually
+    #     the common Location resources.
+    #     Example entry: "documentai.googleapis.com/Location"
+    # @!attribute [rw] forced_namespace_aliases
+    #   @return [::Array<::String>]
+    #     Namespaces which must be aliased in snippets due to
+    #     a known (but non-generator-predictable) naming collision
+    # @!attribute [rw] handwritten_signatures
+    #   @return [::Array<::String>]
+    #     Method signatures (in the form "service.method(signature)")
+    #     which are provided separately, so shouldn't be generated.
+    #     Snippets *calling* these methods are still generated, however.
     class DotnetSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedResourcesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Ruby client libraries.
@@ -240,8 +295,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute
@@ -250,6 +305,19 @@ module Google
     #                seconds: 360 # 6 minutes
     #              total_poll_timeout:
     #                 seconds: 54000 # 90 minutes
+    # @!attribute [rw] auto_populated_fields
+    #   @return [::Array<::String>]
+    #     List of top-level fields of the request message, that should be
+    #     automatically populated by the client libraries based on their
+    #     (google.api.field_info).format. Currently supported format: UUID4.
+    #
+    #     Example of a YAML configuration:
+    #
+    #      publishing:
+    #        method_settings:
+    #          - selector: google.example.v1.ExampleService.CreateExample
+    #            auto_populated_fields:
+    #            - request_id
     class MethodSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -299,6 +367,15 @@ module Google
 
       # Street View Org.
       STREET_VIEW = 4
+
+      # Shopping Org.
+      SHOPPING = 5
+
+      # Geo Org.
+      GEO = 6
+
+      # Generative AI - https://developers.generativeai.google
+      GENERATIVE_AI = 7
     end
 
     # To where should client libraries be published?

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

data/proto_docs/google/firestore/v1/bloom_filter.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Firestore
+      module V1
+        # A sequence of bits, encoded in a byte array.
+        #
+        # Each byte in the `bitmap` byte array stores 8 bits of the sequence. The only
+        # exception is the last byte, which may store 8 _or fewer_ bits. The `padding`
+        # defines the number of bits of the last byte to be ignored as "padding". The
+        # values of these "padding" bits are unspecified and must be ignored.
+        #
+        # To retrieve the first bit, bit 0, calculate: `(bitmap[0] & 0x01) != 0`.
+        # To retrieve the second bit, bit 1, calculate: `(bitmap[0] & 0x02) != 0`.
+        # To retrieve the third bit, bit 2, calculate: `(bitmap[0] & 0x04) != 0`.
+        # To retrieve the fourth bit, bit 3, calculate: `(bitmap[0] & 0x08) != 0`.
+        # To retrieve bit n, calculate: `(bitmap[n / 8] & (0x01 << (n % 8))) != 0`.
+        #
+        # The "size" of a `BitSequence` (the number of bits it contains) is calculated
+        # by this formula: `(bitmap.length * 8) - padding`.
+        # @!attribute [rw] bitmap
+        #   @return [::String]
+        #     The bytes that encode the bit sequence.
+        #     May have a length of zero.
+        # @!attribute [rw] padding
+        #   @return [::Integer]
+        #     The number of bits of the last byte in `bitmap` to ignore as "padding".
+        #     If the length of `bitmap` is zero, then this value must be `0`.
+        #     Otherwise, this value must be between 0 and 7, inclusive.
+        class BitSequence
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A bloom filter (https://en.wikipedia.org/wiki/Bloom_filter).
+        #
+        # The bloom filter hashes the entries with MD5 and treats the resulting 128-bit
+        # hash as 2 distinct 64-bit hash values, interpreted as unsigned integers
+        # using 2's complement encoding.
+        #
+        # These two hash values, named `h1` and `h2`, are then used to compute the
+        # `hash_count` hash values using the formula, starting at `i=0`:
+        #
+        #     h(i) = h1 + (i * h2)
+        #
+        # These resulting values are then taken modulo the number of bits in the bloom
+        # filter to get the bits of the bloom filter to test for the given entry.
+        # @!attribute [rw] bits
+        #   @return [::Google::Cloud::Firestore::V1::BitSequence]
+        #     The bloom filter data.
+        # @!attribute [rw] hash_count
+        #   @return [::Integer]
+        #     The number of hashes used by the algorithm.
+        class BloomFilter
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/firestore/v1/common.rb

@@ -63,6 +63,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Options for a transaction that can be used to read and write documents.
+          #
+          # Firestore does not allow 3rd party auth requests to create read-write.
+          # transactions.
           # @!attribute [rw] retry_transaction
           #   @return [::String]
           #     An optional transaction to retry.
@@ -75,7 +78,10 @@ module Google
           # @!attribute [rw] read_time
           #   @return [::Google::Protobuf::Timestamp]
           #     Reads documents at the given time.
-          #     This may not be older than 60 seconds.
+          #
+          #     This must be a microsecond precision timestamp within the past one
+          #     hour, or if Point-in-Time Recovery is enabled, can additionally be a
+          #     whole minute timestamp within the past 7 days.
           class ReadOnly
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/firestore/v1/document.rb

@@ -34,23 +34,23 @@ module Google
         #
         #     The map keys represent field names.
         #
-        #     A simple field name contains only characters `a` to `z`, `A` to `Z`,
-        #     `0` to `9`, or `_`, and must not start with `0` to `9`. For example,
-        #     `foo_bar_17`.
-        #
         #     Field names matching the regular expression `__.*__` are reserved. Reserved
-        #     field names are forbidden except in certain documented contexts. The map
-        #     keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be
+        #     field names are forbidden except in certain documented contexts. The field
+        #     names, represented as UTF-8, must not exceed 1,500 bytes and cannot be
         #     empty.
         #
         #     Field paths may be used in other contexts to refer to structured fields
-        #     defined here. For `map_value`, the field path is represented by the simple
-        #     or quoted field names of the containing fields, delimited by `.`. For
-        #     example, the structured field
-        #     `"foo" : { map_value: { "x&y" : { string_value: "hello" }}}` would be
-        #     represented by the field path `foo.x&y`.
+        #     defined here. For `map_value`, the field path is represented by a
+        #     dot-delimited (`.`) string of segments. Each segment is either a simple
+        #     field name (defined below) or a quoted field name. For example, the
+        #     structured field `"foo" : { map_value: { "x&y" : { string_value: "hello"
+        #     }}}` would be represented by the field path `` foo.`x&y` ``.
+        #
+        #     A simple field name contains only characters `a` to `z`, `A` to `Z`,
+        #     `0` to `9`, or `_`, and must not start with `0` to `9`. For example,
+        #     `foo_bar_17`.
         #
-        #     Within a field path, a quoted field name starts and ends with `` ` `` and
+        #     A quoted field name starts and ends with `` ` `` and
         #     may contain any character. Some characters, including `` ` ``, must be
         #     escaped using a `\`. For example, `` `x&y` `` represents `x&y` and
         #     `` `bak\`tik` `` represents `` bak`tik ``.

data/proto_docs/google/firestore/v1/firestore.rb

@@ -39,7 +39,10 @@ module Google
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Reads the version of the document at the given time.
-        #     This may not be older than 270 seconds.
+        #
+        #     This must be a microsecond precision timestamp within the past one hour,
+        #     or if Point-in-Time Recovery is enabled, can additionally be a whole
+        #     minute timestamp within the past 7 days.
         class GetDocumentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -98,7 +101,9 @@ module Google
         #   @return [::Google::Protobuf::Timestamp]
         #     Perform the read at the provided time.
         #
-        #     This may not be older than 270 seconds.
+        #     This must be a microsecond precision timestamp within the past one hour,
+        #     or if Point-in-Time Recovery is enabled, can additionally be a whole
+        #     minute timestamp within the past 7 days.
         # @!attribute [rw] show_missing
         #   @return [::Boolean]
         #     If the list should show missing documents.
@@ -235,7 +240,10 @@ module Google
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Reads documents as they were at the given time.
-        #     This may not be older than 270 seconds.
+        #
+        #     This must be a microsecond precision timestamp within the past one hour,
+        #     or if Point-in-Time Recovery is enabled, can additionally be a whole
+        #     minute timestamp within the past 7 days.
         class BatchGetDocumentsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -365,7 +373,10 @@ module Google
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Reads documents as they were at the given time.
-        #     This may not be older than 270 seconds.
+        #
+        #     This must be a microsecond precision timestamp within the past one hour,
+        #     or if Point-in-Time Recovery is enabled, can additionally be a whole
+        #     minute timestamp within the past 7 days.
         class RunQueryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -433,9 +444,9 @@ module Google
         #   @return [::Google::Protobuf::Timestamp]
         #     Executes the query at the given timestamp.
         #
-        #     Requires:
-        #
-        #     * Cannot be more than 270 seconds in the past.
+        #     This must be a microsecond precision timestamp within the past one hour,
+        #     or if Point-in-Time Recovery is enabled, can additionally be a whole
+        #     minute timestamp within the past 7 days.
         class RunAggregationQueryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -456,7 +467,14 @@ module Google
         #     a new transaction.
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The time at which the aggregate value is valid for.
+        #     The time at which the aggregate result was computed. This is always
+        #     monotonically increasing; in this case, the previous AggregationResult in
+        #     the result stream are guaranteed not to have changed between their
+        #     `read_time` and this one.
+        #
+        #     If the query returns no results, a response with `read_time` and no
+        #     `result` will be sent, and this represents the time at which the query
+        #     was run.
         class RunAggregationQueryResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -513,7 +531,10 @@ module Google
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Reads documents as they were at the given time.
-        #     This may not be older than 270 seconds.
+        #
+        #     This must be a microsecond precision timestamp within the past one hour,
+        #     or if Point-in-Time Recovery is enabled, can additionally be a whole
+        #     minute timestamp within the past 7 days.
         class PartitionQueryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -539,7 +560,7 @@ module Google
         #      * query, start_at B
         #
         #     An empty result may indicate that the query has too few results to be
-        #     partitioned.
+        #     partitioned, or that the query is not yet supported for partitioning.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     A page token that may be used to request an additional set of results, up
@@ -713,9 +734,32 @@ module Google
         #   @return [::Integer]
         #     The target ID that identifies the target on the stream. Must be a positive
         #     number and non-zero.
+        #
+        #     If `target_id` is 0 (or unspecified), the server will assign an ID for this
+        #     target and return that in a `TargetChange::ADD` event. Once a target with
+        #     `target_id=0` is added, all subsequent targets must also have
+        #     `target_id=0`. If an `AddTarget` request with `target_id != 0` is
+        #     sent to the server after a target with `target_id=0` is added, the server
+        #     will immediately send a response with a `TargetChange::Remove` event.
+        #
+        #     Note that if the client sends multiple `AddTarget` requests
+        #     without an ID, the order of IDs returned in `TargetChage.target_ids` are
+        #     undefined. Therefore, clients should provide a target ID instead of relying
+        #     on the server to assign one.
+        #
+        #     If `target_id` is non-zero, there must not be an existing active target on
+        #     this stream with the same ID.
         # @!attribute [rw] once
         #   @return [::Boolean]
         #     If the target should be removed once it is current and consistent.
+        # @!attribute [rw] expected_count
+        #   @return [::Google::Protobuf::Int32Value]
+        #     The number of documents that last matched the query at the resume token or
+        #     read time.
+        #
+        #     This value is only relevant when a `resume_type` is provided. This value
+        #     being present and greater than zero signals that the client wants
+        #     `ExistenceFilter.unchanged_names` to be included in the response.
         class Target
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -834,7 +878,10 @@ module Google
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Reads documents as they were at the given time.
-        #     This may not be older than 270 seconds.
+        #
+        #     This must be a microsecond precision timestamp within the past one hour,
+        #     or if Point-in-Time Recovery is enabled, can additionally be a whole
+        #     minute timestamp within the past 7 days.
         class ListCollectionIdsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/firestore/v1/query.rb

@@ -22,9 +22,21 @@ module Google
     module Firestore
       module V1
         # A Firestore query.
+        #
+        # The query stages are executed in the following order:
+        # 1. from
+        # 2. where
+        # 3. select
+        # 4. order_by + start_at + end_at
+        # 5. offset
+        # 6. limit
         # @!attribute [rw] select
         #   @return [::Google::Cloud::Firestore::V1::StructuredQuery::Projection]
-        #     The projection to return.
+        #     Optional sub-set of the fields to return.
+        #
+        #     This acts as a {::Google::Cloud::Firestore::V1::DocumentMask DocumentMask} over the
+        #     documents returned from a query. When not set, assumes that the caller
+        #     wants all fields returned.
         # @!attribute [rw] from
         #   @return [::Array<::Google::Cloud::Firestore::V1::StructuredQuery::CollectionSelector>]
         #     The collections to query.
@@ -243,8 +255,9 @@ module Google
               #
               # Requires:
               #
-              # * That `value` is a non-empty `ArrayValue` with at most 10 values.
-              # * No other `IN` or `ARRAY_CONTAINS_ANY` or `NOT_IN`.
+              # * That `value` is a non-empty `ArrayValue`, subject to disjunction
+              #   limits.
+              # * No `NOT_IN` filters in the same query.
               IN = 8
 
               # The given `field` is an array that contains any of the values in the
@@ -252,8 +265,10 @@ module Google
               #
               # Requires:
               #
-              # * That `value` is a non-empty `ArrayValue` with at most 10 values.
-              # * No other `IN` or `ARRAY_CONTAINS_ANY` or `NOT_IN`.
+              # * That `value` is a non-empty `ArrayValue`, subject to disjunction
+              #   limits.
+              # * No other `ARRAY_CONTAINS_ANY` filters within the same disjunction.
+              # * No `NOT_IN` filters in the same query.
               ARRAY_CONTAINS_ANY = 9
 
               # The value of the `field` is not in the given array.
@@ -261,7 +276,7 @@ module Google
               # Requires:
               #
               # * That `value` is a non-empty `ArrayValue` with at most 10 values.
-              # * No other `IN`, `ARRAY_CONTAINS_ANY`, `NOT_IN`, `NOT_EQUAL`,
+              # * No other `OR`, `IN`, `ARRAY_CONTAINS_ANY`, `NOT_IN`, `NOT_EQUAL`,
               #   `IS_NOT_NULL`, or `IS_NOT_NAN`.
               # * That `field` comes first in the `order_by`.
               NOT_IN = 10
@@ -323,11 +338,12 @@ module Google
           # A reference to a field in a document, ex: `stats.operations`.
           # @!attribute [rw] field_path
           #   @return [::String]
-          #     The relative path of the document being referenced.
+          #     A reference to a field in a document.
           #
           #     Requires:
           #
-          #     * Conform to {::Google::Cloud::Firestore::V1::Document#fields document field name}
+          #     * MUST be a dot-delimited (`.`) string of segments, where each segment
+          #     conforms to {::Google::Cloud::Firestore::V1::Document#fields document field name}
           #     limitations.
           class FieldReference
             include ::Google::Protobuf::MessageExts
@@ -376,10 +392,16 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Defines a aggregation that produces a single result.
+          # Defines an aggregation that produces a single result.
           # @!attribute [rw] count
           #   @return [::Google::Cloud::Firestore::V1::StructuredAggregationQuery::Aggregation::Count]
           #     Count aggregator.
+          # @!attribute [rw] sum
+          #   @return [::Google::Cloud::Firestore::V1::StructuredAggregationQuery::Aggregation::Sum]
+          #     Sum aggregator.
+          # @!attribute [rw] avg
+          #   @return [::Google::Cloud::Firestore::V1::StructuredAggregationQuery::Aggregation::Avg]
+          #     Average aggregator.
           # @!attribute [rw] alias
           #   @return [::String]
           #     Optional. Optional name of the field to store the result of the
@@ -393,7 +415,7 @@ module Google
           #       COUNT_UP_TO(1) AS count_up_to_1,
           #       COUNT_UP_TO(2),
           #       COUNT_UP_TO(3) AS count_up_to_3,
-          #       COUNT_UP_TO(4)
+          #       COUNT(*)
           #     OVER (
           #       ...
           #     );
@@ -406,7 +428,7 @@ module Google
           #       COUNT_UP_TO(1) AS count_up_to_1,
           #       COUNT_UP_TO(2) AS field_1,
           #       COUNT_UP_TO(3) AS count_up_to_3,
-          #       COUNT_UP_TO(4) AS field_2
+          #       COUNT(*) AS field_2
           #     OVER (
           #       ...
           #     );
@@ -431,7 +453,7 @@ module Google
             #     count.
             #
             #     This provides a way to set an upper bound on the number of documents
-            #     to scan, limiting latency and cost.
+            #     to scan, limiting latency, and cost.
             #
             #     Unspecified is interpreted as no bound.
             #
@@ -448,6 +470,54 @@ module Google
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # Sum of the values of the requested field.
+            #
+            # * Only numeric values will be aggregated. All non-numeric values
+            # including `NULL` are skipped.
+            #
+            # * If the aggregated values contain `NaN`, returns `NaN`. Infinity math
+            # follows IEEE-754 standards.
+            #
+            # * If the aggregated value set is empty, returns 0.
+            #
+            # * Returns a 64-bit integer if all aggregated numbers are integers and the
+            # sum result does not overflow. Otherwise, the result is returned as a
+            # double. Note that even if all the aggregated values are integers, the
+            # result is returned as a double if it cannot fit within a 64-bit signed
+            # integer. When this occurs, the returned value will lose precision.
+            #
+            # * When underflow occurs, floating-point aggregation is non-deterministic.
+            # This means that running the same query repeatedly without any changes to
+            # the underlying values could produce slightly different results each
+            # time. In those cases, values should be stored as integers over
+            # floating-point numbers.
+            # @!attribute [rw] field
+            #   @return [::Google::Cloud::Firestore::V1::StructuredQuery::FieldReference]
+            #     The field to aggregate on.
+            class Sum
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Average of the values of the requested field.
+            #
+            # * Only numeric values will be aggregated. All non-numeric values
+            # including `NULL` are skipped.
+            #
+            # * If the aggregated values contain `NaN`, returns `NaN`. Infinity math
+            # follows IEEE-754 standards.
+            #
+            # * If the aggregated value set is empty, returns `NULL`.
+            #
+            # * Always returns the result as a double.
+            # @!attribute [rw] field
+            #   @return [::Google::Cloud::Firestore::V1::StructuredQuery::FieldReference]
+            #     The field to aggregate on.
+            class Avg
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
         end
 

data/proto_docs/google/firestore/v1/write.rb

@@ -271,6 +271,24 @@ module Google
         #
         #     If different from the count of documents in the client that match, the
         #     client must manually determine which documents no longer match the target.
+        #
+        #     The client can use the `unchanged_names` bloom filter to assist with
+        #     this determination by testing ALL the document names against the filter;
+        #     if the document name is NOT in the filter, it means the document no
+        #     longer matches the target.
+        # @!attribute [rw] unchanged_names
+        #   @return [::Google::Cloud::Firestore::V1::BloomFilter]
+        #     A bloom filter that, despite its name, contains the UTF-8 byte encodings of
+        #     the resource names of ALL the documents that match
+        #     {::Google::Cloud::Firestore::V1::ExistenceFilter#target_id target_id}, in the form
+        #     `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+        #
+        #     This bloom filter may be omitted at the server's discretion, such as if it
+        #     is deemed that the client will not make use of it or if it is too
+        #     computationally expensive to calculate or transmit. Clients must gracefully
+        #     handle this field being absent by falling back to the logic used before
+        #     this field existed; that is, re-add the target without a resume token to
+        #     figure out which documents in the client's cache are out of sync.
         class ExistenceFilter
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,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)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # 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: