RubyGems - google-apis-firebasehosting_v1beta1 - Versions diffs - 0.2.0 → 0.3.0 - Mend

google-apis-firebasehosting_v1beta1 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +4 -0
data/lib/google/apis/firebasehosting_v1beta1/classes.rb +45 -37
data/lib/google/apis/firebasehosting_v1beta1/gem_version.rb +2 -2
data/lib/google/apis/firebasehosting_v1beta1/service.rb +136 -96
metadata +5 -5

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 844401c7c68444118d1899dbaf94e935379797e0ba22c708392106abafa8831f
-  data.tar.gz: 5cfeef0f4c7d1bd1da4ac70fdc86f5c487ace7d561417869e77ebf038fb156a3
+  metadata.gz: c4f3dfc0caa4eaab3f06ba10e98a992db9c9dcbb2698ce2d0c004226b47cc06a
+  data.tar.gz: e3a16aa467f6091ffa22a14cc397b0cf77c1b2004277be8fdc290c0adbd1b806
 SHA512:
-  metadata.gz: 3e24c6adfb7ceccd8c5f85074104e54db63ed2f5f3c91d06e7583aa0d41d44b715088e14cac96cfc86d7e07ee872d0c10ddc57b2b16c7f9a428636a89247a34b
-  data.tar.gz: 29d99d40d2059c79a642b8215bdddf30f6dfedd19bd95f7759fdbef2c7fedb9e603fb6cdcf5bda7e7cbfd5ef705bf0e880e746448f6135323772520e770c860e
+  metadata.gz: 9d0672c3a68e1d5e9199c71ab454d9285875edb798990078b7779356f5e2b8bf26a07ad8397354260c04196aa2f3ae0749fee802a10c844c8c83410cfcc6502b
+  data.tar.gz: f077a396a1547a8073bcd97820e8833efcc91d887276ab71ceaa5a99170b82587a5882ea9bebf388740f09674c1c05da3d715504fba0b81b8ff47902bcd21bcf

data/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,9 @@
 # Release history for google-apis-firebasehosting_v1beta1
+### v0.3.0 (2021-03-04)
+* Regenerated from discovery document revision 20210303
 ### v0.2.0 (2021-02-02)
 * Regenerated from discovery document revision 20210129

data/lib/google/apis/firebasehosting_v1beta1/classes.rb CHANGED Viewed

@@ -103,8 +103,8 @@ module Google
       end
       # A `Channel` represents a stream of releases for a site. All sites have a
-      # default `live` channel that serves content to the live Firebase-provided
-      # domains and any connected custom domains.
+      # default `live` channel that serves content to the Firebase-provided subdomains
+      # and any connected custom domains.
       class Channel
         include Google::Apis::Core::Hashable
@@ -114,8 +114,8 @@ module Google
         attr_accessor :create_time
         # The time at which the channel will be automatically deleted. If null, the
-        # channel will not be automatically deleted. This field is present in output
-        # whether set directly or via the `ttl` field.
+        # channel will not be automatically deleted. This field is present in the output
+        # whether it's set directly or via the `ttl` field.
         # Corresponds to the JSON property `expireTime`
         # @return [String]
         attr_accessor :expire_time
@@ -125,7 +125,8 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # The fully-qualified identifier of the Channel.
+        # The fully-qualified identifier for the channel, in the format: sites/
+        # SITE_NAME/channels/CHANNEL_ID
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -153,8 +154,12 @@ module Google
         # @return [String]
         attr_accessor :update_time
-        # Output only. The URL at which the channel can be viewed. For the `live`
-        # channel, the content of the current release may also be visible at other URLs.
+        # Output only. The URL at which the content of this channel's current release
+        # can be viewed. This URL is a Firebase-provided subdomain of `web.app`. The
+        # content of this channel's current release can also be viewed at the Firebase-
+        # provided subdomain of `firebaseapp.com`. If this channel is the `live` channel
+        # for the Hosting site, then the content of this channel's current release can
+        # also be viewed at any connected custom domains.
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -177,7 +182,7 @@ module Google
         end
       end
-      # The request sent to CloneVersion.
+      #
       class CloneVersionRequest
         include Google::Apis::Core::Hashable
@@ -186,7 +191,10 @@ module Google
         # @return [Google::Apis::FirebasehostingV1beta1::PathFilter]
         attr_accessor :exclude
-        # If true, immediately finalize the version after cloning is complete.
+        # If true, the call to `CloneVersion` immediately finalizes the version after
+        # cloning is complete. If false, the cloned version will have a status of `
+        # CREATED`. Use [`UpdateVersion`](patch) to set the status of the version to `
+        # FINALIZED`.
         # Corresponds to the JSON property `finalize`
         # @return [Boolean]
         attr_accessor :finalize
@@ -197,8 +205,8 @@ module Google
         # @return [Google::Apis::FirebasehostingV1beta1::PathFilter]
         attr_accessor :include
-        # Required. The name of the version to be cloned, in the format: `sites/`site`/
-        # versions/`version``
+        # Required. The unique identifier for the version to be cloned, in the format:
+        # sites/SITE_NAME/versions/VERSION_ID
         # Corresponds to the JSON property `sourceVersion`
         # @return [String]
         attr_accessor :source_version
@@ -458,7 +466,7 @@ module Google
         end
       end
-      # The response returned by ListChannels.
+      #
       class ListChannelsResponse
         include Google::Apis::Core::Hashable
@@ -467,9 +475,9 @@ module Google
         # @return [Array<Google::Apis::FirebasehostingV1beta1::Channel>]
         attr_accessor :channels
-        # If there are additional releases remaining beyond the ones in this response,
-        # then supply this token in the next [`list`](../sites.channels/list) call to
-        # continue with the next set of releases.
+        # The pagination token, if more results exist beyond the ones in this response.
+        # Include this token in your next call to `ListChannels`. Page tokens are short-
+        # lived and should not be stored.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -568,7 +576,9 @@ module Google
       class ListVersionsResponse
         include Google::Apis::Core::Hashable
-        # The pagination token, if more results exist
+        # The pagination token, if more results exist beyond the ones in this response.
+        # Include this token in your next call to `ListVersions`. Page tokens are short-
+        # lived and should not be stored.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -655,7 +665,7 @@ module Google
       class PathFilter
         include Google::Apis::Core::Hashable
-        # An array of regexes to filter by.
+        # An array of RegEx values by which to filter.
         # Corresponds to the JSON property `regexes`
         # @return [Array<String>]
         attr_accessor :regexes
@@ -721,9 +731,7 @@ module Google
         end
       end
-      # Version preview configuration. If active and unexpired, this version will be
-      # accessible via a custom URL even if it is not the currently released version.
-      # Deprecated in favor of site channels.
+      # Deprecated in favor of [site channels](sites.channels).
       class PreviewConfig
         include Google::Apis::Core::Hashable
@@ -806,9 +814,11 @@ module Google
         # @return [String]
         attr_accessor :message
-        # Output only. The unique identifier for the release, in the format: sites/
-        # SITE_NAME/releases/RELEASE_ID This name is provided in the response body when
-        # you call [`CreateRelease`](sites.releases/create).
+        # Output only. The unique identifier for the release, in either of the following
+        # formats: - sites/SITE_NAME/releases/RELEASE_ID - sites/SITE_NAME/channels/
+        # CHANNEL_ID/releases/RELEASE_ID This name is provided in the response body when
+        # you call [`releases.create`](sites.releases/create) or [`channels.releases.
+        # create`](sites.channels.releases/create).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1103,28 +1113,26 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # The unique identifier for a version, in the format: sites/SITE_NAME /versions/
-        # VERSION_ID This name is provided in the response body when you call [`
-        # CreateVersion`](sites.versions/create).
+        # The fully-qualified identifier for the version, in the format: sites/
+        # SITE_NAME/versions/VERSION_ID This name is provided in the response body when
+        # you call [`CreateVersion`](sites.versions/create).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # Version preview configuration. If active and unexpired, this version will be
-        # accessible via a custom URL even if it is not the currently released version.
-        # Deprecated in favor of site channels.
+        # Deprecated in favor of [site channels](sites.channels).
         # Corresponds to the JSON property `preview`
         # @return [Google::Apis::FirebasehostingV1beta1::PreviewConfig]
         attr_accessor :preview
-        # The deploy status of a version. For a successful deploy, call [`CreateVersion`]
-        # (sites.versions/create) to make a new version (`CREATED` status), [upload all
-        # desired files](sites.versions/populateFiles) to the version, then [update](
-        # sites.versions/patch) the version to the `FINALIZED` status. Note that if you
-        # leave the version in the `CREATED` state for more than 12 hours, the system
-        # will automatically mark the version as `ABANDONED`. You can also change the
-        # status of a version to `DELETED` by calling [`DeleteVersion`](sites.versions/
-        # delete).
+        # The deploy status of the version. For a successful deploy, call [`
+        # CreateVersion`](sites.versions/create) to make a new version (`CREATED` status)
+        # , [upload all desired files](sites.versions/populateFiles) to the version,
+        # then [update](sites.versions/patch) the version to the `FINALIZED` status.
+        # Note that if you leave the version in the `CREATED` state for more than 12
+        # hours, the system will automatically mark the version as `ABANDONED`. You can
+        # also change the status of a version to `DELETED` by calling [`DeleteVersion`](
+        # sites.versions/delete).
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status

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

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

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

@@ -155,10 +155,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_NAME
         # @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 +190,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 identifier for the channel, in the format: sites/
+        #   SITE_NAME/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -219,9 +222,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 identifier for the channel, in the format: sites/
+        #   SITE_NAME/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -249,16 +253,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_NAME
         # @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 +294,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 identifier for the channel, in the format: sites/
+        #   SITE_NAME/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.
@@ -328,8 +335,8 @@ module Google
         # 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 to which the release belongs, in the format: sites/
-        #   SITE_NAME
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/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/
@@ -366,16 +373,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 site for which to list releases, in the format: sites/ SITE_NAME
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/channels/CHANNEL_ID
         # @param [Fixnum] page_size
         #   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
-        #   A token from a previous call to `ListReleases` that tells the server where to
-        #   resume listing.
+        #   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
@@ -574,8 +585,8 @@ module Google
         # 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 to which the release belongs, in the format: sites/
-        #   SITE_NAME
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/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/
@@ -612,16 +623,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 site for which to list releases, in the format: sites/ SITE_NAME
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/channels/CHANNEL_ID
         # @param [Fixnum] page_size
         #   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
-        #   A token from a previous call to `ListReleases` that tells the server where to
-        #   resume listing.
+        #   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
@@ -651,11 +666,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_NAME
         # @param [Google::Apis::FirebasehostingV1beta1::CloneVersionRequest] clone_version_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -730,7 +745,7 @@ module Google
         # Deletes the specified version.
         # @param [String] name
-        #   Required. The name of the version to be deleted, in the format: sites/
+        #   Required. The fully-qualified identifier for the version, in the format: sites/
         #   SITE_NAME/versions/VERSION_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -759,20 +774,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_NAME - sites/SITE_NAME/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
@@ -805,13 +825,13 @@ module Google
         # Updates the specified metadata for the specified version. 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`](delete) to set the status of a
-        # version to `DELETED`.
+        # 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/
-        #   VERSION_ID This name is provided in the response body when you call [`
-        #   CreateVersion`](sites.versions/create).
+        #   The fully-qualified identifier for the version, in the format: sites/
+        #   SITE_NAME/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
@@ -998,10 +1018,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_NAME
         # @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
@@ -1032,9 +1053,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 identifier for the channel, in the format: sites/
+        #   SITE_NAME/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1062,9 +1085,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 identifier for the channel, in the format: sites/
+        #   SITE_NAME/channels/CHANNEL_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1092,16 +1116,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_NAME
         # @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
@@ -1131,10 +1157,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 identifier for the channel, in the format: sites/
+        #   SITE_NAME/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.
@@ -1171,8 +1198,8 @@ module Google
         # 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 to which the release belongs, in the format: sites/
-        #   SITE_NAME
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/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/
@@ -1209,16 +1236,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 site for which to list releases, in the format: sites/ SITE_NAME
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/channels/CHANNEL_ID
         # @param [Fixnum] page_size
         #   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
-        #   A token from a previous call to `ListReleases` that tells the server where to
-        #   resume listing.
+        #   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
@@ -1417,8 +1448,8 @@ module Google
         # 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 to which the release belongs, in the format: sites/
-        #   SITE_NAME
+        #   Required. The site or channel to which the release belongs, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/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/
@@ -1455,16 +1486,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 site for which to list releases, in the format: sites/ SITE_NAME
+        #   Required. The site or channel for which to list releases, in either of the
+        #   following formats: - sites/SITE_NAME - sites/SITE_NAME/channels/CHANNEL_ID
         # @param [Fixnum] page_size
         #   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
-        #   A token from a previous call to `ListReleases` that tells the server where to
-        #   resume listing.
+        #   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
@@ -1494,11 +1529,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_NAME
         # @param [Google::Apis::FirebasehostingV1beta1::CloneVersionRequest] clone_version_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1573,7 +1608,7 @@ module Google
         # Deletes the specified version.
         # @param [String] name
-        #   Required. The name of the version to be deleted, in the format: sites/
+        #   Required. The fully-qualified identifier for the version, in the format: sites/
         #   SITE_NAME/versions/VERSION_ID
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1602,20 +1637,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_NAME - sites/SITE_NAME/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
@@ -1648,13 +1688,13 @@ module Google
         # Updates the specified metadata for the specified version. 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`](delete) to set the status of a
-        # version to `DELETED`.
+        # 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/
-        #   VERSION_ID This name is provided in the response body when you call [`
-        #   CreateVersion`](sites.versions/create).
+        #   The fully-qualified identifier for the version, in the format: sites/
+        #   SITE_NAME/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

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firebasehosting_v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-02-08 00:00:00.000000000 Z
+date: 2021-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -52,7 +52,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-firebasehosting_v1beta1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-firebasehosting_v1beta1/v0.2.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firebasehosting_v1beta1/v0.3.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-firebasehosting_v1beta1
 post_install_message:
 rdoc_options: []
@@ -62,14 +62,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.6
+rubygems_version: 3.2.13
 signing_key:
 specification_version: 4
 summary: Simple REST client for Firebase Hosting API V1beta1