google-api-client 0.42.2 → 0.43.0

data/generated/google/apis/firebase_v1beta1/representations.rb

@@ -332,6 +332,7 @@ module Google
           property :project_number, :numeric_string => true, as: 'projectNumber'
           property :resources, as: 'resources', class: Google::Apis::FirebaseV1beta1::DefaultResources, decorator: Google::Apis::FirebaseV1beta1::DefaultResources::Representation
       
+          property :state, as: 'state'
         end
       end
       

data/generated/google/apis/firebase_v1beta1/service.rb

@@ -48,30 +48,21 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Returns a list of [Google Cloud Platform (GCP) `Projects`]
-        # (https://cloud.google.com/resource-manager/reference/rest/v1/projects)
-        # that are available to have Firebase resources added to them.
-        # <br>
-        # <br>A GCP `Project` will only be returned if:
-        # <ol>
-        # <li><p>The caller has sufficient
-        # [Google IAM](https://cloud.google.com/iam) permissions to call
-        # AddFirebase.</p></li>
-        # <li><p>The GCP `Project` is not already a FirebaseProject.</p></li>
-        # <li><p>The GCP `Project` is not in an Organization which has policies
-        # that prevent Firebase resources from being added.</p></li>
-        # </ol>
+        # Lists each [Google Cloud Platform (GCP) `Project`] (https://cloud.google.com/
+        # resource-manager/reference/rest/v1/projects) that can have Firebase resources
+        # added to it. A Project will only be listed if: - The caller has sufficient [
+        # Google IAM](https://cloud.google.com/iam) permissions to call AddFirebase. -
+        # The Project is not already a FirebaseProject. - The Project is not in an
+        # Organization which has policies that prevent Firebase resources from being
+        # added.
         # @param [Fixnum] page_size
-        #   The maximum number of GCP `Projects` to return in the response.
-        #   <br>
-        #   <br>The server may return fewer than this value at its discretion.
-        #   If no value is specified (or too large a value is specified), the server
-        #   will impose its own limit.
-        #   <br>
-        #   <br>This value cannot be negative.
+        #   The maximum number of Projects to return in the response. The server may
+        #   return fewer than this value at its discretion. If no value is specified (or
+        #   too large a value is specified), the server will impose its own limit. This
+        #   value cannot be negative.
         # @param [String] page_token
-        #   Token returned from a previous call to `ListAvailableProjects`
-        #   indicating where in the set of GCP `Projects` to resume listing.
+        #   Token returned from a previous call to `ListAvailableProjects` indicating
+        #   where in the set of Projects to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -100,9 +91,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -132,43 +122,35 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds Firebase resources to the specified existing
-        # [Google Cloud Platform (GCP) `Project`]
-        # (https://cloud.google.com/resource-manager/reference/rest/v1/projects).
-        # <br>
-        # <br>Since a FirebaseProject is actually also a GCP `Project`, a
-        # `FirebaseProject` uses underlying GCP identifiers (most importantly,
-        # the `PROJECT_NUMBER`) as its own for easy interop with GCP APIs.
-        # <br>
-        # <br>The result of this call is an [`Operation`](../../v1beta1/operations).
-        # Poll the `Operation` to track the provisioning process by calling
-        # GetOperation until
-        # [`done`](../../v1beta1/operations#Operation.FIELDS.done) is `true`. When
-        # `done` is `true`, the `Operation` has either succeeded or failed. If the
-        # `Operation` succeeded, its
-        # [`response`](../../v1beta1/operations#Operation.FIELDS.response) is set to
-        # a FirebaseProject; if the `Operation` failed, its
-        # [`error`](../../v1beta1/operations#Operation.FIELDS.error) is set to a
-        # google.rpc.Status. The `Operation` is automatically deleted after
-        # completion, so there is no need to call
-        # DeleteOperation.
-        # <br>
-        # <br>This method does not modify any billing account information on the
-        # underlying GCP `Project`.
-        # <br>
-        # <br>To call `AddFirebase`, a project member or service account must have
-        # the following permissions (the IAM roles of Editor and Owner contain these
-        # permissions):
-        # `firebase.projects.update`, `resourcemanager.projects.get`,
-        # `serviceusage.services.enable`, and `serviceusage.services.get`.
+        # Adds Firebase resources to the specified existing [Google Cloud Platform (GCP)
+        # `Project`] (https://cloud.google.com/resource-manager/reference/rest/v1/
+        # projects). Since a FirebaseProject is actually also a GCP `Project`, a `
+        # FirebaseProject` has the same underlying GCP identifiers (`projectNumber` and `
+        # projectId`). This allows for easy interop with Google APIs. The result of this
+        # call is an [`Operation`](../../v1beta1/operations). Poll the `Operation` to
+        # track the provisioning process by calling GetOperation until [`done`](../../
+        # v1beta1/operations#Operation.FIELDS.done) is `true`. When `done` is `true`,
+        # the `Operation` has either succeeded or failed. If the `Operation` succeeded,
+        # its [`response`](../../v1beta1/operations#Operation.FIELDS.response) is set to
+        # a FirebaseProject; if the `Operation` failed, its [`error`](../../v1beta1/
+        # operations#Operation.FIELDS.error) is set to a google.rpc.Status. The `
+        # Operation` is automatically deleted after completion, so there is no need to
+        # call DeleteOperation. This method does not modify any billing account
+        # information on the underlying GCP `Project`. To call `AddFirebase`, a project
+        # member or service account must have the following permissions (the IAM roles
+        # of Editor and Owner contain these permissions): `firebase.projects.update`, `
+        # resourcemanager.projects.get`, `serviceusage.services.enable`, and `
+        # serviceusage.services.get`.
         # @param [String] project
         #   The resource name of the GCP `Project` to which Firebase resources will be
-        #   added, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
-        #   After calling `AddFirebase`, the
-        #   [`project_id`](https://cloud.google.com/resource-manager/reference/rest/v1/
-        #   projects#Project.FIELDS.project_id)
-        #   of the GCP `Project` is also the `project_id` of the FirebaseProject.
+        #   added, in the format: projects/PROJECT_IDENTIFIER Refer to the `
+        #   FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER values. After calling `AddFirebase`, the
+        #   unique Project identifiers ( [`projectNumber`](https://cloud.google.com/
+        #   resource-manager/reference/rest/v1/projects#Project.FIELDS.project_number) and
+        #   [`projectId`](https://cloud.google.com/resource-manager/reference/rest/v1/
+        #   projects#Project.FIELDS.project_id)) of the underlying GCP `Project` are also
+        #   the identifiers of the FirebaseProject.
         # @param [Google::Apis::FirebaseV1beta1::AddFirebaseRequest] add_firebase_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -199,63 +181,43 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Links a FirebaseProject with an existing
-        # [Google Analytics account](http://www.google.com/analytics/).
-        # <br>
-        # <br>Using this call, you can either:
-        # <ul>
-        # <li>Specify an `analyticsAccountId` to provision a new Google Analytics
-        # property within the specified account and associate the new property with
-        # your `FirebaseProject`.</li>
-        # <li>Specify an existing `analyticsPropertyId` to associate the property
-        # with your `FirebaseProject`.</li>
-        # </ul>
-        # <br>
-        # Note that when you call `AddGoogleAnalytics`:
-        # <ol>
-        # <li>The first check determines if any existing data streams in the
-        # Google Analytics property correspond to any existing Firebase Apps in your
-        # `FirebaseProject` (based on the `packageName` or `bundleId` associated with
-        # the data stream). Then, as applicable, the data streams and apps are
-        # linked. Note that this auto-linking only applies to Android Apps and iOS
-        # Apps.</li>
-        # <li>If no corresponding data streams are found for your Firebase Apps,
-        # new data streams are provisioned in the Google Analytics property
-        # for each of your Firebase Apps. Note that a new data stream is always
-        # provisioned for a Web App even if it was previously associated with a
-        # data stream in your Analytics property.</li>
-        # </ol>
-        # Learn more about the hierarchy and structure of Google Analytics
-        # accounts in the
-        # [Analytics
-        # documentation](https://support.google.com/analytics/answer/9303323).
-        # <br>
-        # <br>The result of this call is an [`Operation`](../../v1beta1/operations).
-        # Poll the `Operation` to track the provisioning process by calling
-        # GetOperation until
-        # [`done`](../../v1beta1/operations#Operation.FIELDS.done) is `true`. When
-        # `done` is `true`, the `Operation` has either succeeded or failed. If the
-        # `Operation` succeeded, its
-        # [`response`](../../v1beta1/operations#Operation.FIELDS.response) is set to
-        # an AnalyticsDetails; if the `Operation` failed, its
-        # [`error`](../../v1beta1/operations#Operation.FIELDS.error) is set to a
-        # google.rpc.Status.
-        # <br>
-        # <br>To call `AddGoogleAnalytics`, a member must be an Owner for
-        # the existing `FirebaseProject` and have the
-        # [`Edit` permission](https://support.google.com/analytics/answer/2884495)
-        # for the Google Analytics account.
-        # <br>
-        # <br>If a `FirebaseProject` already has Google Analytics enabled, and you
-        # call `AddGoogleAnalytics` using an `analyticsPropertyId` that's different
-        # from the currently associated property, then the call will fail. Analytics
-        # may have already been enabled in the Firebase console or by specifying
-        # `timeZone` and `regionCode` in the call to
-        # [`AddFirebase`](../../v1beta1/projects/addFirebase).
+        # Links the specified FirebaseProject with an existing [Google Analytics account]
+        # (http://www.google.com/analytics/). Using this call, you can either: - Specify
+        # an `analyticsAccountId` to provision a new Google Analytics property within
+        # the specified account and associate the new property with the `FirebaseProject`
+        # . - Specify an existing `analyticsPropertyId` to associate the property with
+        # the `FirebaseProject`. Note that when you call `AddGoogleAnalytics`: 1. The
+        # first check determines if any existing data streams in the Google Analytics
+        # property correspond to any existing Firebase Apps in the `FirebaseProject` (
+        # based on the `packageName` or `bundleId` associated with the data stream).
+        # Then, as applicable, the data streams and apps are linked. Note that this auto-
+        # linking only applies to `AndroidApps` and `IosApps`. 2. If no corresponding
+        # data streams are found for the Firebase Apps, new data streams are provisioned
+        # in the Google Analytics property for each of the Firebase Apps. Note that a
+        # new data stream is always provisioned for a Web App even if it was previously
+        # associated with a data stream in the Analytics property. Learn more about the
+        # hierarchy and structure of Google Analytics accounts in the [Analytics
+        # documentation](https://support.google.com/analytics/answer/9303323). The
+        # result of this call is an [`Operation`](../../v1beta1/operations). Poll the `
+        # Operation` to track the provisioning process by calling GetOperation until [`
+        # done`](../../v1beta1/operations#Operation.FIELDS.done) is `true`. When `done`
+        # is `true`, the `Operation` has either succeeded or failed. If the `Operation`
+        # succeeded, its [`response`](../../v1beta1/operations#Operation.FIELDS.response)
+        # is set to an AnalyticsDetails; if the `Operation` failed, its [`error`](../../
+        # v1beta1/operations#Operation.FIELDS.error) is set to a google.rpc.Status. To
+        # call `AddGoogleAnalytics`, a project member must be an Owner for the existing `
+        # FirebaseProject` and have the [`Edit` permission](https://support.google.com/
+        # analytics/answer/2884495) for the Google Analytics account. If the `
+        # FirebaseProject` already has Google Analytics enabled, and you call `
+        # AddGoogleAnalytics` using an `analyticsPropertyId` that's different from the
+        # currently associated property, then the call will fail. Analytics may have
+        # already been enabled in the Firebase console or by specifying `timeZone` and `
+        # regionCode` in the call to [`AddFirebase`](../../v1beta1/projects/addFirebase).
         # @param [String] parent
-        #   The parent `FirebaseProject` to link to an existing Google Analytics
-        #   account, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the FirebaseProject to link to an existing Google
+        #   Analytics account, in the format: projects/PROJECT_IDENTIFIER Refer to the `
+        #   FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER values.
         # @param [Google::Apis::FirebaseV1beta1::AddGoogleAnalyticsRequest] add_google_analytics_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -286,10 +248,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the FirebaseProject identified by the specified resource name.
+        # Gets the specified FirebaseProject.
         # @param [String] name
-        #   The fully qualified resource name of the Project, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the FirebaseProject, in the format: projects/
+        #   PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#
+        #   FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -317,15 +280,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the configuration artifact used by servers to simplify initialization.
-        # <br>
-        # <br>Typically, this configuration is used with the Firebase Admin SDK
-        # [initializeApp](https://firebase.google.com/docs/admin/setup#
-        # initialize_the_sdk)
-        # command.
+        # Gets the configuration artifact associated with the specified FirebaseProject,
+        # which can be used by servers to simplify initialization. Typically, this
+        # configuration is used with the Firebase Admin SDK [initializeApp](https://
+        # firebase.google.com/docs/admin/setup#initialize_the_sdk) command.
         # @param [String] name
-        #   The fully qualified resource name of the Project, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/adminSdkConfig</code>
+        #   The resource name of the FirebaseProject, in the format: projects/
+        #   PROJECT_IDENTIFIER/adminSdkConfig Refer to the `FirebaseProject` [`name`](../
+        #   projects#FirebaseProject.FIELDS.name) field for details about
+        #   PROJECT_IDENTIFIER values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -353,14 +316,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the Google Analytics details currently associated with a
-        # FirebaseProject.
-        # <br>
-        # <br>If the `FirebaseProject` is not yet linked to Google Analytics, then
-        # the response to `GetAnalyticsDetails` is NOT_FOUND.
+        # Gets the Google Analytics details currently associated with the specified
+        # FirebaseProject. If the `FirebaseProject` is not yet linked to Google
+        # Analytics, then the response to `GetAnalyticsDetails` is `NOT_FOUND`.
         # @param [String] name
-        #   The fully qualified resource name, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/analyticsDetails</code>
+        #   The resource name of the FirebaseProject, in the format: projects/
+        #   PROJECT_IDENTIFIER/analyticsDetails Refer to the `FirebaseProject` [`name`](../
+        #   projects#FirebaseProject.FIELDS.name) field for details about
+        #   PROJECT_IDENTIFIER values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -388,31 +351,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists each FirebaseProject accessible to the caller.
-        # <br>
-        # <br>The elements are returned in no particular order, but they will be a
-        # consistent view of the Projects when additional requests are made with a
-        # `pageToken`.
-        # <br>
-        # <br>This method is eventually consistent with Project mutations, which
-        # means newly provisioned Projects and recent modifications to existing
-        # Projects might not be reflected in the set of Projects. The list will
-        # include only ACTIVE Projects.
-        # <br>
-        # <br>Use
-        # GetFirebaseProject
-        # for consistent reads as well as for additional Project details.
+        # Lists each FirebaseProject accessible to the caller. The elements are returned
+        # in no particular order, but they will be a consistent view of the Projects
+        # when additional requests are made with a `pageToken`. This method is
+        # eventually consistent with Project mutations, which means newly provisioned
+        # Projects and recent modifications to existing Projects might not be reflected
+        # in the set of Projects. The list will include only ACTIVE Projects. Use
+        # GetFirebaseProject for consistent reads as well as for additional Project
+        # details.
         # @param [Fixnum] page_size
-        #   The maximum number of Projects to return in the response.
-        #   <br>
-        #   <br>The server may return fewer than this at its discretion.
-        #   If no value is specified (or too large a value is specified), the server
-        #   will impose its own limit.
-        #   <br>
-        #   <br>This value cannot be negative.
+        #   The maximum number of Projects to return in the response. The server may
+        #   return fewer than this at its discretion. If no value is specified (or too
+        #   large a value is specified), the server will impose its own limit. This value
+        #   cannot be negative.
         # @param [String] page_token
-        #   Token returned from a previous call to `ListFirebaseProjects` indicating
-        #   where in the set of Projects to resume listing.
+        #   Token returned from a previous call to `ListFirebaseProjects` indicating where
+        #   in the set of Projects to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -441,19 +395,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the attributes of the FirebaseProject identified by the
-        # specified resource name.
-        # <br>
-        # <br>All [query parameters](#query-parameters) are required.
+        # Updates the attributes of the specified FirebaseProject. All [query parameters]
+        # (#query-parameters) are required.
         # @param [String] name
-        #   The fully qualified resource name of the Project, in the format:
-        #   <br><code>projects/<var>projectId</var></code>
+        #   The resource name of the Project, in the format: projects/PROJECT_IDENTIFIER
+        #   PROJECT_IDENTIFIER: the Project's [`ProjectNumber`](../projects#
+        #   FirebaseProject.FIELDS.project_number) ***(recommended)*** or its [`ProjectId`]
+        #   (../projects#FirebaseProject.FIELDS.project_id). Learn more about using
+        #   project identifiers in Google's [AIP 2510 standard](https://google.aip.dev/
+        #   cloud/2510). Note that the value for PROJECT_IDENTIFIER in any response body
+        #   will be the `ProjectId`.
         # @param [Google::Apis::FirebaseV1beta1::FirebaseProject] firebase_project_object
         # @param [String] update_mask
-        #   Specifies which fields to update.
-        #   <br>
-        #   <br>If this list is empty, then no state will be updated.
-        #   <br>Note that the fields `name`, `project_id`, and `project_number` are all
+        #   Specifies which fields to update. If this list is empty, then no state will be
+        #   updated. Note that the fields `name`, `projectId`, and `projectNumber` are all
         #   immutable.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -485,27 +440,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Unlinks the specified `FirebaseProject` from its Google Analytics account.
-        # <br>
-        # <br>This call removes the association of the specified `FirebaseProject`
-        # with its current Google Analytics property. However, this call does not
-        # delete the Google Analytics resources, such as the Google Analytics
-        # property or any data streams.
-        # <br>
-        # <br>These resources may be re-associated later to the `FirebaseProject` by
-        # calling
-        # [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics) and
-        # specifying the same `analyticsPropertyId`. For Android Apps and iOS Apps,
-        # this call re-links data streams with their corresponding apps. However,
-        # for Web Apps, this call provisions a <em>new</em> data stream for each Web
-        # App.
-        # <br>
-        # <br>To call `RemoveAnalytics`, a member must be an Owner for
-        # the `FirebaseProject`.
+        # Unlinks the specified FirebaseProject from its Google Analytics account. This
+        # call removes the association of the specified `FirebaseProject` with its
+        # current Google Analytics property. However, this call does not delete the
+        # Google Analytics resources, such as the Google Analytics property or any data
+        # streams. These resources may be re-associated later to the `FirebaseProject`
+        # by calling [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics)
+        # and specifying the same `analyticsPropertyId`. For Android Apps and iOS Apps,
+        # this call re-links data streams with their corresponding apps. However, for
+        # Web Apps, this call provisions a *new* data stream for each Web App. To call `
+        # RemoveAnalytics`, a project member must be an Owner for the `FirebaseProject`.
         # @param [String] parent
-        #   The parent `FirebaseProject` to unlink from its Google Analytics account,
-        #   in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the FirebaseProject to unlink from its Google Analytics
+        #   account, in the format: projects/PROJECT_IDENTIFIER Refer to the `
+        #   FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER values.
         # @param [Google::Apis::FirebaseV1beta1::RemoveAnalyticsRequest] remove_analytics_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -536,26 +485,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # A convenience method that lists all available Apps for the specified
-        # FirebaseProject.
-        # <br>
-        # <br>Typically, interaction with an App should be done using the
-        # platform-specific service, but some tool use-cases require a summary of all
-        # known Apps (such as for App selector interfaces).
+        # Lists all available Apps for the specified FirebaseProject. This is a
+        # convenience method. Typically, interaction with an App should be done using
+        # the platform-specific service, but some tool use-cases require a summary of
+        # all known Apps (such as for App selector interfaces).
         # @param [String] parent
-        #   The parent Project for which to list Apps, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The parent FirebaseProject for which to list Apps, in the format: projects/
+        #   PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#
+        #   FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values.
         # @param [Fixnum] page_size
-        #   The maximum number of Apps to return in the response.
-        #   <br>
-        #   <br>The server may return fewer than this value at its discretion.
-        #   If no value is specified (or too large a value is specified), then the
-        #   server will impose its own limit.
-        #   <br>
-        #   <br>This value cannot be negative.
+        #   The maximum number of Apps to return in the response. The server may return
+        #   fewer than this value at its discretion. If no value is specified (or too
+        #   large a value is specified), then the server will impose its own limit. This
+        #   value cannot be negative.
         # @param [String] page_token
-        #   Token returned from a previous call to `SearchFirebaseApps` indicating
-        #   where in the set of Apps to resume listing.
+        #   Token returned from a previous call to `SearchFirebaseApps` indicating where
+        #   in the set of Apps to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -585,14 +530,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests that a new AndroidApp be created.
-        # <br>
-        # <br>The result of this call is an `Operation` which can be used to track
-        # the provisioning process. The `Operation` is automatically deleted after
+        # Requests the creation of a new AndroidApp in the specified FirebaseProject.
+        # The result of this call is an `Operation` which can be used to track the
+        # provisioning process. The `Operation` is automatically deleted after
         # completion, so there is no need to call `DeleteOperation`.
         # @param [String] parent
-        #   The parent Project in which to create an App, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the parent FirebaseProject in which to create an
+        #   AndroidApp, in the format: projects/PROJECT_IDENTIFIER/androidApps Refer to
+        #   the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field
+        #   for details about PROJECT_IDENTIFIER values.
         # @param [Google::Apis::FirebaseV1beta1::AndroidApp] android_app_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -623,14 +569,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the AndroidApp identified by the specified resource name.
+        # Gets the specified AndroidApp.
         # @param [String] name
-        #   The fully qualified resource name of the App, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/androidApps/<var>APP_ID</var></
-        #   code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/androidApps/<var>APP_ID</var></code>
+        #   The resource name of the AndroidApp, in the format: projects/
+        #   PROJECT_IDENTIFIER/androidApps/APP_ID Since an APP_ID is a unique identifier,
+        #   the Unique Resource from Sub-Collection access pattern may be used here, in
+        #   the format: projects/-/androidApps/APP_ID Refer to the `AndroidApp` [`name`](..
+        #   /projects.androidApps#AndroidApp.FIELDS.name) field for details about
+        #   PROJECT_IDENTIFIER and APP_ID values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -658,15 +604,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the configuration artifact associated with the specified
-        # AndroidApp.
+        # Gets the configuration artifact associated with the specified AndroidApp.
         # @param [String] name
-        #   The resource name of the App configuration to download, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/androidApps/<var>APP_ID</var>/
-        #   config</code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/androidApps/<var>APP_ID</var></code>
+        #   The resource name of the AndroidApp configuration to download, in the format:
+        #   projects/PROJECT_IDENTIFIER/androidApps/APP_ID/config Since an APP_ID is a
+        #   unique identifier, the Unique Resource from Sub-Collection access pattern may
+        #   be used here, in the format: projects/-/androidApps/APP_ID Refer to the `
+        #   AndroidApp` [`name`](../projects.androidApps#AndroidApp.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER and APP_ID values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -694,23 +639,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists each AndroidApp associated with the specified parent Project.
-        # <br>
-        # <br>The elements are returned in no particular order, but will be a
-        # consistent view of the Apps when additional requests are made with a
-        # `pageToken`.
+        # Lists each AndroidApp associated with the specified FirebaseProject. The
+        # elements are returned in no particular order, but will be a consistent view of
+        # the Apps when additional requests are made with a `pageToken`.
         # @param [String] parent
-        #   The parent Project for which to list Apps, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the parent FirebaseProject for which to list each
+        #   associated AndroidApp, in the format: projects/PROJECT_IDENTIFIER /androidApps
+        #   Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.
+        #   name) field for details about PROJECT_IDENTIFIER values.
         # @param [Fixnum] page_size
-        #   The maximum number of Apps to return in the response.
-        #   <br>
-        #   <br>The server may return fewer than this at its discretion.
-        #   If no value is specified (or too large a value is specified), then the
-        #   server will impose its own limit.
+        #   The maximum number of Apps to return in the response. The server may return
+        #   fewer than this at its discretion. If no value is specified (or too large a
+        #   value is specified), then the server will impose its own limit.
         # @param [String] page_token
-        #   Token returned from a previous call to `ListAndroidApps` indicating where
-        #   in the set of Apps to resume listing.
+        #   Token returned from a previous call to `ListAndroidApps` indicating where in
+        #   the set of Apps to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -740,16 +683,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the attributes of the AndroidApp identified by the specified
-        # resource name.
+        # Updates the attributes of the specified AndroidApp.
         # @param [String] name
-        #   The fully qualified resource name of the App, in the format:
-        #   <br><code>projects/<var>projectId</var>/androidApps/<var>appId</var></code>
+        #   The resource name of the AndroidApp, in the format: projects/
+        #   PROJECT_IDENTIFIER/androidApps/APP_ID * PROJECT_IDENTIFIER: the parent Project'
+        #   s [`ProjectNumber`](../projects#FirebaseProject.FIELDS.project_number) ***(
+        #   recommended)*** or its [`ProjectId`](../projects#FirebaseProject.FIELDS.
+        #   project_id). Learn more about using project identifiers in Google's [AIP 2510
+        #   standard](https://google.aip.dev/cloud/2510). Note that the value for
+        #   PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * APP_ID: the
+        #   globally unique, Firebase-assigned identifier for the App (see [`appId`](../
+        #   projects.androidApps#AndroidApp.FIELDS.app_id)).
         # @param [Google::Apis::FirebaseV1beta1::AndroidApp] android_app_object
         # @param [String] update_mask
-        #   Specifies which fields to update.
-        #   <br>Note that the fields `name`, `app_id`, `project_id`, and `package_name`
-        #   are all immutable.
+        #   Specifies which fields to update. Note that the fields `name`, `app_id`, `
+        #   project_id`, and `package_name` are all immutable.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -780,14 +728,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a SHA certificate to the specified AndroidApp.
+        # Adds a ShaCertificate to the specified AndroidApp.
         # @param [String] parent
-        #   The parent App to which a SHA certificate will be added, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/androidApps/<var>APP_ID</var></
-        #   code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/androidApps/<var>APP_ID</var></code>
+        #   The resource name of the parent AndroidApp to which to add a ShaCertificate,
+        #   in the format: projects/PROJECT_IDENTIFIER/androidApps/ APP_ID Since an APP_ID
+        #   is a unique identifier, the Unique Resource from Sub-Collection access pattern
+        #   may be used here, in the format: projects/-/androidApps/APP_ID Refer to the `
+        #   AndroidApp` [`name`](../projects.androidApps#AndroidApp.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER and APP_ID values.
         # @param [Google::Apis::FirebaseV1beta1::ShaCertificate] sha_certificate_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -818,14 +766,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Removes a SHA certificate from the specified AndroidApp.
+        # Removes a ShaCertificate from the specified AndroidApp.
         # @param [String] name
-        #   The fully qualified resource name of the `sha-key`, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/androidApps/<var>APP_ID</var>/sha/
-        #   <var>SHA_ID</var></code>
-        #   <br>You can obtain the full name from the response of
-        #   [`ListShaCertificates`](../projects.androidApps.sha/list) or the original
-        #   [`CreateShaCertificate`](../projects.androidApps.sha/create).
+        #   The resource name of the ShaCertificate to remove from the parent AndroidApp,
+        #   in the format: projects/PROJECT_IDENTIFIER/androidApps/APP_ID /sha/SHA_HASH
+        #   Refer to the `ShaCertificate` [`name`](../projects.androidApps.sha#
+        #   ShaCertificate.FIELDS.name) field for details about PROJECT_IDENTIFIER, APP_ID,
+        #   and SHA_HASH values. You can obtain the full resource name of the `
+        #   ShaCertificate` from the response of [`ListShaCertificates`](../projects.
+        #   androidApps.sha/list) or the original [`CreateShaCertificate`](../projects.
+        #   androidApps.sha/create).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -853,15 +803,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the list of SHA-1 and SHA-256 certificates for the specified
-        # AndroidApp.
+        # Lists the SHA-1 and SHA-256 certificates for the specified AndroidApp.
         # @param [String] parent
-        #   The parent App for which to list SHA certificates, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/androidApps/<var>APP_ID</var></
-        #   code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/androidApps/<var>APP_ID</var></code>
+        #   The resource name of the parent AndroidApp for which to list each associated
+        #   ShaCertificate, in the format: projects/PROJECT_IDENTIFIER /androidApps/APP_ID
+        #   Since an APP_ID is a unique identifier, the Unique Resource from Sub-
+        #   Collection access pattern may be used here, in the format: projects/-/
+        #   androidApps/APP_ID Refer to the `AndroidApp` [`name`](../projects.androidApps#
+        #   AndroidApp.FIELDS.name) field for details about PROJECT_IDENTIFIER and APP_ID
+        #   values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -889,41 +839,33 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of valid Google Cloud Platform (GCP) resource locations for
-        # the specified Project (including a FirebaseProject).
-        # <br>
-        # <br>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 project 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.
-        # <br>
-        # <br>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 `PROJECT_NUMBER`
-        # (that is, `/v1beta1/`parent=projects/-`/listAvailableLocations`). <br>
-        # <br>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.
+        # 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.
         # @param [String] parent
-        #   The Project for which to list GCP resource locations, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
-        #   <br>If no project is specified (that is, `projects/-`), the returned list
-        #   does not take into account org-specific or project-specific location
-        #   restrictions.
+        #   The FirebaseProject for which to list GCP resource locations, in the format:
+        #   projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../
+        #   projects#FirebaseProject.FIELDS.name) field for details about
+        #   PROJECT_IDENTIFIER values. If no unique project identifier is specified (that
+        #   is, `projects/-`), the returned list does not take into account org-specific
+        #   or project-specific location restrictions.
         # @param [Fixnum] page_size
-        #   The maximum number of locations to return in the response.
-        #   <br>
-        #   <br>The server may return fewer than this value at its discretion.
-        #   If no value is specified (or too large a value is specified), then the
-        #   server will impose its own limit.
-        #   <br>
-        #   <br>This value cannot be negative.
+        #   The maximum number of locations to return in the response. The server may
+        #   return fewer than this value at its discretion. If no value is specified (or
+        #   too large a value is specified), then the server will impose its own limit.
+        #   This value cannot be negative.
         # @param [String] page_token
         #   Token returned from a previous call to `ListAvailableLocations` indicating
         #   where in the list of locations to resume listing.
@@ -957,49 +899,35 @@ module Google
         end
         
         # Sets the default Google Cloud Platform (GCP) resource location for the
-        # specified FirebaseProject.
-        # <br>
-        # <br>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
-        # [`location_id`](#body.request_body.FIELDS.location_id).
-        # This location must be one of the available
-        # [GCP resource
-        # locations](https://firebase.google.com/docs/projects/locations). <br>
-        # <br>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
-        # GCP `Project` already has an App Engine application or
-        # `FinalizeDefaultLocation` was previously called with a specified
-        # `location_id`. Any new calls to `FinalizeDefaultLocation` with a
-        # <em>different</em> specified `location_id` will return a 409 error.
-        # <br>
-        # <br>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.
-        # <br>
-        # <br>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.
-        # <br>
-        # <br>All fields listed in the [request body](#request-body) are required.
-        # <br>
-        # <br>To call `FinalizeDefaultLocation`, a member must be an Owner
-        # of the project.
+        # 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.
         # @param [String] parent
-        #   The resource name of the Project for which the default GCP resource
-        #   location will be set, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the FirebaseProject for which the default GCP resource
+        #   location will be set, in the format: projects/PROJECT_IDENTIFIER Refer to the `
+        #   FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER values.
         # @param [Google::Apis::FirebaseV1beta1::FinalizeDefaultLocationRequest] finalize_default_location_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1030,14 +958,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests that a new IosApp be created.
-        # <br>
-        # <br>The result of this call is an `Operation` which can be used to track
-        # the provisioning process. The `Operation` is automatically deleted after
+        # Requests the creation of a new IosApp in the specified FirebaseProject. The
+        # result of this call is an `Operation` which can be used to track the
+        # provisioning process. The `Operation` is automatically deleted after
         # completion, so there is no need to call `DeleteOperation`.
         # @param [String] parent
-        #   The parent Project in which to create an App, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the parent FirebaseProject in which to create an IosApp,
+        #   in the format: projects/PROJECT_IDENTIFIER/iosApps Refer to the `
+        #   FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER values.
         # @param [Google::Apis::FirebaseV1beta1::IosApp] ios_app_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1068,13 +997,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the IosApp identified by the specified resource name.
+        # Gets the specified IosApp.
         # @param [String] name
-        #   The fully qualified resource name of the App, in the format:
-        #   <code>projects/<var>PROJECT_NUMBER</var>/iosApps/<var>APP_ID</var></code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/iosApps/<var>APP_ID</var></code>
+        #   The resource name of the IosApp, in the format: projects/PROJECT_IDENTIFIER /
+        #   iosApps/APP_ID Since an APP_ID is a unique identifier, the Unique Resource
+        #   from Sub-Collection access pattern may be used here, in the format: projects/-/
+        #   iosApps/APP_ID Refer to the `IosApp` [`name`](../projects.iosApps#IosApp.
+        #   FIELDS.name) field for details about PROJECT_IDENTIFIER and APP_ID values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1105,11 +1034,11 @@ module Google
         # Gets the configuration artifact associated with the specified IosApp.
         # @param [String] name
         #   The resource name of the App configuration to download, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/iosApps/<var>APP_ID</var>/config</
-        #   code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/iosApps/<var>APP_ID</var></code>
+        #   projects/PROJECT_IDENTIFIER/iosApps/APP_ID/config Since an APP_ID is a unique
+        #   identifier, the Unique Resource from Sub-Collection access pattern may be used
+        #   here, in the format: projects/-/iosApps/APP_ID Refer to the `IosApp` [`name`](.
+        #   ./projects.iosApps#IosApp.FIELDS.name) field for details about
+        #   PROJECT_IDENTIFIER and APP_ID values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1137,23 +1066,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists each IosApp associated with the specified parent Project.
-        # <br>
-        # <br>The elements are returned in no particular order, but will be a
-        # consistent view of the Apps when additional requests are made with a
-        # `pageToken`.
+        # Lists each IosApp associated with the specified FirebaseProject. The elements
+        # are returned in no particular order, but will be a consistent view of the Apps
+        # when additional requests are made with a `pageToken`.
         # @param [String] parent
-        #   The parent Project for which to list Apps, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the parent FirebaseProject for which to list each
+        #   associated IosApp, in the format: projects/PROJECT_IDENTIFIER/iosApps Refer to
+        #   the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field
+        #   for details about PROJECT_IDENTIFIER values.
         # @param [Fixnum] page_size
-        #   The maximum number of Apps to return in the response.
-        #   <br>
-        #   <br>The server may return fewer than this at its discretion.
-        #   If no value is specified (or too large a value is specified), the server
-        #   will impose its own limit.
+        #   The maximum number of Apps to return in the response. The server may return
+        #   fewer than this at its discretion. If no value is specified (or too large a
+        #   value is specified), the server will impose its own limit.
         # @param [String] page_token
-        #   Token returned from a previous call to `ListIosApps` indicating where in
-        #   the set of Apps to resume listing.
+        #   Token returned from a previous call to `ListIosApps` indicating where in the
+        #   set of Apps to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1183,16 +1110,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the attributes of the IosApp identified by the specified
-        # resource name.
+        # Updates the attributes of the specified IosApp.
         # @param [String] name
-        #   The fully qualified resource name of the App, in the format:
-        #   <br><code>projects/<var>projectId</var>/iosApps/<var>appId</var></code>
+        #   The resource name of the IosApp, in the format: projects/PROJECT_IDENTIFIER /
+        #   iosApps/APP_ID * PROJECT_IDENTIFIER: the parent Project's [`ProjectNumber`](../
+        #   projects#FirebaseProject.FIELDS.project_number) ***(recommended)*** or its [`
+        #   ProjectId`](../projects#FirebaseProject.FIELDS.project_id). Learn more about
+        #   using project identifiers in Google's [AIP 2510 standard](https://google.aip.
+        #   dev/cloud/2510). Note that the value for PROJECT_IDENTIFIER in any response
+        #   body will be the `ProjectId`. * APP_ID: the globally unique, Firebase-assigned
+        #   identifier for the App (see [`appId`](../projects.iosApps#IosApp.FIELDS.app_id)
+        #   ).
         # @param [Google::Apis::FirebaseV1beta1::IosApp] ios_app_object
         # @param [String] update_mask
-        #   Specifies which fields to update.
-        #   <br>Note that the fields `name`, `appId`, `projectId`, and `bundleId`
-        #   are all immutable.
+        #   Specifies which fields to update. Note that the fields `name`, `appId`, `
+        #   projectId`, and `bundleId` are all immutable.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1223,14 +1155,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests that a new WebApp be created.
-        # <br>
-        # <br>The result of this call is an `Operation` which can be used to track
-        # the provisioning process. The `Operation` is automatically deleted after
+        # Requests the creation of a new WebApp in the specified FirebaseProject. The
+        # result of this call is an `Operation` which can be used to track the
+        # provisioning process. The `Operation` is automatically deleted after
         # completion, so there is no need to call `DeleteOperation`.
         # @param [String] parent
-        #   The parent Project in which to create an App, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the parent FirebaseProject in which to create a WebApp,
+        #   in the format: projects/PROJECT_IDENTIFIER/webApps Refer to the `
+        #   FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for
+        #   details about PROJECT_IDENTIFIER values.
         # @param [Google::Apis::FirebaseV1beta1::WebApp] web_app_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1261,13 +1194,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the WebApp identified by the specified resource name.
+        # Gets the specified WebApp.
         # @param [String] name
-        #   The fully qualified resource name of the App, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/webApps/<var>APP_ID</var></code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/webApps/<var>APP_ID</var></code>
+        #   The resource name of the WebApp, in the format: projects/PROJECT_IDENTIFIER /
+        #   webApps/APP_ID Since an APP_ID is a unique identifier, the Unique Resource
+        #   from Sub-Collection access pattern may be used here, in the format: projects/-/
+        #   webApps/APP_ID Refer to the `WebApp` [`name`](../projects.webApps#WebApp.
+        #   FIELDS.name) field for details about PROJECT_IDENTIFIER and APP_ID values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1297,12 +1230,12 @@ module Google
         
         # Gets the configuration artifact associated with the specified WebApp.
         # @param [String] name
-        #   The resource name of the App configuration to download, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var>/webApps/<var>APP_ID</var>/config</
-        #   code>
-        #   <br>As an <var>APP_ID</var> is a unique identifier, the Unique Resource
-        #   from Sub-Collection access pattern may be used here, in the format:
-        #   <br><code>projects/-/webApps/<var>APP_ID</var></code>
+        #   The resource name of the WebApp configuration to download, in the format:
+        #   projects/PROJECT_IDENTIFIER/webApps/APP_ID/config Since an APP_ID is a unique
+        #   identifier, the Unique Resource from Sub-Collection access pattern may be used
+        #   here, in the format: projects/-/webApps/APP_ID Refer to the `WebApp` [`name`](.
+        #   ./projects.webApps#WebApp.FIELDS.name) field for details about
+        #   PROJECT_IDENTIFIER and APP_ID values.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1330,23 +1263,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists each WebApp associated with the specified parent Project.
-        # <br>
-        # <br>The elements are returned in no particular order, but will be a
-        # consistent view of the Apps when additional requests are made with a
-        # `pageToken`.
+        # Lists each WebApp associated with the specified FirebaseProject. The elements
+        # are returned in no particular order, but will be a consistent view of the Apps
+        # when additional requests are made with a `pageToken`.
         # @param [String] parent
-        #   The parent Project for which to list Apps, in the format:
-        #   <br><code>projects/<var>PROJECT_NUMBER</var></code>
+        #   The resource name of the parent FirebaseProject for which to list each
+        #   associated WebApp, in the format: projects/PROJECT_IDENTIFIER/webApps Refer to
+        #   the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field
+        #   for details about PROJECT_IDENTIFIER values.
         # @param [Fixnum] page_size
-        #   The maximum number of Apps to return in the response.
-        #   <br>
-        #   <br>The server may return fewer than this value at its discretion.
-        #   If no value is specified (or too large a value is specified), then the
-        #   server will impose its own limit.
+        #   The maximum number of Apps to return in the response. The server may return
+        #   fewer than this value at its discretion. If no value is specified (or too
+        #   large a value is specified), then the server will impose its own limit.
         # @param [String] page_token
-        #   Token returned from a previous call to `ListWebApps` indicating where in
-        #   the set of Apps to resume listing.
+        #   Token returned from a previous call to `ListWebApps` indicating where in the
+        #   set of Apps to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1376,16 +1307,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the attributes of the WebApp identified by the specified
-        # resource name.
+        # Updates the attributes of the specified WebApp.
         # @param [String] name
-        #   The fully qualified resource name of the App, for example:
-        #   <br><code>projects/<var>projectId</var>/webApps/<var>appId</var></code>
+        #   The resource name of the WebApp, in the format: projects/PROJECT_IDENTIFIER /
+        #   webApps/APP_ID * PROJECT_IDENTIFIER: the parent Project's [`ProjectNumber`](../
+        #   projects#FirebaseProject.FIELDS.project_number) ***(recommended)*** or its [`
+        #   ProjectId`](../projects#FirebaseProject.FIELDS.project_id). Learn more about
+        #   using project identifiers in Google's [AIP 2510 standard](https://google.aip.
+        #   dev/cloud/2510). Note that the value for PROJECT_IDENTIFIER in any response
+        #   body will be the `ProjectId`. * APP_ID: the globally unique, Firebase-assigned
+        #   identifier for the App (see [`appId`](../projects.webApps#WebApp.FIELDS.app_id)
+        #   ).
         # @param [Google::Apis::FirebaseV1beta1::WebApp] web_app_object
         # @param [String] update_mask
-        #   Specifies which fields to update.
-        #   <br>Note that the fields `name`, `appId`, and `projectId` are all
-        #   immutable.
+        #   Specifies which fields to update. Note that the fields `name`, `appId`, and `
+        #   projectId` are all immutable.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user