feat(firestore): update the api

#### firestore:v1

The following keys were added:
- schemas.ExecutionStats (Total Keys: 10)
- schemas.ExplainMetrics (Total Keys: 4)
- schemas.ExplainOptions (Total Keys: 3)
- schemas.PlanSummary (Total Keys: 5)
- schemas.RunAggregationQueryRequest.properties.explainOptions.$ref (Total Keys: 1)
- schemas.RunAggregationQueryResponse.properties.explainMetrics.$ref (Total Keys: 1)
- schemas.RunQueryRequest.properties.explainOptions.$ref (Total Keys: 1)
- schemas.RunQueryResponse.properties.explainMetrics.$ref (Total Keys: 1)

#### firestore:v1beta1

The following keys were added:
- schemas.ExecutionStats (Total Keys: 10)
- schemas.ExplainMetrics (Total Keys: 4)
- schemas.ExplainOptions (Total Keys: 3)
- schemas.PlanSummary (Total Keys: 5)
- schemas.RunAggregationQueryRequest.properties.explainOptions.$ref (Total Keys: 1)
- schemas.RunAggregationQueryResponse.properties.explainMetrics.$ref (Total Keys: 1)
- schemas.RunQueryRequest.properties.explainOptions.$ref (Total Keys: 1)
- schemas.RunQueryResponse.properties.explainMetrics.$ref (Total Keys: 1)

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

@@ -109,7 +109,7 @@ <h3>Method Details</h3>
 
 { # A backup schedule for a Cloud Firestore Database. This resource is owned by the database it is backing up, and is deleted along with the database. The actual backups are not though.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp at which this backup schedule was created and effective since. No backups will be created for this schedule before this time.
-  &quot;dailyRecurrence&quot;: { # Represent a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
+  &quot;dailyRecurrence&quot;: { # Represents a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The unique backup schedule identifier across all locations and databases for the given project. This will be auto-assigned. Format is `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
   &quot;retention&quot;: &quot;A String&quot;, # At what relative time in the future, compared to its creation time, the backup should be deleted, e.g. keep backups for 7 days.
@@ -129,7 +129,7 @@ <h3>Method Details</h3>
 
     { # A backup schedule for a Cloud Firestore Database. This resource is owned by the database it is backing up, and is deleted along with the database. The actual backups are not though.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp at which this backup schedule was created and effective since. No backups will be created for this schedule before this time.
-  &quot;dailyRecurrence&quot;: { # Represent a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
+  &quot;dailyRecurrence&quot;: { # Represents a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The unique backup schedule identifier across all locations and databases for the given project. This will be auto-assigned. Format is `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
   &quot;retention&quot;: &quot;A String&quot;, # At what relative time in the future, compared to its creation time, the backup should be deleted, e.g. keep backups for 7 days.
@@ -145,7 +145,7 @@ <h3>Method Details</h3>
   <pre>Deletes a backup schedule.
 
 Args:
-  name: string, Required. The name of backup schedule. Format `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}` (required)
+  name: string, Required. The name of the backup schedule. Format `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -174,7 +174,7 @@ <h3>Method Details</h3>
 
     { # A backup schedule for a Cloud Firestore Database. This resource is owned by the database it is backing up, and is deleted along with the database. The actual backups are not though.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp at which this backup schedule was created and effective since. No backups will be created for this schedule before this time.
-  &quot;dailyRecurrence&quot;: { # Represent a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
+  &quot;dailyRecurrence&quot;: { # Represents a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The unique backup schedule identifier across all locations and databases for the given project. This will be auto-assigned. Format is `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
   &quot;retention&quot;: &quot;A String&quot;, # At what relative time in the future, compared to its creation time, the backup should be deleted, e.g. keep backups for 7 days.
@@ -203,7 +203,7 @@ <h3>Method Details</h3>
   &quot;backupSchedules&quot;: [ # List of all backup schedules.
     { # A backup schedule for a Cloud Firestore Database. This resource is owned by the database it is backing up, and is deleted along with the database. The actual backups are not though.
       &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp at which this backup schedule was created and effective since. No backups will be created for this schedule before this time.
-      &quot;dailyRecurrence&quot;: { # Represent a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
+      &quot;dailyRecurrence&quot;: { # Represents a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
       },
       &quot;name&quot;: &quot;A String&quot;, # Output only. The unique backup schedule identifier across all locations and databases for the given project. This will be auto-assigned. Format is `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
       &quot;retention&quot;: &quot;A String&quot;, # At what relative time in the future, compared to its creation time, the backup should be deleted, e.g. keep backups for 7 days.
@@ -227,7 +227,7 @@ <h3>Method Details</h3>
 
 { # A backup schedule for a Cloud Firestore Database. This resource is owned by the database it is backing up, and is deleted along with the database. The actual backups are not though.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp at which this backup schedule was created and effective since. No backups will be created for this schedule before this time.
-  &quot;dailyRecurrence&quot;: { # Represent a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
+  &quot;dailyRecurrence&quot;: { # Represents a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The unique backup schedule identifier across all locations and databases for the given project. This will be auto-assigned. Format is `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
   &quot;retention&quot;: &quot;A String&quot;, # At what relative time in the future, compared to its creation time, the backup should be deleted, e.g. keep backups for 7 days.
@@ -248,7 +248,7 @@ <h3>Method Details</h3>
 
     { # A backup schedule for a Cloud Firestore Database. This resource is owned by the database it is backing up, and is deleted along with the database. The actual backups are not though.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp at which this backup schedule was created and effective since. No backups will be created for this schedule before this time.
-  &quot;dailyRecurrence&quot;: { # Represent a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
+  &quot;dailyRecurrence&quot;: { # Represents a recurring schedule that runs at a specific time every day. The time zone is UTC. # For a schedule that runs daily at a specified time.
   },
   &quot;name&quot;: &quot;A String&quot;, # Output only. The unique backup schedule identifier across all locations and databases for the given project. This will be auto-assigned. Format is `projects/{project}/databases/{database}/backupSchedules/{backup_schedule}`
   &quot;retention&quot;: &quot;A String&quot;, # At what relative time in the future, compared to its creation time, the backup should be deleted, e.g. keep backups for 7 days.

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

@@ -1750,6 +1750,9 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for Firestore.RunAggregationQuery.
+  &quot;explainOptions&quot;: { # Explain options for the query. # Optional. Explain options for the query. If set, additional query statistics will be returned. If not, only query results will be returned.
+    &quot;analyze&quot;: True or False, # Optional. Whether to execute this query. When false (the default), the query will be planned, returning only metrics from the planning stages. When true, the query will be planned and executed, returning the full query results along with both planning and execution stage metrics.
+  },
   &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.
@@ -1918,6 +1921,23 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # The response for Firestore.RunAggregationQuery.
+  &quot;explainMetrics&quot;: { # Explain metrics for the query. # Query explain metrics. This is only present when the RunAggregationQueryRequest.explain_options is provided, and it is sent only once with the last response in the stream.
+    &quot;executionStats&quot;: { # Execution statistics for the query. # Aggregated stats from the execution of the query. Only present when ExplainOptions.analyze is set to true.
+      &quot;debugStats&quot;: { # Debugging statistics from the execution of the query. Note that the debugging stats are subject to change as Firestore evolves. It could include: { &quot;indexes_entries_scanned&quot;: &quot;1000&quot;, &quot;documents_scanned&quot;: &quot;20&quot;, &quot;billing_details&quot; : { &quot;documents_billable&quot;: &quot;20&quot;, &quot;index_entries_billable&quot;: &quot;1000&quot;, &quot;min_query_cost&quot;: &quot;0&quot; } }
+        &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
+      },
+      &quot;executionDuration&quot;: &quot;A String&quot;, # Total time to execute the query in the backend.
+      &quot;readOperations&quot;: &quot;A String&quot;, # Total billable read operations.
+      &quot;resultsReturned&quot;: &quot;A String&quot;, # Total number of results returned, including documents, projections, aggregation results, keys.
+    },
+    &quot;planSummary&quot;: { # Planning phase information for the query. # Planning phase information for the query.
+      &quot;indexesUsed&quot;: [ # The indexes selected for the query. For example: [ {&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;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.
@@ -1961,6 +1981,9 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # The request for Firestore.RunQuery.
+  &quot;explainOptions&quot;: { # Explain options for the query. # Optional. Explain options for the query. If set, additional query statistics will be returned. If not, only query results will be returned.
+    &quot;analyze&quot;: True or False, # Optional. Whether to execute this query. When false (the default), the query will be planned, returning only metrics from the planning stages. When true, the query will be planned and executed, returning the full query results along with both planning and execution stage metrics.
+  },
   &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.
@@ -2141,6 +2164,23 @@ <h3>Method Details</h3>
     &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time at which the document was last changed. This value is initially set to the `create_time` then increases monotonically with each change to the document. It can also be compared to values from other documents and the `read_time` of a query.
   },
   &quot;done&quot;: True or False, # If present, Firestore has completely finished the request and no more documents will be returned.
+  &quot;explainMetrics&quot;: { # Explain metrics for the query. # Query explain metrics. This is only present when the RunQueryRequest.explain_options is provided, and it is sent only once with the last response in the stream.
+    &quot;executionStats&quot;: { # Execution statistics for the query. # Aggregated stats from the execution of the query. Only present when ExplainOptions.analyze is set to true.
+      &quot;debugStats&quot;: { # Debugging statistics from the execution of the query. Note that the debugging stats are subject to change as Firestore evolves. It could include: { &quot;indexes_entries_scanned&quot;: &quot;1000&quot;, &quot;documents_scanned&quot;: &quot;20&quot;, &quot;billing_details&quot; : { &quot;documents_billable&quot;: &quot;20&quot;, &quot;index_entries_billable&quot;: &quot;1000&quot;, &quot;min_query_cost&quot;: &quot;0&quot; } }
+        &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
+      },
+      &quot;executionDuration&quot;: &quot;A String&quot;, # Total time to execute the query in the backend.
+      &quot;readOperations&quot;: &quot;A String&quot;, # Total billable read operations.
+      &quot;resultsReturned&quot;: &quot;A String&quot;, # Total number of results returned, including documents, projections, aggregation results, keys.
+    },
+    &quot;planSummary&quot;: { # Planning phase information for the query. # Planning phase information for the query.
+      &quot;indexesUsed&quot;: [ # The indexes selected for the query. For example: [ {&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;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;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.