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

…surface) (#1274) - [ ] Regenerate this pull request now. PiperOrigin-RevId: 527090049 Source-Link: https://togithub.com/googleapis/googleapis/commit/e2b7cb94f3e78df146a05744170353bc60c4ec21 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/b0d2cc1c48ddac1c5dbac1ce199d29eaf1c5ec0c Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjBkMmNjMWM0OGRkYWMxYzVkYmFjMWNlMTk5ZDI5ZWFmMWM1ZWMwYyJ9
googleapis · Apr 27, 2023 · 41909b7 · 41909b7
1 parent c983982
commit 41909b7
Show file tree

Hide file tree

Showing 13 changed files with 258 additions and 103 deletions.
diff --git a/google-cloud-firestore/src/main/java/com/google/cloud/firestore/v1/FirestoreClient.java b/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:
    *

diff --git a/grpc-google-cloud-firestore-v1/src/main/java/com/google/firestore/v1/FirestoreGrpc.java b/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(

diff --git a/...cloud-firestore-v1/src/main/java/com/google/firestore/v1/RunAggregationQueryResponse.java b/...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>

diff --git a/...estore-v1/src/main/java/com/google/firestore/v1/RunAggregationQueryResponseOrBuilder.java b/...estore-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>