feat(firebase): update the API

#### firebase:v1beta1

The following keys were added:
- resources.projects.resources.availableLocations.deprecated
- resources.projects.resources.availableLocations.methods.list.deprecated
- resources.projects.resources.defaultLocation.deprecated
- resources.projects.resources.defaultLocation.methods.finalize.deprecated
- schemas.AdminSdkConfig.properties.databaseURL.deprecated
- schemas.AdminSdkConfig.properties.locationId.deprecated
- schemas.AdminSdkConfig.properties.storageBucket.deprecated
- schemas.DefaultResources.deprecated
- schemas.DefaultResources.properties.hostingSite.deprecated
- schemas.DefaultResources.properties.locationId.deprecated
- schemas.DefaultResources.properties.realtimeDatabaseInstance.deprecated
- schemas.DefaultResources.properties.storageBucket.deprecated
- schemas.FinalizeDefaultLocationRequest.deprecated
- schemas.FirebaseProject.properties.resources.deprecated
- schemas.ListAvailableLocationsResponse.deprecated
- schemas.Location.deprecated
- schemas.WebAppConfig.properties.databaseURL.deprecated
- schemas.WebAppConfig.properties.locationId.deprecated
- schemas.WebAppConfig.properties.storageBucket.deprecated

The following keys were changed:
- resources.projects.resources.availableLocations.methods.list.description
- resources.projects.resources.defaultLocation.methods.finalize.description
- schemas.AdminSdkConfig.properties.databaseURL.description
- schemas.AdminSdkConfig.properties.locationId.description
- schemas.AdminSdkConfig.properties.storageBucket.description
- schemas.DefaultResources.description
- schemas.DefaultResources.properties.hostingSite.description
- schemas.DefaultResources.properties.locationId.description
- schemas.DefaultResources.properties.realtimeDatabaseInstance.description
- schemas.DefaultResources.properties.storageBucket.description
- schemas.FirebaseProject.properties.resources.description
- schemas.Location.description
- schemas.WebAppConfig.properties.databaseURL.description
- schemas.WebAppConfig.properties.locationId.description
- schemas.WebAppConfig.properties.storageBucket.description

Author: yoshi-automation

discovery/firebase-v1beta1.json

@@ -790,9 +790,11 @@
           }
         },
         "availableLocations": {
+          "deprecated": true,
           "methods": {
             "list": {
-              "description": "Lists the valid Google Cloud Platform (GCP) resource locations for the specified Project (including a FirebaseProject). One of these locations can be selected as the Project's [_default_ GCP resource location](https://firebase.google.com/docs/projects/locations), which is the geographical location where the Project's resources, such as Cloud Firestore, will be provisioned by default. However, if the default GCP resource location has already been set for the Project, then this setting cannot be changed. This call checks for any possible [location restrictions](https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations) for the specified Project and, thus, might return a subset of all possible GCP resource locations. To list all GCP resource locations (regardless of any restrictions), call the endpoint without specifying a unique project identifier (that is, `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call `ListAvailableLocations` with a specified project, a member must be at minimum a Viewer of the Project. Calls without a specified project do not require any specific project permissions.",
+              "deprecated": true,
+              "description": "**DEPRECATED.** _Instead, use the applicable resource-specific REST API (or associated documentation, as needed) to determine valid locations for each resource used in your Project._ Lists the valid Google Cloud Platform (GCP) resource locations for the specified Project (including a FirebaseProject). One of these locations can be selected as the Project's [_default_ GCP resource location](https://firebase.google.com/docs/projects/locations), which is the geographical location where the Project's resources, such as Cloud Firestore, will be provisioned by default. However, if the default GCP resource location has already been set for the Project, then this setting cannot be changed. This call checks for any possible [location restrictions](https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations) for the specified Project and, thus, might return a subset of all possible GCP resource locations. To list all GCP resource locations (regardless of any restrictions), call the endpoint without specifying a unique project identifier (that is, `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call `ListAvailableLocations` with a specified project, a member must be at minimum a Viewer of the Project. Calls without a specified project do not require any specific project permissions.",
               "flatPath": "v1beta1/projects/{projectsId}/availableLocations",
               "httpMethod": "GET",
               "id": "firebase.projects.availableLocations.list",
@@ -833,9 +835,11 @@
           }
         },
         "defaultLocation": {
+          "deprecated": true,
           "methods": {
             "finalize": {
-              "description": "Sets the default Google Cloud Platform (GCP) resource location for the specified FirebaseProject. This method creates an App Engine application with a [default Cloud Storage bucket](https://cloud.google.com/appengine/docs/standard/python/googlecloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket), located in the specified [`locationId`](#body.request_body.FIELDS.location_id). This location must be one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). After the default GCP resource location is finalized, or if it was already set, it cannot be changed. The default GCP resource location for the specified `FirebaseProject` might already be set because either the underlying GCP `Project` already has an App Engine application or `FinalizeDefaultLocation` was previously called with a specified `locationId`. Any new calls to `FinalizeDefaultLocation` with a *different* specified `locationId` will return a 409 error. The result of this call is an [`Operation`](../../v1beta1/operations), which can be used to track the provisioning process. The [`response`](../../v1beta1/operations#Operation.FIELDS.response) type of the `Operation` is google.protobuf.Empty. The `Operation` can be polled by its `name` using GetOperation until `done` is true. When `done` is true, the `Operation` has either succeeded or failed. If the `Operation` has succeeded, its [`response`](../../v1beta1/operations#Operation.FIELDS.response) will be set to a google.protobuf.Empty; if the `Operation` has failed, its `error` will be set to a google.rpc.Status. The `Operation` is automatically deleted after completion, so there is no need to call DeleteOperation. All fields listed in the [request body](#request-body) are required. To call `FinalizeDefaultLocation`, a member must be an Owner of the Project.",
+              "deprecated": true,
+              "description": "**DEPRECATED.** _Instead, use the applicable resource-specific REST API to set the location for each resource used in your Project._ Sets the default Google Cloud Platform (GCP) resource location for the specified FirebaseProject. This method creates an App Engine application with a [default Cloud Storage bucket](https://cloud.google.com/appengine/docs/standard/python/googlecloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket), located in the specified [`locationId`](#body.request_body.FIELDS.location_id). This location must be one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). After the default GCP resource location is finalized, or if it was already set, it cannot be changed. The default GCP resource location for the specified `FirebaseProject` might already be set because either the underlying GCP `Project` already has an App Engine application or `FinalizeDefaultLocation` was previously called with a specified `locationId`. Any new calls to `FinalizeDefaultLocation` with a *different* specified `locationId` will return a 409 error. The result of this call is an [`Operation`](../../v1beta1/operations), which can be used to track the provisioning process. The [`response`](../../v1beta1/operations#Operation.FIELDS.response) type of the `Operation` is google.protobuf.Empty. The `Operation` can be polled by its `name` using GetOperation until `done` is true. When `done` is true, the `Operation` has either succeeded or failed. If the `Operation` has succeeded, its [`response`](../../v1beta1/operations#Operation.FIELDS.response) will be set to a google.protobuf.Empty; if the `Operation` has failed, its `error` will be set to a google.rpc.Status. The `Operation` is automatically deleted after completion, so there is no need to call DeleteOperation. All fields listed in the [request body](#request-body) are required. To call `FinalizeDefaultLocation`, a member must be an Owner of the Project.",
               "flatPath": "v1beta1/projects/{projectsId}/defaultLocation:finalize",
               "httpMethod": "POST",
               "id": "firebase.projects.defaultLocation.finalize",
@@ -1320,7 +1324,7 @@
       }
     }
   },
-  "revision": "20230807",
+  "revision": "20230920",
   "rootUrl": "https://firebase.googleapis.com/",
   "schemas": {
     "AddFirebaseRequest": {
@@ -1352,19 +1356,22 @@
       "id": "AdminSdkConfig",
       "properties": {
         "databaseURL": {
-          "description": "The default Firebase Realtime Database URL.",
+          "deprecated": true,
+          "description": "**DEPRECATED.** _Instead, find the default Firebase Realtime Database instance name using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. Note that the default instance for the Project might not yet be provisioned, so the return might not contain a default instance._ The default Firebase Realtime Database URL.",
           "type": "string"
         },
         "locationId": {
-          "description": "The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.",
+          "deprecated": true,
+          "description": "**DEPRECATED.** _Instead, use product-specific REST APIs to find the location of resources._ The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.",
           "type": "string"
         },
         "projectId": {
           "description": "Immutable. A user-assigned unique identifier for the `FirebaseProject`. This identifier may appear in URLs or names for some Firebase resources associated with the Project, but it should generally be treated as a convenience alias to reference the Project.",
           "type": "string"
         },
         "storageBucket": {
-          "description": "The default Cloud Storage for Firebase storage bucket name.",
+          "deprecated": true,
+          "description": "**DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket name.",
           "type": "string"
         }
       },
@@ -1496,26 +1503,31 @@
       "type": "object"
     },
     "DefaultResources": {
-      "description": "The default resources associated with the Project.",
+      "deprecated": true,
+      "description": "**DEPRECATED.** _Auto-provisioning of these resources is changing, so this object no longer reliably provides information about the resources within the Project. Instead, retrieve information about each resource directly from its resource-specific API._ The default auto-provisioned resources associated with the Project.",
       "id": "DefaultResources",
       "properties": {
         "hostingSite": {
-          "description": "Output only. The default Firebase Hosting site name, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Hosting site in another project (learn more about creating non-default, [additional sites](https://firebase.google.com/docs/hosting/multisites)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Hosting site name. For example, if your `projectId` is `myproject123`, your default Hosting site name might be: `myproject123-a5c16`",
+          "deprecated": true,
+          "description": "Output only. **DEPRECATED.** _Instead, find the default Firebase Hosting site name using the [ListSites](https://firebase.google.com/docs/reference/hosting/rest/v1beta1/projects.sites/list) within the Firebase Hosting REST API. Note that the default site for the Project might not yet be provisioned, so the return might not contain a default site._ The default Firebase Hosting site name, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Hosting site in another project (learn more about creating non-default, [additional sites](https://firebase.google.com/docs/hosting/multisites)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Hosting site name. For example, if your `projectId` is `myproject123`, your default Hosting site name might be: `myproject123-a5c16`",
           "readOnly": true,
           "type": "string"
         },
         "locationId": {
-          "description": "Output only. The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.",
+          "deprecated": true,
+          "description": "Output only. **DEPRECATED.** _Instead, use product-specific REST APIs to find the location of resources._ The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.",
           "readOnly": true,
           "type": "string"
         },
         "realtimeDatabaseInstance": {
-          "description": "Output only. The default Firebase Realtime Database instance name, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Realtime Database instance in another project (learn more about [database sharding](https://firebase.google.com/docs/database/usage/sharding)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Realtime Database instance name. For example, if your `projectId` is `myproject123`, your default database instance name might be: `myproject123-a5c16`",
+          "deprecated": true,
+          "description": "Output only. **DEPRECATED.** _Instead, find the default Firebase Realtime Database instance name using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. Note that the default instance for the Project might not yet be provisioned, so the return might not contain a default instance._ The default Firebase Realtime Database instance name, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Realtime Database instance in another project (learn more about [database sharding](https://firebase.google.com/docs/database/usage/sharding)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Realtime Database instance name. For example, if your `projectId` is `myproject123`, your default database instance name might be: `myproject123-a5c16`",
           "readOnly": true,
           "type": "string"
         },
         "storageBucket": {
-          "description": "Output only. The default Cloud Storage for Firebase storage bucket, in the format: PROJECT_ID.appspot.com",
+          "deprecated": true,
+          "description": "Output only. **DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket, in the format: PROJECT_ID.appspot.com",
           "readOnly": true,
           "type": "string"
         }
@@ -1529,6 +1541,7 @@
       "type": "object"
     },
     "FinalizeDefaultLocationRequest": {
+      "deprecated": true,
       "id": "FinalizeDefaultLocationRequest",
       "properties": {
         "locationId": {
@@ -1640,7 +1653,8 @@
         },
         "resources": {
           "$ref": "DefaultResources",
-          "description": "Output only. The default Firebase resources associated with the Project.",
+          "deprecated": true,
+          "description": "Output only. **DEPRECATED.** _Auto-provisioning of these resources is changing, so this object no longer reliably provides information about the Project. Instead, retrieve information about each resource directly from its resource-specific API._ The default Firebase resources associated with the Project.",
           "readOnly": true
         },
         "state": {
@@ -1761,6 +1775,7 @@
       "type": "object"
     },
     "ListAvailableLocationsResponse": {
+      "deprecated": true,
       "id": "ListAvailableLocationsResponse",
       "properties": {
         "locations": {
@@ -1859,7 +1874,8 @@
       "type": "object"
     },
     "Location": {
-      "description": "A GCP resource location that can be selected for a FirebaseProject.",
+      "deprecated": true,
+      "description": "**DEPRECATED.** _This Location is no longer used to determine Firebase resource locations. Instead, consult product documentation to determine valid locations for each resource used in your Project._ A GCP resource location that can be selected for a FirebaseProject.",
       "id": "Location",
       "properties": {
         "features": {
@@ -2306,11 +2322,13 @@
           "type": "string"
         },
         "databaseURL": {
-          "description": "The default Firebase Realtime Database URL.",
+          "deprecated": true,
+          "description": "**DEPRECATED.** _Instead, find the default Firebase Realtime Database instance name using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. Note that the default instance for the Project might not yet be provisioned, so the return might not contain a default instance._ The default Firebase Realtime Database URL.",
           "type": "string"
         },
         "locationId": {
-          "description": "The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.",
+          "deprecated": true,
+          "description": "**DEPRECATED.** _Instead, use product-specific REST APIs to find the location of resources._ The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.",
           "type": "string"
         },
         "measurementId": {
@@ -2326,7 +2344,8 @@
           "type": "string"
         },
         "storageBucket": {
-          "description": "The default Cloud Storage for Firebase storage bucket name.",
+          "deprecated": true,
+          "description": "**DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket name.",
           "type": "string"
         }
       },