feat: Add bloom filter related proto fields (only in the preview API surface)

README.md

@@ -57,13 +57,13 @@ implementation 'com.google.cloud:google-cloud-firestore'
 If you are using Gradle without BOM, add this to your dependencies:
 
 ```Groovy
-implementation 'com.google.cloud:google-cloud-firestore:3.9.4'
+implementation 'com.google.cloud:google-cloud-firestore:3.9.5'
 ```
 
 If you are using SBT, add this to your dependencies:
 
 ```Scala
-libraryDependencies += "com.google.cloud" % "google-cloud-firestore" % "3.9.4"
+libraryDependencies += "com.google.cloud" % "google-cloud-firestore" % "3.9.5"
 ```
 <!-- {x-version-update-end} -->
 
@@ -222,7 +222,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-firestore/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-firestore.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-firestore/3.9.4
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-firestore/3.9.5
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

google-cloud-firestore/src/main/java/com/google/cloud/firestore/v1/FirestoreClient.java

@@ -1040,7 +1040,7 @@ public final PartitionQueryPagedResponse partitionQuery(PartitionQueryRequest re
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Streams batches of document updates and deletes, in order. This method is only available via
-   * the gRPC API (not REST).
+   * gRPC or WebChannel (not REST).
    *
    * <p>Sample code:
    *
@@ -1073,7 +1073,7 @@ public final BidiStreamingCallable<WriteRequest, WriteResponse> writeCallable()
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Listens to changes. This method is only available via the gRPC API (not REST).
+   * Listens to changes. This method is only available via gRPC or WebChannel (not REST).
    *
    * <p>Sample code:
    *

grpc-google-cloud-firestore-v1/src/main/java/com/google/firestore/v1/FirestoreGrpc.java

@@ -952,7 +952,7 @@ default void partitionQuery(
      *
      * <pre>
      * Streams batches of document updates and deletes, in order. This method is
-     * only available via the gRPC API (not REST).
+     * only available via gRPC or WebChannel (not REST).
      * </pre>
      */
     default io.grpc.stub.StreamObserver<com.google.firestore.v1.WriteRequest> write(
@@ -965,8 +965,8 @@ default io.grpc.stub.StreamObserver<com.google.firestore.v1.WriteRequest> write(
      *
      *
      * <pre>
-     * Listens to changes. This method is only available via the gRPC API (not
-     * REST).
+     * Listens to changes. This method is only available via gRPC or WebChannel
+     * (not REST).
      * </pre>
      */
     default io.grpc.stub.StreamObserver<com.google.firestore.v1.ListenRequest> listen(
@@ -1262,7 +1262,7 @@ public void partitionQuery(
      *
      * <pre>
      * Streams batches of document updates and deletes, in order. This method is
-     * only available via the gRPC API (not REST).
+     * only available via gRPC or WebChannel (not REST).
      * </pre>
      */
     public io.grpc.stub.StreamObserver<com.google.firestore.v1.WriteRequest> write(
@@ -1275,8 +1275,8 @@ public io.grpc.stub.StreamObserver<com.google.firestore.v1.WriteRequest> write(
      *
      *
      * <pre>
-     * Listens to changes. This method is only available via the gRPC API (not
-     * REST).
+     * Listens to changes. This method is only available via gRPC or WebChannel
+     * (not REST).
      * </pre>
      */
     public io.grpc.stub.StreamObserver<com.google.firestore.v1.ListenRequest> listen(

proto-google-cloud-firestore-v1/src/main/java/com/google/firestore/v1/RunAggregationQueryResponse.java

@@ -147,7 +147,13 @@ public com.google.protobuf.ByteString getTransaction() {
    *
    *
    * <pre>
-   * 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.
    * </pre>
    *
    * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -162,7 +168,13 @@ public boolean hasReadTime() {
    *
    *
    * <pre>
-   * 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.
    * </pre>
    *
    * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -177,7 +189,13 @@ public com.google.protobuf.Timestamp getReadTime() {
    *
    *
    * <pre>
-   * 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.
    * </pre>
    *
    * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -853,7 +871,13 @@ public Builder clearTransaction() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -867,7 +891,13 @@ public boolean hasReadTime() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -885,7 +915,13 @@ public com.google.protobuf.Timestamp getReadTime() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -907,7 +943,13 @@ public Builder setReadTime(com.google.protobuf.Timestamp value) {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -926,7 +968,13 @@ public Builder setReadTime(com.google.protobuf.Timestamp.Builder builderForValue
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -951,7 +999,13 @@ public Builder mergeReadTime(com.google.protobuf.Timestamp value) {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -970,7 +1024,13 @@ public Builder clearReadTime() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -984,7 +1044,13 @@ public com.google.protobuf.Timestamp.Builder getReadTimeBuilder() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -1000,7 +1066,13 @@ public com.google.protobuf.TimestampOrBuilder getReadTimeOrBuilder() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
      *
      * <code>.google.protobuf.Timestamp read_time = 3;</code>

proto-google-cloud-firestore-v1/src/main/java/com/google/firestore/v1/RunAggregationQueryResponseOrBuilder.java

@@ -80,7 +80,13 @@ public interface RunAggregationQueryResponseOrBuilder
    *
    *
    * <pre>
-   * 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.
    * </pre>
    *
    * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -92,7 +98,13 @@ public interface RunAggregationQueryResponseOrBuilder
    *
    *
    * <pre>
-   * 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.
    * </pre>
    *
    * <code>.google.protobuf.Timestamp read_time = 3;</code>
@@ -104,7 +116,13 @@ public interface RunAggregationQueryResponseOrBuilder
    *
    *
    * <pre>
-   * 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.
    * </pre>
    *
    * <code>.google.protobuf.Timestamp read_time = 3;</code>