feat(firestore): update the api

#### firestore:v1

The following keys were deleted:
- schemas.QueryPlan (Total Keys: 4)
- schemas.ResultSetStats (Total Keys: 5)
- schemas.RunAggregationQueryRequest.properties.mode.type (Total Keys: 1)
- schemas.RunAggregationQueryResponse.properties.stats.$ref (Total Keys: 1)
- schemas.RunQueryRequest.properties.mode.type (Total Keys: 1)
- schemas.RunQueryResponse.properties.stats.$ref (Total Keys: 1)

#### firestore:v1beta1

The following keys were deleted:
- schemas.QueryPlan (Total Keys: 4)
- schemas.ResultSetStats (Total Keys: 5)
- schemas.RunAggregationQueryRequest.properties.mode.type (Total Keys: 1)
- schemas.RunAggregationQueryResponse.properties.stats.$ref (Total Keys: 1)
- schemas.RunQueryRequest.properties.mode.type (Total Keys: 1)
- schemas.RunQueryResponse.properties.stats.$ref (Total Keys: 1)

Author: yoshi-automation

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

@@ -1750,7 +1750,6 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for Firestore.RunAggregationQuery.
-  &quot;mode&quot;: &quot;A String&quot;, # Optional. The mode in which the query request is processed. This field is optional, and when not provided, it defaults to `NORMAL` mode where no additional statistics will be returned with the query results.
   &quot;newTransaction&quot;: { # Options for creating a new transaction. # Starts a new transaction as part of the query, defaulting to read-only. The new transaction ID will be returned as the first response in the stream.
     &quot;readOnly&quot;: { # Options for a transaction that can only be used to read documents. # The transaction can only be used for read operations.
       &quot;readTime&quot;: &quot;A String&quot;, # Reads documents at the given time. 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.
@@ -1948,16 +1947,6 @@ <h3>Method Details</h3>
       },
     },
   },
-  &quot;stats&quot;: { # Planning and execution statistics for the query. # Query plan and execution statistics. Note that the returned stats are subject to change as Firestore evolves. This is only present when the request specifies a mode other than `NORMAL` and is sent only once with the last response in the stream.
-    &quot;queryPlan&quot;: { # Plan for the query. # Plan for the query.
-      &quot;planInfo&quot;: { # Planning phase information for the query. It will include: { &quot;indexes_used&quot;: [ {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(foo ASC, __name__ ASC)&quot;}, {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(bar ASC, __name__ ASC)&quot;} ] }
-        &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-      },
-    },
-    &quot;queryStats&quot;: { # Aggregated statistics from the execution of the query. This will only be present when the request specifies `PROFILE` mode. For example, a query will return the statistics including: { &quot;results_returned&quot;: &quot;20&quot;, &quot;documents_scanned&quot;: &quot;20&quot;, &quot;indexes_entries_scanned&quot;: &quot;10050&quot;, &quot;total_execution_time&quot;: &quot;100.7 msecs&quot; }
-      &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-    },
-  },
   &quot;transaction&quot;: &quot;A String&quot;, # The transaction that was started as part of this request. Only present on the first response when the request requested to start a new transaction.
 }</pre>
 </div>
@@ -1972,7 +1961,6 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for Firestore.RunQuery.
-  &quot;mode&quot;: &quot;A String&quot;, # Optional. The mode in which the query request is processed. This field is optional, and when not provided, it defaults to `NORMAL` mode where no additional statistics will be returned with the query results.
   &quot;newTransaction&quot;: { # Options for creating a new transaction. # Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
     &quot;readOnly&quot;: { # Options for a transaction that can only be used to read documents. # The transaction can only be used for read operations.
       &quot;readTime&quot;: &quot;A String&quot;, # Reads documents at the given time. 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.
@@ -2155,16 +2143,6 @@ <h3>Method Details</h3>
   &quot;done&quot;: True or False, # If present, Firestore has completely finished the request and no more documents will be returned.
   &quot;readTime&quot;: &quot;A String&quot;, # The time at which the document was read. This may be monotonically increasing; in this case, the previous documents 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 `document` will be sent, and this represents the time at which the query was run.
   &quot;skippedResults&quot;: 42, # The number of results that have been skipped due to an offset between the last response and the current response.
-  &quot;stats&quot;: { # Planning and execution statistics for the query. # Query plan and execution statistics. Note that the returned stats are subject to change as Firestore evolves. This is only present when the request specifies a mode other than `NORMAL` and is sent only once with the last response in the stream.
-    &quot;queryPlan&quot;: { # Plan for the query. # Plan for the query.
-      &quot;planInfo&quot;: { # Planning phase information for the query. It will include: { &quot;indexes_used&quot;: [ {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(foo ASC, __name__ ASC)&quot;}, {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(bar ASC, __name__ ASC)&quot;} ] }
-        &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-      },
-    },
-    &quot;queryStats&quot;: { # Aggregated statistics from the execution of the query. This will only be present when the request specifies `PROFILE` mode. For example, a query will return the statistics including: { &quot;results_returned&quot;: &quot;20&quot;, &quot;documents_scanned&quot;: &quot;20&quot;, &quot;indexes_entries_scanned&quot;: &quot;10050&quot;, &quot;total_execution_time&quot;: &quot;100.7 msecs&quot; }
-      &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-    },
-  },
   &quot;transaction&quot;: &quot;A String&quot;, # The transaction that was started as part of this request. Can only be set in the first response, and only if RunQueryRequest.new_transaction was set in the request. If set, no other fields will be set in this response.
 }</pre>
 </div>

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

@@ -1750,7 +1750,6 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for Firestore.RunAggregationQuery.
-  &quot;mode&quot;: &quot;A String&quot;, # Optional. The mode in which the query request is processed. This field is optional, and when not provided, it defaults to `NORMAL` mode where no additional statistics will be returned with the query results.
   &quot;newTransaction&quot;: { # Options for creating a new transaction. # Starts a new transaction as part of the query, defaulting to read-only. The new transaction ID will be returned as the first response in the stream.
     &quot;readOnly&quot;: { # Options for a transaction that can only be used to read documents. # The transaction can only be used for read operations.
       &quot;readTime&quot;: &quot;A String&quot;, # Reads documents at the given time. 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.
@@ -1948,16 +1947,6 @@ <h3>Method Details</h3>
       },
     },
   },
-  &quot;stats&quot;: { # Planning and execution statistics for the query. # Query plan and execution statistics. Note that the returned stats are subject to change as Firestore evolves. This is only present when the request specifies a mode other than `NORMAL` and is sent only once with the last response in the stream.
-    &quot;queryPlan&quot;: { # Plan for the query. # Plan for the query.
-      &quot;planInfo&quot;: { # Planning phase information for the query. It will include: { &quot;indexes_used&quot;: [ {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(foo ASC, __name__ ASC)&quot;}, {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(bar ASC, __name__ ASC)&quot;} ] }
-        &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-      },
-    },
-    &quot;queryStats&quot;: { # Aggregated statistics from the execution of the query. This will only be present when the request specifies `PROFILE` mode. For example, a query will return the statistics including: { &quot;results_returned&quot;: &quot;20&quot;, &quot;documents_scanned&quot;: &quot;20&quot;, &quot;indexes_entries_scanned&quot;: &quot;10050&quot;, &quot;total_execution_time&quot;: &quot;100.7 msecs&quot; }
-      &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-    },
-  },
   &quot;transaction&quot;: &quot;A String&quot;, # The transaction that was started as part of this request. Only present on the first response when the request requested to start a new transaction.
 }</pre>
 </div>
@@ -1972,7 +1961,6 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for Firestore.RunQuery.
-  &quot;mode&quot;: &quot;A String&quot;, # Optional. The mode in which the query request is processed. This field is optional, and when not provided, it defaults to `NORMAL` mode where no additional statistics will be returned with the query results.
   &quot;newTransaction&quot;: { # Options for creating a new transaction. # Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
     &quot;readOnly&quot;: { # Options for a transaction that can only be used to read documents. # The transaction can only be used for read operations.
       &quot;readTime&quot;: &quot;A String&quot;, # Reads documents at the given time. 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.
@@ -2155,16 +2143,6 @@ <h3>Method Details</h3>
   &quot;done&quot;: True or False, # If present, Firestore has completely finished the request and no more documents will be returned.
   &quot;readTime&quot;: &quot;A String&quot;, # The time at which the document was read. This may be monotonically increasing; in this case, the previous documents 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 `document` will be sent, and this represents the time at which the query was run.
   &quot;skippedResults&quot;: 42, # The number of results that have been skipped due to an offset between the last response and the current response.
-  &quot;stats&quot;: { # Planning and execution statistics for the query. # Query plan and execution statistics. Note that the returned stats are subject to change as Firestore evolves. This is only present when the request specifies a mode other than `NORMAL` and is sent only once with the last response in the stream.
-    &quot;queryPlan&quot;: { # Plan for the query. # Plan for the query.
-      &quot;planInfo&quot;: { # Planning phase information for the query. It will include: { &quot;indexes_used&quot;: [ {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(foo ASC, __name__ ASC)&quot;}, {&quot;query_scope&quot;: &quot;Collection&quot;, &quot;properties&quot;: &quot;(bar ASC, __name__ ASC)&quot;} ] }
-        &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-      },
-    },
-    &quot;queryStats&quot;: { # Aggregated statistics from the execution of the query. This will only be present when the request specifies `PROFILE` mode. For example, a query will return the statistics including: { &quot;results_returned&quot;: &quot;20&quot;, &quot;documents_scanned&quot;: &quot;20&quot;, &quot;indexes_entries_scanned&quot;: &quot;10050&quot;, &quot;total_execution_time&quot;: &quot;100.7 msecs&quot; }
-      &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
-    },
-  },
   &quot;transaction&quot;: &quot;A String&quot;, # The transaction that was started as part of this request. Can only be set in the first response, and only if RunQueryRequest.new_transaction was set in the request. If set, no other fields will be set in this response.
 }</pre>
 </div>

googleapiclient/discovery_cache/documents/firestore.v1.json

@@ -1672,7 +1672,7 @@
 }
 }
 },
-"revision": "20240117",
+"revision": "20240131",
 "rootUrl": "https://firestore.googleapis.com/",
 "schemas": {
 "Aggregation": {
@@ -3712,21 +3712,6 @@
 },
 "type": "object"
 },
-"QueryPlan": {
-"description": "Plan for the query.",
-"id": "QueryPlan",
-"properties": {
-"planInfo": {
-"additionalProperties": {
-"description": "Properties of the object.",
-"type": "any"
-},
-"description": "Planning phase information for the query. It will include: { \"indexes_used\": [ {\"query_scope\": \"Collection\", \"properties\": \"(foo ASC, __name__ ASC)\"}, {\"query_scope\": \"Collection\", \"properties\": \"(bar ASC, __name__ ASC)\"} ] }",
-"type": "object"
-}
-},
-"type": "object"
-},
 "QueryTarget": {
 "description": "A target specified by a query.",
 "id": "QueryTarget",
@@ -3766,25 +3751,6 @@
 },
 "type": "object"
 },
-"ResultSetStats": {
-"description": "Planning and execution statistics for the query.",
-"id": "ResultSetStats",
-"properties": {
-"queryPlan": {
-"$ref": "QueryPlan",
-"description": "Plan for the query."
-},
-"queryStats": {
-"additionalProperties": {
-"description": "Properties of the object.",
-"type": "any"
-},
-"description": "Aggregated statistics from the execution of the query. This will only be present when the request specifies `PROFILE` mode. For example, a query will return the statistics including: { \"results_returned\": \"20\", \"documents_scanned\": \"20\", \"indexes_entries_scanned\": \"10050\", \"total_execution_time\": \"100.7 msecs\" }",
-"type": "object"
-}
-},
-"type": "object"
-},
 "RollbackRequest": {
 "description": "The request for Firestore.Rollback.",
 "id": "RollbackRequest",
@@ -3801,20 +3767,6 @@
 "description": "The request for Firestore.RunAggregationQuery.",
 "id": "RunAggregationQueryRequest",
 "properties": {
-"mode": {
-"description": "Optional. The mode in which the query request is processed. This field is optional, and when not provided, it defaults to `NORMAL` mode where no additional statistics will be returned with the query results.",
-"enum": [
-"NORMAL",
-"PLAN",
-"PROFILE"
-],
-"enumDescriptions": [
-"The default mode. Only the query results are returned.",
-"This mode returns only the query plan, without any results or execution statistics information.",
-"This mode returns both the query plan and the execution statistics along with the results."
-],
-"type": "string"
-},
 "newTransaction": {
 "$ref": "TransactionOptions",
 "description": "Starts a new transaction as part of the query, defaulting to read-only. The new transaction ID will be returned as the first response in the stream."
@@ -3849,10 +3801,6 @@
 "$ref": "AggregationResult",
 "description": "A single aggregation result. Not present when reporting partial progress."
 },
-"stats": {
-"$ref": "ResultSetStats",
-"description": "Query plan and execution statistics. Note that the returned stats are subject to change as Firestore evolves. This is only present when the request specifies a mode other than `NORMAL` and is sent only once with the last response in the stream."
-},
 "transaction": {
 "description": "The transaction that was started as part of this request. Only present on the first response when the request requested to start a new transaction.",
 "format": "byte",
@@ -3865,20 +3813,6 @@
 "description": "The request for Firestore.RunQuery.",
 "id": "RunQueryRequest",
 "properties": {
-"mode": {
-"description": "Optional. The mode in which the query request is processed. This field is optional, and when not provided, it defaults to `NORMAL` mode where no additional statistics will be returned with the query results.",
-"enum": [
-"NORMAL",
-"PLAN",
-"PROFILE"
-],
-"enumDescriptions": [
-"The default mode. Only the query results are returned.",
-"This mode returns only the query plan, without any results or execution statistics information.",
-"This mode returns both the query plan and the execution statistics along with the results."
-],
-"type": "string"
-},
 "newTransaction": {
 "$ref": "TransactionOptions",
 "description": "Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream."
@@ -3922,10 +3856,6 @@
 "format": "int32",
 "type": "integer"
 },
-"stats": {
-"$ref": "ResultSetStats",
-"description": "Query plan and execution statistics. Note that the returned stats are subject to change as Firestore evolves. This is only present when the request specifies a mode other than `NORMAL` and is sent only once with the last response in the stream."
-},
 "transaction": {
 "description": "The transaction that was started as part of this request. Can only be set in the first response, and only if RunQueryRequest.new_transaction was set in the request. If set, no other fields will be set in this response.",
 "format": "byte",