google-apis-firebasehosting_v1beta1 0.1.0 → 0.6.0

data/lib/google/apis/firebasehosting_v1beta1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FirebasehostingV1beta1
       # Version of the google-apis-firebasehosting_v1beta1 gem
-      GEM_VERSION = "0.1.0"
+      GEM_VERSION = "0.6.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.1.1"
+      GENERATOR_VERSION = "0.2.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20201024"
+      REVISION = "20210415"
     end
   end
 end

data/lib/google/apis/firebasehosting_v1beta1/representations.rb

@@ -112,6 +112,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListSitesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListVersionFilesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -178,6 +184,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Site
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SiteConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -349,6 +361,15 @@ module Google
         end
       end
       
+      class ListSitesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :sites, as: 'sites', class: Google::Apis::FirebasehostingV1beta1::Site, decorator: Google::Apis::FirebasehostingV1beta1::Site::Representation
+      
+        end
+      end
+      
       class ListVersionFilesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -463,6 +484,17 @@ module Google
         end
       end
       
+      class Site
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :app_id, as: 'appId'
+          property :default_url, as: 'defaultUrl'
+          hash :labels, as: 'labels'
+          property :name, as: 'name'
+          property :type, as: 'type'
+        end
+      end
+      
       class SiteConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/firebasehosting_v1beta1/service.rb

@@ -22,9 +22,10 @@ module Google
     module FirebasehostingV1beta1
       # Firebase Hosting API
       #
-      # The Firebase Hosting REST API enables programmatic and customizable
-      #  deployments to your Firebase-hosted sites. Use this REST API to deploy new or
-      #  updated hosting configurations and content files.
+      # The Firebase Hosting REST API enables programmatic and customizable management
+      #  and deployments to your Firebase-hosted sites. Use this REST API to create and
+      #  manage channels and sites as well as to deploy new or updated hosting
+      #  configurations and content files.
       #
       # @example
       #    require 'google/apis/firebasehosting_v1beta1'
@@ -82,6 +83,115 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new Hosting Site in the specified parent Firebase project. Note that
+        # Hosting sites can take several minutes to propagate through Firebase systems.
+        # @param [String] parent
+        #   Required. The Firebase project in which to create a Hosting site, in the
+        #   format: projects/PROJECT_IDENTIFIER Refer to the `Site` [`name`](../projects#
+        #   Site.FIELDS.name) field for details about PROJECT_IDENTIFIER values.
+        # @param [Google::Apis::FirebasehostingV1beta1::Site] site_object
+        # @param [String] site_id
+        #   Required. Immutable. A globally unique identifier for the Hosting site. This
+        #   identifier is used to construct the Firebase-provisioned subdomains for the
+        #   site, so it must also be a valid domain name label.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasehostingV1beta1::Site] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasehostingV1beta1::Site]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_project_site(parent, site_object = nil, site_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+parent}/sites', options)
+          command.request_representation = Google::Apis::FirebasehostingV1beta1::Site::Representation
+          command.request_object = site_object
+          command.response_representation = Google::Apis::FirebasehostingV1beta1::Site::Representation
+          command.response_class = Google::Apis::FirebasehostingV1beta1::Site
+          command.params['parent'] = parent unless parent.nil?
+          command.query['siteId'] = site_id unless site_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes the specified Hosting Site from the specified parent Firebase project.
+        # @param [String] name
+        #   Required. The fully-qualified resource name for the Hosting site, in the
+        #   format: projects/PROJECT_IDENTIFIER/sites/SITE_ID Refer to the `Site` [`name`](
+        #   ../projects#Site.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
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasehostingV1beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasehostingV1beta1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_project_site(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1beta1/{+name}', options)
+          command.response_representation = Google::Apis::FirebasehostingV1beta1::Empty::Representation
+          command.response_class = Google::Apis::FirebasehostingV1beta1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the specified Hosting Site.
+        # @param [String] name
+        #   Required. The fully-qualified resource name for the Hosting site, in the
+        #   format: projects/PROJECT_IDENTIFIER/sites/SITE_ID Refer to the `Site` [`name`](
+        #   ../projects#Site.FIELDS.name) field for details about PROJECT_IDENTIFIER
+        #   values. Since a SITE_ID is a globally unique identifier, you can also use the
+        #   unique sub-collection resource access pattern, in the format: projects/-/sites/
+        #   SITE_ID
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasehostingV1beta1::Site] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasehostingV1beta1::Site]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_site(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}', options)
+          command.response_representation = Google::Apis::FirebasehostingV1beta1::Site::Representation
+          command.response_class = Google::Apis::FirebasehostingV1beta1::Site
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the Hosting metadata for a specific site.
         # @param [String] name
         #   Required. The site for which to get the SiteConfig, in the format: sites/ site-
@@ -113,6 +223,90 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists each Hosting Site associated with the specified parent Firebase project.
+        # @param [String] parent
+        #   Required. The Firebase project for which to list sites, in the format:
+        #   projects/PROJECT_IDENTIFIER Refer to the `Site` [`name`](../projects#Site.
+        #   FIELDS.name) field for details about PROJECT_IDENTIFIER values.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of sites to return. The service may return a
+        #   lower number if fewer sites exist than this maximum number. If unspecified,
+        #   defaults to 40.
+        # @param [String] page_token
+        #   Optional. A token from a previous call to `ListSites` that tells the server
+        #   where to resume listing.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasehostingV1beta1::ListSitesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasehostingV1beta1::ListSitesResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_sites(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+parent}/sites', options)
+          command.response_representation = Google::Apis::FirebasehostingV1beta1::ListSitesResponse::Representation
+          command.response_class = Google::Apis::FirebasehostingV1beta1::ListSitesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates attributes of the specified Hosting Site.
+        # @param [String] name
+        #   Output only. The fully-qualified resource name of the Hosting site, in the
+        #   format: projects/PROJECT_IDENTIFIER/sites/SITE_ID PROJECT_IDENTIFIER: the
+        #   Firebase project's [`ProjectNumber`](https://firebase.google.com/docs/projects/
+        #   api/reference/rest/v1beta1/projects#FirebaseProject.FIELDS.project_number) ***(
+        #   recommended)*** or its [`ProjectId`](https://firebase.google.com/docs/projects/
+        #   api/reference/rest/v1beta1/projects#FirebaseProject.FIELDS.project_id). Learn
+        #   more about using project identifiers in Google's [AIP 2510 standard](https://
+        #   google.aip.dev/cloud/2510).
+        # @param [Google::Apis::FirebasehostingV1beta1::Site] site_object
+        # @param [String] update_mask
+        #   A set of field names from your Site that you want to update.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasehostingV1beta1::Site] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasehostingV1beta1::Site]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_project_site(name, site_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1beta1/{+name}', options)
+          command.request_representation = Google::Apis::FirebasehostingV1beta1::Site::Representation
+          command.request_object = site_object
+          command.response_representation = Google::Apis::FirebasehostingV1beta1::Site::Representation
+          command.response_class = Google::Apis::FirebasehostingV1beta1::Site
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Sets the Hosting metadata for a specific site.
         # @param [String] name
         #   Required. The site for which to update the SiteConfig, in the format: sites/
@@ -155,10 +349,11 @@ module Google
         
         # Creates a new channel in the specified site.
         # @param [String] parent
-        #   Required. The site in which this channel should be created.
+        #   Required. The site in which to create this channel, in the format: sites/
+        #   SITE_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Channel] channel_object
         # @param [String] channel_id
-        #   Required. Immutable. A unique id within the site to identify the channel.
+        #   Required. Immutable. A unique ID within the site that identifies the channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -189,9 +384,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a channel of a site. The `live` channel cannot be deleted.
+        # Deletes the specified channel of the specified site. The `live` channel cannot
+        # be deleted.
         # @param [String] name
-        #   Required. The fully-qualified identifier for the site.
+        #   Required. The fully-qualified resource name for the channel, in the format:
+        #   sites/SITE_ID/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -219,9 +416,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves information for the specified channel of a site.
+        # Retrieves information for the specified channel of the specified site.
         # @param [String] name
-        #   Required. The fully-qualified identifier for the channel.
+        #   Required. The fully-qualified resource name for the channel, in the format:
+        #   sites/SITE_ID/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -249,16 +447,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the channels for the specified site. All sites have a default "live"
+        # Lists the channels for the specified site. All sites have a default `live`
         # channel.
         # @param [String] parent
-        #   Required. The site from which to list channels.
+        #   Required. The site for which to list channels, in the format: sites/SITE_ID
         # @param [Fixnum] page_size
-        #   The maximum number of versions to return. The service may return fewer than
-        #   this value. If unspecified, at most 25 channels will be returned. The maximum
-        #   value is 100; valuupdateses above 100 will be coerced to 100
+        #   The maximum number of channels to return. The service may return a lower
+        #   number if fewer channels exist than this maximum number. If unspecified,
+        #   defaults to 10. The maximum value is 100; values above 100 will be coerced to
+        #   100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `ListChannels` that tells the server where to
+        #   resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -288,10 +488,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates information for the specified channel of a site. This method will
-        # implicitly create a channel if it doesn't exist.
+        # Updates information for the specified channel of the specified site.
+        # Implicitly creates the channel if it doesn't already exist.
         # @param [String] name
-        #   The fully-qualified identifier of the Channel.
+        #   The fully-qualified resource name for the channel, in the format: sites/
+        #   SITE_ID/channels/CHANNEL_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Channel] channel_object
         # @param [String] update_mask
         #   A comma-separated list of fields to be updated in this request.
@@ -325,15 +526,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new release which makes the content of the specified version
+        # Creates a new release, which makes the content of the specified version
         # actively display on the appropriate URL(s).
         # @param [String] parent
-        #   Required. The site that the release belongs to, in the format: sites/ site-
-        #   name
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Release] release_object
         # @param [String] version_name
-        #   The unique identifier for a version, in the format: /sites/site-name /versions/
-        #   versionID The site-name in this version identifier must match the site-name in
+        #   The unique identifier for a version, in the format: sites/SITE_ID/versions/
+        #   VERSION_ID The SITE_ID in this version identifier must match the SITE_ID in
         #   the `parent` parameter. This query parameter must be empty if the `type` field
         #   in the request body is `SITE_DISABLE`.
         # @param [String] fields
@@ -366,13 +567,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the releases that have been created on the specified site.
+        # Lists the releases that have been created for the specified site or channel.
+        # When used to list releases for a site, this list includes releases for both
+        # the default `live` channel and any active preview channels for the specified
+        # site.
         # @param [String] parent
-        #   Required. The parent for which to list files, in the format: sites/site-name
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Fixnum] page_size
-        #   The page size to return. Defaults to 100.
+        #   The maximum number of releases to return. The service may return a lower
+        #   number if fewer releases exist than this maximum number. If unspecified,
+        #   defaults to 100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `releases.list` or `channels.releases.list`
+        #   that tells the server where to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -568,15 +776,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new release which makes the content of the specified version
+        # Creates a new release, which makes the content of the specified version
         # actively display on the appropriate URL(s).
         # @param [String] parent
-        #   Required. The site that the release belongs to, in the format: sites/ site-
-        #   name
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Release] release_object
         # @param [String] version_name
-        #   The unique identifier for a version, in the format: /sites/site-name /versions/
-        #   versionID The site-name in this version identifier must match the site-name in
+        #   The unique identifier for a version, in the format: sites/SITE_ID/versions/
+        #   VERSION_ID The SITE_ID in this version identifier must match the SITE_ID in
         #   the `parent` parameter. This query parameter must be empty if the `type` field
         #   in the request body is `SITE_DISABLE`.
         # @param [String] fields
@@ -609,13 +817,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the releases that have been created on the specified site.
+        # Lists the releases that have been created for the specified site or channel.
+        # When used to list releases for a site, this list includes releases for both
+        # the default `live` channel and any active preview channels for the specified
+        # site.
         # @param [String] parent
-        #   Required. The parent for which to list files, in the format: sites/site-name
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Fixnum] page_size
-        #   The page size to return. Defaults to 100.
+        #   The maximum number of releases to return. The service may return a lower
+        #   number if fewer releases exist than this maximum number. If unspecified,
+        #   defaults to 100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `releases.list` or `channels.releases.list`
+        #   that tells the server where to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -645,11 +860,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new version on the target site using the content of the specified
-        # version.
+        # Creates a new version on the specified target site using the content of the
+        # specified version.
         # @param [String] parent
-        #   Required. The target site where the cloned version will reside, in the format:
-        #   `sites/`site``
+        #   Required. The target site for the cloned version, in the format: sites/
+        #   SITE_ID
         # @param [Google::Apis::FirebasehostingV1beta1::CloneVersionRequest] clone_version_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -680,10 +895,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new version for a site.
+        # Creates a new version for the specified site.
         # @param [String] parent
-        #   Required. The parent to create the version for, in the format: sites/ site-
-        #   name
+        #   Required. The site in which to create the version, in the format: sites/
+        #   SITE_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Version] version_object
         # @param [Fixnum] size_bytes
         #   The self-reported size of the version. This value is used for a pre-emptive
@@ -724,8 +939,8 @@ module Google
         
         # Deletes the specified version.
         # @param [String] name
-        #   Required. The name of the version to be deleted, in the format: sites/ site-
-        #   name/versions/versionID
+        #   Required. The fully-qualified resource name for the version, in the format:
+        #   sites/SITE_ID/versions/VERSION_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -753,20 +968,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the versions that have been created on the specified site. Will include
-        # filtering in the future.
+        # Lists the versions that have been created for the specified site. This list
+        # includes versions for both the default `live` channel and any active preview
+        # channels for the specified site.
         # @param [String] parent
-        #   Required. The parent for which to list files, in the format: sites/site-name
+        #   Required. The site or channel for which to list versions, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [String] filter
-        #   The filter string used to return a subset of versions in the response.
-        #   Currently supported fields for filtering are: name, status, and create_time.
-        #   Filter processing will be implemented in accordance with go/filtering.
+        #   A filter string used to return a subset of versions in the response. The
+        #   currently supported fields for filtering are: `name`, `status`, and `
+        #   create_time`. Learn more about filtering in Google's [AIP 160 standard](https:/
+        #   /google.aip.dev/160).
         # @param [Fixnum] page_size
-        #   The maximum number of versions to return. The service may return fewer than
-        #   this value. If unspecified, at most 25 versions will be returned. The maximum
-        #   value is 100; values above 100 will be coerced to 100
+        #   The maximum number of versions to return. The service may return a lower
+        #   number if fewer versions exist than this maximum number. If unspecified,
+        #   defaults to 25. The maximum value is 100; values above 100 will be coerced to
+        #   100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `ListVersions` that tells the server where to
+        #   resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -797,15 +1017,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified metadata for a version. Note that this method will fail
-        # with `FAILED_PRECONDITION` in the event of an invalid state transition. The
-        # only valid transition for a version is currently from a `CREATED` status to a `
-        # FINALIZED` status. Use [`DeleteVersion`](../sites.versions/delete) to set the
-        # status of a version to `DELETED`.
+        # Updates the specified metadata for the specified version. This method will
+        # fail with `FAILED_PRECONDITION` in the event of an invalid state transition.
+        # The supported [state](../sites.versions#versionstatus) transitions for a
+        # version are from `CREATED` to `FINALIZED`. Use [`DeleteVersion`](delete) to
+        # set the status of a version to `DELETED`.
         # @param [String] name
-        #   The unique identifier for a version, in the format: sites/site-name /versions/
-        #   versionID This name is provided in the response body when you call the [`
-        #   CreateVersion`](../sites.versions/create) endpoint.
+        #   The fully-qualified resource name for the version, in the format: sites/
+        #   SITE_ID/versions/VERSION_ID This name is provided in the response body when
+        #   you call [`CreateVersion`](sites.versions/create).
         # @param [Google::Apis::FirebasehostingV1beta1::Version] version_object
         # @param [String] update_mask
         #   A set of field names from your [version](../sites.versions) that you want to
@@ -842,10 +1062,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds content files to a version. Each file must be under 2 GB.
+        # Adds content files to the specified version. Each file must be under 2 GB.
         # @param [String] parent
-        #   Required. The version to add files to, in the format: sites/site-name /
-        #   versions/versionID
+        #   Required. The version to which to add files, in the format: sites/SITE_ID /
+        #   versions/VERSION_ID
         # @param [Google::Apis::FirebasehostingV1beta1::PopulateVersionFilesRequest] populate_version_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -878,15 +1098,17 @@ module Google
         
         # Lists the remaining files to be uploaded for the specified version.
         # @param [String] parent
-        #   Required. The parent to list files for, in the format: sites/site-name /
-        #   versions/versionID
+        #   Required. The version for which to list files, in the format: sites/SITE_ID /
+        #   versions/VERSION_ID
         # @param [Fixnum] page_size
-        #   The page size to return. Defaults to 1000.
+        #   The maximum number of version files to return. The service may return a lower
+        #   number if fewer version files exist than this maximum number. If unspecified,
+        #   defaults to 1000.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided. This will be the
-        #   encoded version of a firebase.hosting.proto.metadata.ListFilesPageToken.
+        #   A token from a previous call to `ListVersionFiles` that tells the server where
+        #   to resume listing.
         # @param [String] status
-        #   The type of files in the version that should be listed.
+        #   The type of files that should be listed for the specified version.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -990,10 +1212,11 @@ module Google
         
         # Creates a new channel in the specified site.
         # @param [String] parent
-        #   Required. The site in which this channel should be created.
+        #   Required. The site in which to create this channel, in the format: sites/
+        #   SITE_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Channel] channel_object
         # @param [String] channel_id
-        #   Required. Immutable. A unique id within the site to identify the channel.
+        #   Required. Immutable. A unique ID within the site that identifies the channel.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1024,9 +1247,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a channel of a site. The `live` channel cannot be deleted.
+        # Deletes the specified channel of the specified site. The `live` channel cannot
+        # be deleted.
         # @param [String] name
-        #   Required. The fully-qualified identifier for the site.
+        #   Required. The fully-qualified resource name for the channel, in the format:
+        #   sites/SITE_ID/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1054,9 +1279,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves information for the specified channel of a site.
+        # Retrieves information for the specified channel of the specified site.
         # @param [String] name
-        #   Required. The fully-qualified identifier for the channel.
+        #   Required. The fully-qualified resource name for the channel, in the format:
+        #   sites/SITE_ID/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1084,16 +1310,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the channels for the specified site. All sites have a default "live"
+        # Lists the channels for the specified site. All sites have a default `live`
         # channel.
         # @param [String] parent
-        #   Required. The site from which to list channels.
+        #   Required. The site for which to list channels, in the format: sites/SITE_ID
         # @param [Fixnum] page_size
-        #   The maximum number of versions to return. The service may return fewer than
-        #   this value. If unspecified, at most 25 channels will be returned. The maximum
-        #   value is 100; valuupdateses above 100 will be coerced to 100
+        #   The maximum number of channels to return. The service may return a lower
+        #   number if fewer channels exist than this maximum number. If unspecified,
+        #   defaults to 10. The maximum value is 100; values above 100 will be coerced to
+        #   100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `ListChannels` that tells the server where to
+        #   resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1123,10 +1351,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates information for the specified channel of a site. This method will
-        # implicitly create a channel if it doesn't exist.
+        # Updates information for the specified channel of the specified site.
+        # Implicitly creates the channel if it doesn't already exist.
         # @param [String] name
-        #   The fully-qualified identifier of the Channel.
+        #   The fully-qualified resource name for the channel, in the format: sites/
+        #   SITE_ID/channels/CHANNEL_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Channel] channel_object
         # @param [String] update_mask
         #   A comma-separated list of fields to be updated in this request.
@@ -1160,15 +1389,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new release which makes the content of the specified version
+        # Creates a new release, which makes the content of the specified version
         # actively display on the appropriate URL(s).
         # @param [String] parent
-        #   Required. The site that the release belongs to, in the format: sites/ site-
-        #   name
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Release] release_object
         # @param [String] version_name
-        #   The unique identifier for a version, in the format: /sites/site-name /versions/
-        #   versionID The site-name in this version identifier must match the site-name in
+        #   The unique identifier for a version, in the format: sites/SITE_ID/versions/
+        #   VERSION_ID The SITE_ID in this version identifier must match the SITE_ID in
         #   the `parent` parameter. This query parameter must be empty if the `type` field
         #   in the request body is `SITE_DISABLE`.
         # @param [String] fields
@@ -1201,13 +1430,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the releases that have been created on the specified site.
+        # Lists the releases that have been created for the specified site or channel.
+        # When used to list releases for a site, this list includes releases for both
+        # the default `live` channel and any active preview channels for the specified
+        # site.
         # @param [String] parent
-        #   Required. The parent for which to list files, in the format: sites/site-name
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Fixnum] page_size
-        #   The page size to return. Defaults to 100.
+        #   The maximum number of releases to return. The service may return a lower
+        #   number if fewer releases exist than this maximum number. If unspecified,
+        #   defaults to 100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `releases.list` or `channels.releases.list`
+        #   that tells the server where to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1403,15 +1639,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new release which makes the content of the specified version
+        # Creates a new release, which makes the content of the specified version
         # actively display on the appropriate URL(s).
         # @param [String] parent
-        #   Required. The site that the release belongs to, in the format: sites/ site-
-        #   name
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Release] release_object
         # @param [String] version_name
-        #   The unique identifier for a version, in the format: /sites/site-name /versions/
-        #   versionID The site-name in this version identifier must match the site-name in
+        #   The unique identifier for a version, in the format: sites/SITE_ID/versions/
+        #   VERSION_ID The SITE_ID in this version identifier must match the SITE_ID in
         #   the `parent` parameter. This query parameter must be empty if the `type` field
         #   in the request body is `SITE_DISABLE`.
         # @param [String] fields
@@ -1444,13 +1680,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the releases that have been created on the specified site.
+        # Lists the releases that have been created for the specified site or channel.
+        # When used to list releases for a site, this list includes releases for both
+        # the default `live` channel and any active preview channels for the specified
+        # site.
         # @param [String] parent
-        #   Required. The parent for which to list files, in the format: sites/site-name
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [Fixnum] page_size
-        #   The page size to return. Defaults to 100.
+        #   The maximum number of releases to return. The service may return a lower
+        #   number if fewer releases exist than this maximum number. If unspecified,
+        #   defaults to 100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `releases.list` or `channels.releases.list`
+        #   that tells the server where to resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1480,11 +1723,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new version on the target site using the content of the specified
-        # version.
+        # Creates a new version on the specified target site using the content of the
+        # specified version.
         # @param [String] parent
-        #   Required. The target site where the cloned version will reside, in the format:
-        #   `sites/`site``
+        #   Required. The target site for the cloned version, in the format: sites/
+        #   SITE_ID
         # @param [Google::Apis::FirebasehostingV1beta1::CloneVersionRequest] clone_version_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1515,10 +1758,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new version for a site.
+        # Creates a new version for the specified site.
         # @param [String] parent
-        #   Required. The parent to create the version for, in the format: sites/ site-
-        #   name
+        #   Required. The site in which to create the version, in the format: sites/
+        #   SITE_ID
         # @param [Google::Apis::FirebasehostingV1beta1::Version] version_object
         # @param [Fixnum] size_bytes
         #   The self-reported size of the version. This value is used for a pre-emptive
@@ -1559,8 +1802,8 @@ module Google
         
         # Deletes the specified version.
         # @param [String] name
-        #   Required. The name of the version to be deleted, in the format: sites/ site-
-        #   name/versions/versionID
+        #   Required. The fully-qualified resource name for the version, in the format:
+        #   sites/SITE_ID/versions/VERSION_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1588,20 +1831,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the versions that have been created on the specified site. Will include
-        # filtering in the future.
+        # Lists the versions that have been created for the specified site. This list
+        # includes versions for both the default `live` channel and any active preview
+        # channels for the specified site.
         # @param [String] parent
-        #   Required. The parent for which to list files, in the format: sites/site-name
+        #   Required. The site or channel for which to list versions, in either of the
+        #   following formats: - sites/SITE_ID - sites/SITE_ID/channels/CHANNEL_ID
         # @param [String] filter
-        #   The filter string used to return a subset of versions in the response.
-        #   Currently supported fields for filtering are: name, status, and create_time.
-        #   Filter processing will be implemented in accordance with go/filtering.
+        #   A filter string used to return a subset of versions in the response. The
+        #   currently supported fields for filtering are: `name`, `status`, and `
+        #   create_time`. Learn more about filtering in Google's [AIP 160 standard](https:/
+        #   /google.aip.dev/160).
         # @param [Fixnum] page_size
-        #   The maximum number of versions to return. The service may return fewer than
-        #   this value. If unspecified, at most 25 versions will be returned. The maximum
-        #   value is 100; values above 100 will be coerced to 100
+        #   The maximum number of versions to return. The service may return a lower
+        #   number if fewer versions exist than this maximum number. If unspecified,
+        #   defaults to 25. The maximum value is 100; values above 100 will be coerced to
+        #   100.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided.
+        #   A token from a previous call to `ListVersions` that tells the server where to
+        #   resume listing.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1632,15 +1880,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified metadata for a version. Note that this method will fail
-        # with `FAILED_PRECONDITION` in the event of an invalid state transition. The
-        # only valid transition for a version is currently from a `CREATED` status to a `
-        # FINALIZED` status. Use [`DeleteVersion`](../sites.versions/delete) to set the
-        # status of a version to `DELETED`.
+        # Updates the specified metadata for the specified version. This method will
+        # fail with `FAILED_PRECONDITION` in the event of an invalid state transition.
+        # The supported [state](../sites.versions#versionstatus) transitions for a
+        # version are from `CREATED` to `FINALIZED`. Use [`DeleteVersion`](delete) to
+        # set the status of a version to `DELETED`.
         # @param [String] name
-        #   The unique identifier for a version, in the format: sites/site-name /versions/
-        #   versionID This name is provided in the response body when you call the [`
-        #   CreateVersion`](../sites.versions/create) endpoint.
+        #   The fully-qualified resource name for the version, in the format: sites/
+        #   SITE_ID/versions/VERSION_ID This name is provided in the response body when
+        #   you call [`CreateVersion`](sites.versions/create).
         # @param [Google::Apis::FirebasehostingV1beta1::Version] version_object
         # @param [String] update_mask
         #   A set of field names from your [version](../sites.versions) that you want to
@@ -1677,10 +1925,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds content files to a version. Each file must be under 2 GB.
+        # Adds content files to the specified version. Each file must be under 2 GB.
         # @param [String] parent
-        #   Required. The version to add files to, in the format: sites/site-name /
-        #   versions/versionID
+        #   Required. The version to which to add files, in the format: sites/SITE_ID /
+        #   versions/VERSION_ID
         # @param [Google::Apis::FirebasehostingV1beta1::PopulateVersionFilesRequest] populate_version_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1713,15 +1961,17 @@ module Google
         
         # Lists the remaining files to be uploaded for the specified version.
         # @param [String] parent
-        #   Required. The parent to list files for, in the format: sites/site-name /
-        #   versions/versionID
+        #   Required. The version for which to list files, in the format: sites/SITE_ID /
+        #   versions/VERSION_ID
         # @param [Fixnum] page_size
-        #   The page size to return. Defaults to 1000.
+        #   The maximum number of version files to return. The service may return a lower
+        #   number if fewer version files exist than this maximum number. If unspecified,
+        #   defaults to 1000.
         # @param [String] page_token
-        #   The next_page_token from a previous request, if provided. This will be the
-        #   encoded version of a firebase.hosting.proto.metadata.ListFilesPageToken.
+        #   A token from a previous call to `ListVersionFiles` that tells the server where
+        #   to resume listing.
         # @param [String] status
-        #   The type of files in the version that should be listed.
+        #   The type of files that should be listed for the specified version.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user