chore: regenerate firestore client (#18050)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-java-client-services/actions/workflows/codegen.yaml

clients/google-api-services-firestore/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-firestore</artifactId>
-      <version>v1-rev20230806-2.0.0</version>
+      <version>v1-rev20230905-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-firestore:v1-rev20230806-2.0.0'
+  implementation 'com.google.apis:google-api-services-firestore:v1-rev20230905-2.0.0'
 }
 ```
 

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/Firestore.java

@@ -1209,15 +1209,14 @@ public Patch set(String parameterName, Object value) {
         }
       }
       /**
-       * Create a new database by restore from an existing backup. The new database must be in the same
+       * Creates a new database by restoring from an existing backup. The new database must be in the same
        * cloud region or multi-region location as the existing backup. This behaves similar to
        * FirestoreAdmin.CreateDatabase except instead of creating a new empty database, a new database is
        * created with the database type, index configuration, and documents from an existing backup. The
        * long-running operation can be used to track the progress of the restore, with the Operation's
        * metadata field type being the RestoreDatabaseMetadata. The response type is the Database if the
        * restore was successful. The new database is not readable or writeable until the LRO has
-       * completed. Cancelling the returned operation will stop the restore and delete the in-progress
-       * database, if the restore is still active.
+       * completed.
        *
        * Create a request for the method "databases.restore".
        *
@@ -1242,15 +1241,14 @@ public class Restore extends FirestoreRequest<com.google.api.services.firestore.
             java.util.regex.Pattern.compile("^projects/[^/]+$");
 
         /**
-         * Create a new database by restore from an existing backup. The new database must be in the same
-         * cloud region or multi-region location as the existing backup. This behaves similar to
+         * Creates a new database by restoring from an existing backup. The new database must be in the
+         * same cloud region or multi-region location as the existing backup. This behaves similar to
          * FirestoreAdmin.CreateDatabase except instead of creating a new empty database, a new database
          * is created with the database type, index configuration, and documents from an existing backup.
          * The long-running operation can be used to track the progress of the restore, with the
          * Operation's metadata field type being the RestoreDatabaseMetadata. The response type is the
          * Database if the restore was successful. The new database is not readable or writeable until the
-         * LRO has completed. Cancelling the returned operation will stop the restore and delete the in-
-         * progress database, if the restore is still active.
+         * LRO has completed.
          *
          * Create a request for the method "databases.restore".
          *

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/model/Document.java

@@ -39,18 +39,6 @@ public final class Document extends com.google.api.client.json.GenericJson {
   private String createTime;
 
   /**
-   * The document's fields. 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 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" : { string_value: "hello" }}}`
-   * would be represented by the field path `foo.x`. Within a field path, a quoted field name starts
-   * and ends with `` ` `` and may contain any character. Some characters, including `` ` ``, must
-   * be escaped using a `\`. For example, `` `x` `` represents `x` and `` `bak\`tik` `` represents
-   * `` bak`tik ``.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -95,37 +83,13 @@ public Document setCreateTime(String createTime) {
   }
 
   /**
-   * The document's fields. 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 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" : { string_value: "hello" }}}`
-   * would be represented by the field path `foo.x`. Within a field path, a quoted field name starts
-   * and ends with `` ` `` and may contain any character. Some characters, including `` ` ``, must
-   * be escaped using a `\`. For example, `` `x` `` represents `x` and `` `bak\`tik` `` represents
-   * `` bak`tik ``.
    * @return value or {@code null} for none
    */
   public java.util.Map<String, Value> getFields() {
     return fields;
   }
 
   /**
-   * The document's fields. 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 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" : { string_value: "hello" }}}`
-   * would be represented by the field path `foo.x`. Within a field path, a quoted field name starts
-   * and ends with `` ` `` and may contain any character. Some characters, including `` ` ``, must
-   * be escaped using a `\`. For example, `` `x` `` represents `x` and `` `bak\`tik` `` represents
-   * `` bak`tik ``.
    * @param fields fields or {@code null} for none
    */
   public Document setFields(java.util.Map<String, Value> fields) {

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/model/FieldReference.java

@@ -30,25 +30,25 @@
 public final class FieldReference extends com.google.api.client.json.GenericJson {
 
   /**
-   * The relative path of the document being referenced. Requires: * Conform to document field name
-   * limitations.
+   * A reference to a field in a document. Requires: * MUST be a dot-delimited (`.`) string of
+   * segments, where each segment conforms to document field name limitations.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String fieldPath;
 
   /**
-   * The relative path of the document being referenced. Requires: * Conform to document field name
-   * limitations.
+   * A reference to a field in a document. Requires: * MUST be a dot-delimited (`.`) string of
+   * segments, where each segment conforms to document field name limitations.
    * @return value or {@code null} for none
    */
   public java.lang.String getFieldPath() {
     return fieldPath;
   }
 
   /**
-   * The relative path of the document being referenced. Requires: * Conform to document field name
-   * limitations.
+   * A reference to a field in a document. Requires: * MUST be a dot-delimited (`.`) string of
+   * segments, where each segment conforms to document field name limitations.
    * @param fieldPath fieldPath or {@code null} for none
    */
   public FieldReference setFieldPath(java.lang.String fieldPath) {

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/model/GoogleFirestoreAdminV1Backup.java

@@ -18,7 +18,7 @@
 
 /**
  * A Backup of a Cloud Firestore Database. The backup contains all documents and index
- * configurations for the given database at specific point in time.
+ * configurations for the given database at a specific point in time.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Firestore API. For a detailed explanation see:

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/model/GoogleFirestoreAdminV1CreateDatabaseMetadata.java

@@ -0,0 +1,42 @@
+/*
+ * 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
+ *
+ * http://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.
+ */
+/*
+ * This code was generated by https://github.com/googleapis/google-api-java-client-services/
+ * Modify at your own risk.
+ */
+
+package com.google.api.services.firestore.v1.model;
+
+/**
+ * Metadata related to the create database operation.
+ *
+ * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
+ * transmitted over HTTP when working with the Cloud Firestore API. For a detailed explanation see:
+ * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
+ * </p>
+ *
+ * @author Google, Inc.
+ */
+@SuppressWarnings("javadoc")
+public final class GoogleFirestoreAdminV1CreateDatabaseMetadata extends com.google.api.client.json.GenericJson {
+
+  @Override
+  public GoogleFirestoreAdminV1CreateDatabaseMetadata set(String fieldName, Object value) {
+    return (GoogleFirestoreAdminV1CreateDatabaseMetadata) super.set(fieldName, value);
+  }
+
+  @Override
+  public GoogleFirestoreAdminV1CreateDatabaseMetadata clone() {
+    return (GoogleFirestoreAdminV1CreateDatabaseMetadata) super.clone();
+  }
+
+}

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/model/GoogleFirestoreAdminV1Database.java

@@ -17,8 +17,7 @@
 package com.google.api.services.firestore.v1.model;
 
 /**
- * A Cloud Firestore Database. Currently only one database is allowed per cloud project; this
- * database must have a `database_id` of '(default)'.
+ * A Cloud Firestore Database.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Firestore API. For a detailed explanation see:

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/model/GoogleFirestoreAdminV1DeleteDatabaseMetadata.java

@@ -0,0 +1,42 @@
+/*
+ * 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
+ *
+ * http://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.
+ */
+/*
+ * This code was generated by https://github.com/googleapis/google-api-java-client-services/
+ * Modify at your own risk.
+ */
+
+package com.google.api.services.firestore.v1.model;
+
+/**
+ * Metadata related to the delete database operation.
+ *
+ * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
+ * transmitted over HTTP when working with the Cloud Firestore API. For a detailed explanation see:
+ * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
+ * </p>
+ *
+ * @author Google, Inc.
+ */
+@SuppressWarnings("javadoc")
+public final class GoogleFirestoreAdminV1DeleteDatabaseMetadata extends com.google.api.client.json.GenericJson {
+
+  @Override
+  public GoogleFirestoreAdminV1DeleteDatabaseMetadata set(String fieldName, Object value) {
+    return (GoogleFirestoreAdminV1DeleteDatabaseMetadata) super.set(fieldName, value);
+  }
+
+  @Override
+  public GoogleFirestoreAdminV1DeleteDatabaseMetadata clone() {
+    return (GoogleFirestoreAdminV1DeleteDatabaseMetadata) super.clone();
+  }
+
+}

clients/google-api-services-firestore/v1/2.0.0/com/google/api/services/firestore/v1/model/Target.java

@@ -78,6 +78,15 @@ public final class Target extends com.google.api.client.json.GenericJson {
 
   /**
    * 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.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -227,6 +236,15 @@ public Target encodeResumeToken(byte[] resumeToken) {
 
   /**
    * 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.
    * @return value or {@code null} for none
    */
   public java.lang.Integer getTargetId() {
@@ -235,6 +253,15 @@ public java.lang.Integer getTargetId() {
 
   /**
    * 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.
    * @param targetId targetId or {@code null} for none
    */
   public Target setTargetId(java.lang.Integer targetId) {

clients/google-api-services-firestore/v1/2.0.0/pom.xml

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-firestore</artifactId>
-  <version>v1-rev20230806-2.0.0</version>
-  <name>Cloud Firestore API v1-rev20230806-2.0.0</name>
+  <version>v1-rev20230905-2.0.0</version>
+  <name>Cloud Firestore API v1-rev20230905-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-firestore/v1beta1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-firestore</artifactId>
-      <version>v1beta1-rev20230806-2.0.0</version>
+      <version>v1beta1-rev20230905-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-firestore:v1beta1-rev20230806-2.0.0'
+  implementation 'com.google.apis:google-api-services-firestore:v1beta1-rev20230905-2.0.0'
 }
 ```