feat(firestore): update the api

#### firestore:v1

The following keys were deleted:
- resources.projects.resources.databases.methods.delete.parameters.freeId (Total Keys: 2)

Author: yoshi-automation

docs/dyn/firestore_v1.projects.databases.documents.html

@@ -96,7 +96,7 @@ <h2>Instance Methods</h2>
   <code><a href="#create">create(parent, body=None, databaseId=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Create a database.</p>
 <p class="toc_element">
-  <code><a href="#delete">delete(name, allowMissing=None, etag=None, freeId=None, validateOnly=None, x__xgafv=None)</a></code></p>
+  <code><a href="#delete">delete(name, allowMissing=None, etag=None, validateOnly=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Deletes a database.</p>
 <p class="toc_element">
   <code><a href="#exportDocuments">exportDocuments(name, body=None, x__xgafv=None)</a></code></p>
@@ -141,7 +141,7 @@ <h3>Method Details</h3>
   &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp at which this database was most recently updated. Note this only includes updates to the database resource and not data contained by the database.
 }
 
-  databaseId: string, Required. The ID to use for the database, which will become the final component of the database&#x27;s resource name. This value should be 4-63 characters. Valid characters are /a-z-/ with first character a letter and the last a letter or a number. Must not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. &quot;(default)&quot; database id is also valid.
+  databaseId: string, Required. The ID to use for the database, which will become the final component of the database&#x27;s resource name. The value must be set to &quot;(default)&quot;.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -172,14 +172,13 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="delete">delete(name, allowMissing=None, etag=None, freeId=None, validateOnly=None, x__xgafv=None)</code>
+    <code class="details" id="delete">delete(name, allowMissing=None, etag=None, validateOnly=None, x__xgafv=None)</code>
   <pre>Deletes a database.
 
 Args:
   name: string, Required. A name of the form `projects/{project_id}/databases/{database_id}` (required)
   allowMissing: boolean, If set to true and the Database is not found, the request will succeed but no action will be taken.
   etag: string, The current etag of the Database. If an etag is provided and does not match the current etag of the database, deletion will be blocked and a FAILED_PRECONDITION error will be returned.
-  freeId: boolean, If set, will free the database_id associated with this database. uid will be used as the resource id to identify this deleted database.
   validateOnly: boolean, If set, validate the request and preview the response, but do not actually delete the database.
   x__xgafv: string, V1 error format.
     Allowed values

docs/dyn/firestore_v1.projects.databases.html

@@ -118,7 +118,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#listen">listen(database, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Listens to changes. This method is only available via the gRPC API (not REST).</p>
+<p class="firstline">Listens to changes. This method is only available via gRPC or WebChannel (not REST).</p>
 <p class="toc_element">
   <code><a href="#partitionQuery">partitionQuery(parent, body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Partitions a query by returning partition cursors that can be used to run the query in parallel. The returned partition cursors are split points that can be used by RunQuery as starting/end points for the query results.</p>
@@ -139,7 +139,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Runs a query.</p>
 <p class="toc_element">
   <code><a href="#write">write(database, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Streams batches of document updates and deletes, in order. This method is only available via the gRPC API (not REST).</p>
+<p class="firstline">Streams batches of document updates and deletes, in order. This method is only available via gRPC or WebChannel (not REST).</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="batchGet">batchGet(database, body=None, x__xgafv=None)</code>
@@ -1179,7 +1179,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="listen">listen(database, body=None, x__xgafv=None)</code>
-  <pre>Listens to changes. This method is only available via the gRPC API (not REST).
+  <pre>Listens to changes. This method is only available via gRPC or WebChannel (not REST).
 
 Args:
   database: string, Required. The database name. In the format: `projects/{project_id}/databases/{database_id}`. (required)
@@ -1242,7 +1242,7 @@ <h3>Method Details</h3>
             },
           },
         ],
-        &quot;select&quot;: { # The projection of document&#x27;s fields to return. # The projection to return.
+        &quot;select&quot;: { # The projection of document&#x27;s fields to return. # Optional sub-set of the fields to return. This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
           &quot;fields&quot;: [ # The fields to return. If empty, all fields are returned. To only return the name of the document, use `[&#x27;__name__&#x27;]`.
             { # A reference to a field in a document, ex: `stats.operations`.
               &quot;fieldPath&quot;: &quot;A String&quot;, # The relative path of the document being referenced. Requires: * Conform to document field name limitations.
@@ -1480,7 +1480,7 @@ <h3>Method Details</h3>
         },
       },
     ],
-    &quot;select&quot;: { # The projection of document&#x27;s fields to return. # The projection to return.
+    &quot;select&quot;: { # The projection of document&#x27;s fields to return. # Optional sub-set of the fields to return. This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
       &quot;fields&quot;: [ # The fields to return. If empty, all fields are returned. To only return the name of the document, use `[&#x27;__name__&#x27;]`.
         { # A reference to a field in a document, ex: `stats.operations`.
           &quot;fieldPath&quot;: &quot;A String&quot;, # The relative path of the document being referenced. Requires: * Conform to document field name limitations.
@@ -1806,7 +1806,7 @@ <h3>Method Details</h3>
           },
         },
       ],
-      &quot;select&quot;: { # The projection of document&#x27;s fields to return. # The projection to return.
+      &quot;select&quot;: { # The projection of document&#x27;s fields to return. # Optional sub-set of the fields to return. This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
         &quot;fields&quot;: [ # The fields to return. If empty, all fields are returned. To only return the name of the document, use `[&#x27;__name__&#x27;]`.
           { # A reference to a field in a document, ex: `stats.operations`.
             &quot;fieldPath&quot;: &quot;A String&quot;, # The relative path of the document being referenced. Requires: * Conform to document field name limitations.
@@ -1900,7 +1900,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The response for Firestore.RunAggregationQuery.
-  &quot;readTime&quot;: &quot;A String&quot;, # The time at which the aggregate value is valid for.
+  &quot;readTime&quot;: &quot;A String&quot;, # 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.
   &quot;result&quot;: { # The result of a single bucket from a Firestore aggregation query. The keys of `aggregate_fields` are the same for all results in an aggregation query, unlike document queries which can have different fields present for each result. # A single aggregation result. Not present when reporting partial progress.
     &quot;aggregateFields&quot;: { # The result of the aggregation functions, ex: `COUNT(*) AS total_docs`. The key is the alias assigned to the aggregation function on input and the size of this map equals the number of aggregation functions in the query.
       &quot;a_key&quot;: { # A message that can hold any of the supported value types.
@@ -1998,7 +1998,7 @@ <h3>Method Details</h3>
         },
       },
     ],
-    &quot;select&quot;: { # The projection of document&#x27;s fields to return. # The projection to return.
+    &quot;select&quot;: { # The projection of document&#x27;s fields to return. # Optional sub-set of the fields to return. This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
       &quot;fields&quot;: [ # The fields to return. If empty, all fields are returned. To only return the name of the document, use `[&#x27;__name__&#x27;]`.
         { # A reference to a field in a document, ex: `stats.operations`.
           &quot;fieldPath&quot;: &quot;A String&quot;, # The relative path of the document being referenced. Requires: * Conform to document field name limitations.
@@ -2131,7 +2131,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="write">write(database, body=None, x__xgafv=None)</code>
-  <pre>Streams batches of document updates and deletes, in order. This method is only available via the gRPC API (not REST).
+  <pre>Streams batches of document updates and deletes, in order. This method is only available via gRPC or WebChannel (not REST).
 
 Args:
   database: string, Required. The database name. In the format: `projects/{project_id}/databases/{database_id}`. This is only required in the first message. (required)

docs/dyn/firestore_v1beta1.projects.databases.documents.html

@@ -122,7 +122,7 @@
               ],
               "parameters": {
                 "databaseId": {
-                  "description": "Required. The ID to use for the database, which will become the final component of the database's resource name. This value should be 4-63 characters. Valid characters are /a-z-/ with first character a letter and the last a letter or a number. Must not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. \"(default)\" database id is also valid.",
+                  "description": "Required. The ID to use for the database, which will become the final component of the database's resource name. The value must be set to \"(default)\".",
                   "location": "query",
                   "type": "string"
                 },
@@ -165,11 +165,6 @@
                   "location": "query",
                   "type": "string"
                 },
-                "freeId": {
-                  "description": "If set, will free the database_id associated with this database. uid will be used as the resource id to identify this deleted database.",
-                  "location": "query",
-                  "type": "boolean"
-                },
                 "name": {
                   "description": "Required. A name of the form `projects/{project_id}/databases/{database_id}`",
                   "location": "path",
@@ -997,7 +992,7 @@
                   ]
                 },
                 "listen": {
-                  "description": "Listens to changes. This method is only available via the gRPC API (not REST).",
+                  "description": "Listens to changes. This method is only available via gRPC or WebChannel (not REST).",
                   "flatPath": "v1/projects/{projectsId}/databases/{databasesId}/documents:listen",
                   "httpMethod": "POST",
                   "id": "firestore.projects.databases.documents.listen",
@@ -1194,7 +1189,7 @@
                   ]
                 },
                 "write": {
-                  "description": "Streams batches of document updates and deletes, in order. This method is only available via the gRPC API (not REST).",
+                  "description": "Streams batches of document updates and deletes, in order. This method is only available via gRPC or WebChannel (not REST).",
                   "flatPath": "v1/projects/{projectsId}/databases/{databasesId}/documents:write",
                   "httpMethod": "POST",
                   "id": "firestore.projects.databases.documents.write",
@@ -1428,7 +1423,7 @@
       }
     }
   },
-  "revision": "20230214",
+  "revision": "20230228",
   "rootUrl": "https://firestore.googleapis.com/",
   "schemas": {
     "Aggregation": {
@@ -1664,11 +1659,13 @@
           "description": "The operator for combining multiple filters.",
           "enum": [
             "OPERATOR_UNSPECIFIED",
-            "AND"
+            "AND",
+            "OR"
           ],
           "enumDescriptions": [
             "Unspecified. This value must not be used.",
-            "Documents are required to satisfy all of the combined filters."
+            "Documents are required to satisfy all of the combined filters.",
+            "Documents are required to satisfy at least one of the combined filters."
           ],
           "type": "string"
         }
@@ -3118,7 +3115,7 @@
       "id": "RunAggregationQueryResponse",
       "properties": {
         "readTime": {
-          "description": "The time at which the aggregate value is valid for.",
+          "description": "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.",
           "format": "google-datetime",
           "type": "string"
         },
@@ -3268,7 +3265,7 @@
         },
         "select": {
           "$ref": "Projection",
-          "description": "The projection to return."
+          "description": "Optional sub-set of the fields to return. This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned."
         },
         "startAt": {
           "$ref": "Cursor",

googleapiclient/discovery_cache/documents/firestore.v1.json

@@ -592,7 +592,7 @@
                   ]
                 },
                 "listen": {
-                  "description": "Listens to changes. This method is only available via the gRPC API (not REST).",
+                  "description": "Listens to changes. This method is only available via gRPC or WebChannel (not REST).",
                   "flatPath": "v1beta1/projects/{projectsId}/databases/{databasesId}/documents:listen",
                   "httpMethod": "POST",
                   "id": "firestore.projects.databases.documents.listen",
@@ -789,7 +789,7 @@
                   ]
                 },
                 "write": {
-                  "description": "Streams batches of document updates and deletes, in order. This method is only available via the gRPC API (not REST).",
+                  "description": "Streams batches of document updates and deletes, in order. This method is only available via gRPC or WebChannel (not REST).",
                   "flatPath": "v1beta1/projects/{projectsId}/databases/{databasesId}/documents:write",
                   "httpMethod": "POST",
                   "id": "firestore.projects.databases.documents.write",
@@ -950,7 +950,7 @@
       }
     }
   },
-  "revision": "20230214",
+  "revision": "20230228",
   "rootUrl": "https://firestore.googleapis.com/",
   "schemas": {
     "Aggregation": {
@@ -1186,11 +1186,13 @@
           "description": "The operator for combining multiple filters.",
           "enum": [
             "OPERATOR_UNSPECIFIED",
-            "AND"
+            "AND",
+            "OR"
           ],
           "enumDescriptions": [
             "Unspecified. This value must not be used.",
-            "Documents are required to satisfy all of the combined filters."
+            "Documents are required to satisfy all of the combined filters.",
+            "Documents are required to satisfy at least one of the combined filters."
           ],
           "type": "string"
         }
@@ -2194,7 +2196,7 @@
       "id": "RunAggregationQueryResponse",
       "properties": {
         "readTime": {
-          "description": "The time at which the aggregate value is valid for.",
+          "description": "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.",
           "format": "google-datetime",
           "type": "string"
         },
@@ -2344,7 +2346,7 @@
         },
         "select": {
           "$ref": "Projection",
-          "description": "The projection to return."
+          "description": "Optional sub-set of the fields to return. This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned."
         },
         "startAt": {
           "$ref": "Cursor",

googleapiclient/discovery_cache/documents/firestore.v1beta1.json

@@ -415,7 +415,7 @@
       }
     }
   },
-  "revision": "20230214",
+  "revision": "20230228",
   "rootUrl": "https://firestore.googleapis.com/",
   "schemas": {
     "Empty": {