google-api-client 0.23.8 → 0.23.9

data/generated/google/apis/logging_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/logging/docs/
     module LoggingV2
       VERSION = 'V2'
-      REVISION = '20180806'
+      REVISION = '20180831'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/logging_v2/classes.rb

@@ -423,7 +423,9 @@ module Google
         # "organizations/[ORGANIZATION_ID]"
         # "billingAccounts/[BILLING_ACCOUNT_ID]"
         # "folders/[FOLDER_ID]"
-        # Projects listed in the project_ids field are added to this list.
+        # Projects listed in the project_ids field are added to this list. Only one of
+        # the permissions, <code>logging.logEntries.list</code> or <code>logging.
+        # privateLogEntries.list</code>, is needed for each parent resource.
         # Corresponds to the JSON property `resourceNames`
         # @return [Array<String>]
         attr_accessor :resource_names
@@ -1774,7 +1776,10 @@ module Google
         # "folders/[FOLDER_ID]/logs/[LOG_ID]"
         # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
         # or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
-        # 2Factivity". For more information about log names, see LogEntry.
+        # 2Factivity". The permission <code>logging.logEntries.create</code> is needed
+        # on each project, organization, billing account, or folder that is receiving
+        # new log entries, whether the resource is specified in <code>logName</code> or
+        # in an individual log entry. For more information about log names, see LogEntry.
         # Corresponds to the JSON property `logName`
         # @return [String]
         attr_accessor :log_name

data/generated/google/apis/logging_v2beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/logging/docs/
     module LoggingV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20180806'
+      REVISION = '20180831'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/logging_v2beta1/classes.rb

@@ -396,7 +396,9 @@ module Google
         # "organizations/[ORGANIZATION_ID]"
         # "billingAccounts/[BILLING_ACCOUNT_ID]"
         # "folders/[FOLDER_ID]"
-        # Projects listed in the project_ids field are added to this list.
+        # Projects listed in the project_ids field are added to this list. Only one of
+        # the permissions, <code>logging.logEntries.list</code> or <code>logging.
+        # privateLogEntries.list</code>, is needed for each parent resource.
         # Corresponds to the JSON property `resourceNames`
         # @return [Array<String>]
         attr_accessor :resource_names
@@ -1697,7 +1699,10 @@ module Google
         # "folders/[FOLDER_ID]/logs/[LOG_ID]"
         # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
         # or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
-        # 2Factivity". For more information about log names, see LogEntry.
+        # 2Factivity". The permission <code>logging.logEntries.create</code> is needed
+        # on each project, organization, billing account, or folder that is receiving
+        # new log entries, whether the resource is specified in <code>logName</code> or
+        # in an individual log entry. For more information about log names, see LogEntry.
         # Corresponds to the JSON property `logName`
         # @return [String]
         attr_accessor :log_name

data/generated/google/apis/manufacturers_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/manufacturers/
     module ManufacturersV1
       VERSION = 'V1'
-      REVISION = '20180605'
+      REVISION = '20180903'
 
       # Manage your product listings for Google Manufacturer Center
       AUTH_MANUFACTURERCENTER = 'https://www.googleapis.com/auth/manufacturercenter'

data/generated/google/apis/manufacturers_v1/classes.rb

@@ -576,31 +576,11 @@ module Google
         # @return [Array<Google::Apis::ManufacturersV1::DestinationStatus>]
         attr_accessor :destination_statuses
       
-        # Attributes of the product. For more information, see
-        # https://support.google.com/manufacturers/answer/6124116.
-        # Corresponds to the JSON property `finalAttributes`
-        # @return [Google::Apis::ManufacturersV1::Attributes]
-        attr_accessor :final_attributes
-      
         # A server-generated list of issues associated with the product.
         # Corresponds to the JSON property `issues`
         # @return [Array<Google::Apis::ManufacturersV1::Issue>]
         attr_accessor :issues
       
-        # Names of the attributes of the product deleted manually via the
-        # Manufacturer Center UI.
-        # This field is deprecated and will be removed end of July 2018. Please use
-        # attributes.
-        # Corresponds to the JSON property `manuallyDeletedAttributes`
-        # @return [Array<String>]
-        attr_accessor :manually_deleted_attributes
-      
-        # Attributes of the product. For more information, see
-        # https://support.google.com/manufacturers/answer/6124116.
-        # Corresponds to the JSON property `manuallyProvidedAttributes`
-        # @return [Google::Apis::ManufacturersV1::Attributes]
-        attr_accessor :manually_provided_attributes
-      
         # Name in the format ``target_country`:`content_language`:`product_id``.
         # `target_country`   - The target country of the product as a CLDR territory
         # code (for example, US).
@@ -631,12 +611,6 @@ module Google
         # @return [String]
         attr_accessor :target_country
       
-        # Attributes of the product. For more information, see
-        # https://support.google.com/manufacturers/answer/6124116.
-        # Corresponds to the JSON property `uploadedAttributes`
-        # @return [Google::Apis::ManufacturersV1::Attributes]
-        attr_accessor :uploaded_attributes
-      
         def initialize(**args)
            update!(**args)
         end
@@ -646,15 +620,11 @@ module Google
           @attributes = args[:attributes] if args.key?(:attributes)
           @content_language = args[:content_language] if args.key?(:content_language)
           @destination_statuses = args[:destination_statuses] if args.key?(:destination_statuses)
-          @final_attributes = args[:final_attributes] if args.key?(:final_attributes)
           @issues = args[:issues] if args.key?(:issues)
-          @manually_deleted_attributes = args[:manually_deleted_attributes] if args.key?(:manually_deleted_attributes)
-          @manually_provided_attributes = args[:manually_provided_attributes] if args.key?(:manually_provided_attributes)
           @name = args[:name] if args.key?(:name)
           @parent = args[:parent] if args.key?(:parent)
           @product_id = args[:product_id] if args.key?(:product_id)
           @target_country = args[:target_country] if args.key?(:target_country)
-          @uploaded_attributes = args[:uploaded_attributes] if args.key?(:uploaded_attributes)
         end
       end
       

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

@@ -230,19 +230,12 @@ module Google
           property :content_language, as: 'contentLanguage'
           collection :destination_statuses, as: 'destinationStatuses', class: Google::Apis::ManufacturersV1::DestinationStatus, decorator: Google::Apis::ManufacturersV1::DestinationStatus::Representation
       
-          property :final_attributes, as: 'finalAttributes', class: Google::Apis::ManufacturersV1::Attributes, decorator: Google::Apis::ManufacturersV1::Attributes::Representation
-      
           collection :issues, as: 'issues', class: Google::Apis::ManufacturersV1::Issue, decorator: Google::Apis::ManufacturersV1::Issue::Representation
       
-          collection :manually_deleted_attributes, as: 'manuallyDeletedAttributes'
-          property :manually_provided_attributes, as: 'manuallyProvidedAttributes', class: Google::Apis::ManufacturersV1::Attributes, decorator: Google::Apis::ManufacturersV1::Attributes::Representation
-      
           property :name, as: 'name'
           property :parent, as: 'parent'
           property :product_id, as: 'productId'
           property :target_country, as: 'targetCountry'
-          property :uploaded_attributes, as: 'uploadedAttributes', class: Google::Apis::ManufacturersV1::Attributes, decorator: Google::Apis::ManufacturersV1::Attributes::Representation
-      
         end
       end
       

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

@@ -109,9 +109,6 @@ module Google
         # @param [Array<String>, String] include
         #   The information to be included in the response. Only sections listed here
         #   will be returned.
-        #   If this parameter is not specified, ATTRIBUTES and ISSUES are returned.
-        #   This behavior is temporary and will be removed once all clients are ready
-        #   or at the latest end of July 2018. After that no sections will be returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -148,9 +145,6 @@ module Google
         # @param [Array<String>, String] include
         #   The information to be included in the response. Only sections listed here
         #   will be returned.
-        #   If this parameter is not specified, ATTRIBUTES and ISSUES are returned.
-        #   This behavior is temporary and will be removed once all clients are ready
-        #   or at the latest end of July 2018. After that no sections will be returned.
         # @param [Fixnum] page_size
         #   Maximum number of product statuses to return in the response, used for
         #   paging.

data/generated/google/apis/ml_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/ml/
     module MlV1
       VERSION = 'V1'
-      REVISION = '20180804'
+      REVISION = '20180903'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/ml_v1/classes.rb

@@ -1165,14 +1165,36 @@ module Google
         # <dt>standard_p100</dt>
         # <dd>
         # A machine equivalent to <i>standard</i> that
-        # also includes a single NVIDIA Tesla P100 GPU. The availability of these
-        # GPUs is in the <i>Beta</i> launch stage.
+        # also includes a single NVIDIA Tesla P100 GPU.
         # </dd>
         # <dt>complex_model_m_p100</dt>
         # <dd>
         # A machine equivalent to <i>complex_model_m</i> that also includes
-        # four NVIDIA Tesla P100 GPUs. The availability of these GPUs is in
-        # the <i>Beta</i> launch stage.
+        # four NVIDIA Tesla P100 GPUs.
+        # </dd>
+        # <dt>standard_v100</dt>
+        # <dd>
+        # A machine equivalent to <i>standard</i> that
+        # also includes a single NVIDIA Tesla V100 GPU. The availability of these
+        # GPUs is in the <i>Beta</i> launch stage.
+        # </dd>
+        # <dt>large_model_v100</dt>
+        # <dd>
+        # A machine equivalent to <i>large_model</i> that
+        # also includes a single NVIDIA Tesla V100 GPU. The availability of these
+        # GPUs is in the <i>Beta</i> launch stage.
+        # </dd>
+        # <dt>complex_model_m_v100</dt>
+        # <dd>
+        # A machine equivalent to <i>complex_model_m</i> that
+        # also includes four NVIDIA Tesla V100 GPUs. The availability of these
+        # GPUs is in the <i>Beta</i> launch stage.
+        # </dd>
+        # <dt>complex_model_l_v100</dt>
+        # <dd>
+        # A machine equivalent to <i>complex_model_l</i> that
+        # also includes eight NVIDIA Tesla V100 GPUs. The availability of these
+        # GPUs is in the <i>Beta</i> launch stage.
         # </dd>
         # <dt>cloud_tpu</dt>
         # <dd>

data/generated/google/apis/partners_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/partners/
     module PartnersV2
       VERSION = 'V2'
-      REVISION = '20180605'
+      REVISION = '20180906'
     end
   end
 end

data/generated/google/apis/partners_v2/classes.rb

@@ -57,13 +57,13 @@ module Google
         # @return [Google::Apis::PartnersV2::AnalyticsDataPoint]
         attr_accessor :contacts
       
-        # Represents a whole calendar date, e.g. date of birth. The time of day and
-        # time zone are either specified elsewhere or are not significant. The date
-        # is relative to the Proleptic Gregorian Calendar. The day may be 0 to
-        # represent a year and month where the day is not significant, e.g. credit card
-        # expiration date. The year may be 0 to represent a month and day independent
-        # of year, e.g. anniversary date. Related types are google.type.TimeOfDay
-        # and `google.protobuf.Timestamp`.
+        # Represents a whole calendar date, for example date of birth. The time of day
+        # and time zone are either specified elsewhere or are not significant. The date
+        # is relative to the Proleptic Gregorian Calendar. The day can be 0 to
+        # represent a year and month where the day is not significant, for example
+        # credit card expiration date. The year can be 0 to represent a month and day
+        # independent of year, for example anniversary date. Related types are
+        # google.type.TimeOfDay and `google.protobuf.Timestamp`.
         # Corresponds to the JSON property `eventDate`
         # @return [Google::Apis::PartnersV2::Date]
         attr_accessor :event_date
@@ -739,13 +739,13 @@ module Google
         end
       end
       
-      # Represents a whole calendar date, e.g. date of birth. The time of day and
-      # time zone are either specified elsewhere or are not significant. The date
-      # is relative to the Proleptic Gregorian Calendar. The day may be 0 to
-      # represent a year and month where the day is not significant, e.g. credit card
-      # expiration date. The year may be 0 to represent a month and day independent
-      # of year, e.g. anniversary date. Related types are google.type.TimeOfDay
-      # and `google.protobuf.Timestamp`.
+      # Represents a whole calendar date, for example date of birth. The time of day
+      # and time zone are either specified elsewhere or are not significant. The date
+      # is relative to the Proleptic Gregorian Calendar. The day can be 0 to
+      # represent a year and month where the day is not significant, for example
+      # credit card expiration date. The year can be 0 to represent a month and day
+      # independent of year, for example anniversary date. Related types are
+      # google.type.TimeOfDay and `google.protobuf.Timestamp`.
       class Date
         include Google::Apis::Core::Hashable
       

data/generated/google/apis/pubsub_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/pubsub/docs
     module PubsubV1
       VERSION = 'V1'
-      REVISION = '20180806'
+      REVISION = '20180828'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/pubsub_v1/classes.rb

@@ -91,8 +91,8 @@ module Google
       end
       
       # Request for the `CreateSnapshot` method.<br><br>
-      # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
-      # changed in
+      # <b>BETA:</b> This feature is part of a beta release. This API might be changed
+      # in
       # backward-incompatible ways and is not recommended for production use.
       # It is not subject to any SLA or deprecation policy.
       class CreateSnapshotRequest
@@ -194,7 +194,7 @@ module Google
       end
       
       # Response for the `ListSnapshots` method.<br><br>
-      # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+      # <b>BETA:</b> This feature is part of a beta release. This API might be
       # changed in backward-incompatible ways and is not recommended for production
       # use. It is not subject to any SLA or deprecation policy.
       class ListSnapshotsResponse
@@ -250,7 +250,7 @@ module Google
       end
       
       # Response for the `ListTopicSnapshots` method.<br><br>
-      # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+      # <b>BETA:</b> This feature is part of a beta release. This API might be
       # changed in backward-incompatible ways and is not recommended for production
       # use. It is not subject to any SLA or deprecation policy.
       class ListTopicSnapshotsResponse
@@ -663,8 +663,8 @@ module Google
         end
       end
       
-      # Request for the `Seek` method.<br><br>
-      # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+      # Request for the `Seek` method. <br><br>
+      # <b>BETA:</b> This feature is part of a beta release. This API might be
       # changed in backward-incompatible ways and is not recommended for production
       # use. It is not subject to any SLA or deprecation policy.
       class SeekRequest
@@ -703,7 +703,7 @@ module Google
         end
       end
       
-      # 
+      # Response for the `Seek` method (this response is empty).
       class SeekResponse
         include Google::Apis::Core::Hashable
       
@@ -771,8 +771,12 @@ module Google
         end
       end
       
-      # A snapshot resource.<br><br>
-      # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+      # A snapshot resource. Snapshots are used in
+      # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+      # you to manage message acknowledgments in bulk. That is, you can set the
+      # acknowledgment state of messages in an existing subscription to the state
+      # captured by a snapshot.<br><br>
+      # <b>BETA:</b> This feature is part of a beta release. This API might be
       # changed in backward-incompatible ways and is not recommended for production
       # use. It is not subject to any SLA or deprecation policy.
       class Snapshot
@@ -856,7 +860,7 @@ module Google
         # of acknowledged messages, and thus configures how far back in time a `Seek`
         # can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
         # minutes.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # Corresponds to the JSON property `messageRetentionDuration`
@@ -881,8 +885,10 @@ module Google
         # Indicates whether to retain acknowledged messages. If true, then
         # messages are not expunged from the subscription's backlog, even if they are
         # acknowledged, until they fall out of the `message_retention_duration`
-        # window.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # window. This must be true if you would like to
+        # <a href="/pubsub/docs/replay-overview#seek_to_a_time">Seek to a timestamp</a>.
+        # <br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # Corresponds to the JSON property `retainAckedMessages`
@@ -987,14 +993,18 @@ module Google
       end
       
       # Request for the UpdateSnapshot method.<br><br>
-      # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+      # <b>BETA:</b> This feature is part of a beta release. This API might be
       # changed in backward-incompatible ways and is not recommended for production
       # use. It is not subject to any SLA or deprecation policy.
       class UpdateSnapshotRequest
         include Google::Apis::Core::Hashable
       
-        # A snapshot resource.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # A snapshot resource. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot.<br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # Corresponds to the JSON property `snapshot`

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

@@ -47,10 +47,15 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a snapshot from the requested subscription.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # Creates a snapshot from the requested subscription. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot.
+        # <br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
-        # use. It is not subject to any SLA or deprecation policy.
+        # use. It is not subject to any SLA or deprecation policy.<br><br>
         # If the snapshot already exists, returns `ALREADY_EXISTS`.
         # If the requested subscription doesn't exist, returns `NOT_FOUND`.
         # If the backlog in the subscription is too old -- and the resulting snapshot
@@ -67,7 +72,8 @@ module Google
         #   Optional user-provided name for this snapshot.
         #   If the name is not provided in the request, the server will assign a random
         #   name for this snapshot on the same project as the subscription.
-        #   Note that for REST API requests, you must specify a name.
+        #   Note that for REST API requests, you must specify a name.  See the
+        #   <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
         #   Format is `projects/`project`/snapshots/`snap``.
         # @param [Google::Apis::PubsubV1::CreateSnapshotRequest] create_snapshot_request_object
         # @param [String] fields
@@ -99,8 +105,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Removes an existing snapshot. <br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # Removes an existing snapshot. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot.<br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # When the snapshot is deleted, all messages retained in the snapshot
@@ -137,8 +147,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the configuration details of a snapshot.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # Gets the configuration details of a snapshot. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot.<br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # @param [String] snapshot
@@ -204,8 +218,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the existing snapshots.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # Lists the existing snapshots. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot.<br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # @param [String] project
@@ -246,8 +264,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an existing snapshot.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # Updates an existing snapshot. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot.<br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # Note that certain properties of a snapshot are not modifiable.
@@ -733,8 +755,13 @@ module Google
         end
         
         # Seeks an existing subscription to a point in time or to a given snapshot,
-        # whichever is provided in the request.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # whichever is provided in the request. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot. Note that both the subscription and the snapshot
+        # must be on the same topic.<br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # @param [String] subscription
@@ -1168,8 +1195,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the names of the snapshots on this topic.<br><br>
-        # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+        # Lists the names of the snapshots on this topic. Snapshots are used in
+        # <a href="/pubsub/docs/replay-overview">Seek</a> operations, which allow
+        # you to manage message acknowledgments in bulk. That is, you can set the
+        # acknowledgment state of messages in an existing subscription to the state
+        # captured by a snapshot.<br><br>
+        # <b>BETA:</b> This feature is part of a beta release. This API might be
         # changed in backward-incompatible ways and is not recommended for production
         # use. It is not subject to any SLA or deprecation policy.
         # @param [String] topic