google-cloud-pubsub 0.33.2 → 0.34.0

data/lib/google/cloud/pubsub/topic/list.rb

@@ -17,7 +17,7 @@ require "delegate"
 
 module Google
   module Cloud
-    module Pubsub
+    module PubSub
       class Topic
         ##
         # Topic::List is a special case Array with additional values.
@@ -25,7 +25,7 @@ module Google
           ##
           # If not empty, indicates that there are more topics
           # that match the request and this value should be passed to
-          # the next {Google::Cloud::Pubsub::Project#topics} to continue.
+          # the next {Google::Cloud::PubSub::Project#topics} to continue.
           attr_accessor :token
 
           ##
@@ -42,7 +42,7 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   pubsub = Google::Cloud::Pubsub.new
+          #   pubsub = Google::Cloud::PubSub.new
           #
           #   topics = pubsub.topics
           #   if topics.next?
@@ -61,7 +61,7 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   pubsub = Google::Cloud::Pubsub.new
+          #   pubsub = Google::Cloud::PubSub.new
           #
           #   topics = pubsub.topics
           #   if topics.next?
@@ -97,7 +97,7 @@ module Google
           # @example Iterating each topic by passing a block:
           #   require "google/cloud/pubsub"
           #
-          #   pubsub = Google::Cloud::Pubsub.new
+          #   pubsub = Google::Cloud::PubSub.new
           #
           #   topics = pubsub.topics
           #   topics.all do |topic|
@@ -107,7 +107,7 @@ module Google
           # @example Using the enumerator by not passing a block:
           #   require "google/cloud/pubsub"
           #
-          #   pubsub = Google::Cloud::Pubsub.new
+          #   pubsub = Google::Cloud::PubSub.new
           #
           #   topics = pubsub.topics
           #   all_names = topics.all.map do |topic|
@@ -117,7 +117,7 @@ module Google
           # @example Limit the number of API calls made:
           #   require "google/cloud/pubsub"
           #
-          #   pubsub = Google::Cloud::Pubsub.new
+          #   pubsub = Google::Cloud::PubSub.new
           #
           #   topics = pubsub.topics
           #   topics.all(request_limit: 10) do |topic|
@@ -143,7 +143,7 @@ module Google
 
           ##
           # @private New Topic::List from a
-          # Google::Pubsub::V1::ListTopicsResponse object.
+          # Google::Cloud::PubSub::V1::ListTopicsResponse object.
           def self.from_grpc grpc_list, service, max = nil
             topics = new(Array(grpc_list.topics).map do |grpc|
               Topic.from_grpc grpc, service
@@ -167,5 +167,7 @@ module Google
         end
       end
     end
+
+    Pubsub = PubSub unless const_defined? :Pubsub
   end
 end

data/lib/google/cloud/pubsub/v1/credentials.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -17,7 +17,7 @@ require "googleauth"
 
 module Google
   module Cloud
-    module Pubsub
+    module PubSub
       module V1
         class Credentials < Google::Auth::Credentials
           SCOPE = ["https://www.googleapis.com/auth/pubsub"].freeze
@@ -35,5 +35,7 @@ module Google
         end
       end
     end
+
+    Pubsub = PubSub unless const_defined? :Pubsub
   end
 end

data/lib/google/cloud/pubsub/v1/doc/google/iam/v1/iam_policy.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,48 +16,6 @@
 module Google
   module Iam
     module V1
-      # Request message for `SetIamPolicy` method.
-      # @!attribute [rw] resource
-      #   @return [String]
-      #     REQUIRED: The resource for which the policy is being specified.
-      #     `resource` is usually specified as a path. For example, a Project
-      #     resource is specified as `projects/{project}`.
-      # @!attribute [rw] policy
-      #   @return [Google::Iam::V1::Policy]
-      #     REQUIRED: The complete policy to be applied to the `resource`. The size of
-      #     the policy is limited to a few 10s of KB. An empty policy is a
-      #     valid policy but certain Cloud Platform services (such as Projects)
-      #     might reject them.
-      class SetIamPolicyRequest; end
-
-      # Request message for `GetIamPolicy` method.
-      # @!attribute [rw] resource
-      #   @return [String]
-      #     REQUIRED: The resource for which the policy is being requested.
-      #     `resource` is usually specified as a path. For example, a Project
-      #     resource is specified as `projects/{project}`.
-      class GetIamPolicyRequest; end
-
-      # Request message for `TestIamPermissions` method.
-      # @!attribute [rw] resource
-      #   @return [String]
-      #     REQUIRED: The resource for which the policy detail is being requested.
-      #     `resource` is usually specified as a path. For example, a Project
-      #     resource is specified as `projects/{project}`.
-      # @!attribute [rw] permissions
-      #   @return [Array<String>]
-      #     The set of permissions to check for the `resource`. Permissions with
-      #     wildcards (such as '*' or 'storage.*') are not allowed. For more
-      #     information see
-      #     [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
-      class TestIamPermissionsRequest; end
-
-      # Response message for `TestIamPermissions` method.
-      # @!attribute [rw] permissions
-      #   @return [Array<String>]
-      #     A subset of `TestPermissionsRequest.permissions` that the caller is
-      #     allowed.
-      class TestIamPermissionsResponse; end
     end
   end
 end

data/lib/google/cloud/pubsub/v1/doc/google/iam/v1/policy.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,113 +16,6 @@
 module Google
   module Iam
     module V1
-      # Defines an Identity and Access Management (IAM) policy. It is used to
-      # specify access control policies for Cloud Platform resources.
-      #
-      #
-      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
-      # `members` to a `role`, where the members can be user accounts, Google groups,
-      # Google domains, and service accounts. A `role` is a named list of permissions
-      # defined by IAM.
-      #
-      # **Example**
-      #
-      #     {
-      #       "bindings": [
-      #         {
-      #           "role": "roles/owner",
-      #           "members": [
-      #             "user:mike@example.com",
-      #             "group:admins@example.com",
-      #             "domain:google.com",
-      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
-      #           ]
-      #         },
-      #         {
-      #           "role": "roles/viewer",
-      #           "members": ["user:sean@example.com"]
-      #         }
-      #       ]
-      #     }
-      #
-      # For a description of IAM and its features, see the
-      # [IAM developer's guide](https://cloud.google.com/iam).
-      # @!attribute [rw] version
-      #   @return [Integer]
-      #     Version of the `Policy`. The default version is 0.
-      # @!attribute [rw] bindings
-      #   @return [Array<Google::Iam::V1::Binding>]
-      #     Associates a list of `members` to a `role`.
-      #     Multiple `bindings` must not be specified for the same `role`.
-      #     `bindings` with no members will result in an error.
-      # @!attribute [rw] etag
-      #   @return [String]
-      #     `etag` is used for optimistic concurrency control as a way to help
-      #     prevent simultaneous updates of a policy from overwriting each other.
-      #     It is strongly suggested that systems make use of the `etag` in the
-      #     read-modify-write cycle to perform policy updates in order to avoid race
-      #     conditions: An `etag` is returned in the response to `getIamPolicy`, and
-      #     systems are expected to put that etag in the request to `setIamPolicy` to
-      #     ensure that their change will be applied to the same version of the policy.
-      #
-      #     If no `etag` is provided in the call to `setIamPolicy`, then the existing
-      #     policy is overwritten blindly.
-      class Policy; end
-
-      # Associates `members` with a `role`.
-      # @!attribute [rw] role
-      #   @return [String]
-      #     Role that is assigned to `members`.
-      #     For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
-      #     Required
-      # @!attribute [rw] members
-      #   @return [Array<String>]
-      #     Specifies the identities requesting access for a Cloud Platform resource.
-      #     `members` can have the following values:
-      #
-      #     * `allUsers`: A special identifier that represents anyone who is
-      #       on the internet; with or without a Google account.
-      #
-      #     * `allAuthenticatedUsers`: A special identifier that represents anyone
-      #       who is authenticated with a Google account or a service account.
-      #
-      #     * `user:{emailid}`: An email address that represents a specific Google
-      #       account. For example, `alice@gmail.com` or `joe@example.com`.
-      #
-      #
-      #     * `serviceAccount:{emailid}`: An email address that represents a service
-      #       account. For example, `my-other-app@appspot.gserviceaccount.com`.
-      #
-      #     * `group:{emailid}`: An email address that represents a Google group.
-      #       For example, `admins@example.com`.
-      #
-      #     * `domain:{domain}`: A Google Apps domain name that represents all the
-      #       users of that domain. For example, `google.com` or `example.com`.
-      class Binding; end
-
-      # The difference delta between two policies.
-      # @!attribute [rw] binding_deltas
-      #   @return [Array<Google::Iam::V1::BindingDelta>]
-      #     The delta for Bindings between two policies.
-      class PolicyDelta; end
-
-      # One delta entry for Binding. Each individual change (only one member in each
-      # entry) to a binding will be a separate entry.
-      # @!attribute [rw] action
-      #   @return [Google::Iam::V1::BindingDelta::Action]
-      #     The action that was performed on a Binding.
-      #     Required
-      # @!attribute [rw] role
-      #   @return [String]
-      #     Role that is assigned to `members`.
-      #     For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
-      #     Required
-      # @!attribute [rw] member
-      #   @return [String]
-      #     A single identity requesting access for a Cloud Platform resource.
-      #     Follows the same format of Binding.members.
-      #     Required
-      class BindingDelta; end
     end
   end
 end

data/lib/google/cloud/pubsub/v1/doc/google/protobuf/duration.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/pubsub/v1/doc/google/protobuf/empty.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/pubsub/v1/doc/google/protobuf/field_mask.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/pubsub/v1/doc/google/protobuf/timestamp.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,12 +14,13 @@
 
 
 module Google
-  module Pubsub
+  module Cloud
+  module PubSub
     module V1
       # @!attribute [rw] allowed_persistence_regions
       #   @return [Array<String>]
-      #     The list of GCP regions where messages that are published to the topic may
-      #     be persisted in storage. Messages published by publishers running in
+      #     The list of GCP region IDs where messages that are published to the topic
+      #     may be persisted in storage. Messages published by publishers running in
       #     non-allowed GCP regions (or running outside of GCP altogether) will be
       #     routed for storage in one of the allowed regions. An empty list indicates a
       #     misconfiguration at the project or organization level, which will result in
@@ -37,9 +38,10 @@ module Google
       #     must not start with `"goog"`.
       # @!attribute [rw] labels
       #   @return [Hash{String => String}]
-      #     User labels.
+      #     See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+      #     managing labels</a>.
       # @!attribute [rw] message_storage_policy
-      #   @return [Google::Pubsub::V1::MessageStoragePolicy]
+      #   @return [Google::Cloud::PubSub::V1::MessageStoragePolicy]
       #     Policy constraining how messages published to the topic may be stored. It
       #     is determined when the topic is created based on the policy configured at
       #     the project level. It must not be set by the caller in the request to
@@ -48,11 +50,18 @@ module Google
       #     response, then no constraints are in effect.
       class Topic; end
 
-      # A message data and its attributes. The message payload must not be empty;
-      # it must contain either a non-empty data field, or at least one attribute.
+      # A message that is published by publishers and consumed by subscribers. The
+      # message must contain either a non-empty data field or at least one attribute.
+      # Note that client libraries represent this object differently
+      # depending on the language. See the corresponding
+      # <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
+      # library documentation</a> for more information. See
+      # <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
+      # for more information about message limits.
       # @!attribute [rw] data
       #   @return [String]
-      #     The message payload.
+      #     The message data field. If this field is empty, the message must contain
+      #     at least one attribute.
       # @!attribute [rw] attributes
       #   @return [Hash{String => String}]
       #     Optional attributes for this message.
@@ -78,7 +87,7 @@ module Google
 
       # Request for the UpdateTopic method.
       # @!attribute [rw] topic
-      #   @return [Google::Pubsub::V1::Topic]
+      #   @return [Google::Cloud::PubSub::V1::Topic]
       #     The updated topic object.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
@@ -95,7 +104,7 @@ module Google
       #     The messages in the request will be published on this topic.
       #     Format is `projects/{project}/topics/{topic}`.
       # @!attribute [rw] messages
-      #   @return [Array<Google::Pubsub::V1::PubsubMessage>]
+      #   @return [Array<Google::Cloud::PubSub::V1::PubsubMessage>]
       #     The messages to publish.
       class PublishRequest; end
 
@@ -110,8 +119,8 @@ module Google
       # Request for the `ListTopics` method.
       # @!attribute [rw] project
       #   @return [String]
-      #     The name of the cloud project that topics belong to.
-      #     Format is `projects/{project}`.
+      #     The name of the project in which to list topics.
+      #     Format is `projects/{project-id}`.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Maximum number of topics to return.
@@ -124,7 +133,7 @@ module Google
 
       # Response for the `ListTopics` method.
       # @!attribute [rw] topics
-      #   @return [Array<Google::Pubsub::V1::Topic>]
+      #   @return [Array<Google::Cloud::PubSub::V1::Topic>]
       #     The resulting topics.
       # @!attribute [rw] next_page_token
       #   @return [String]
@@ -158,8 +167,8 @@ module Google
       #     `ListTopicSubscriptionsRequest` to get more subscriptions.
       class ListTopicSubscriptionsResponse; end
 
-      # Request for the `ListTopicSnapshots` method.<br><br>
-      # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+      # Request for the `ListTopicSnapshots` 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.
       # @!attribute [rw] topic
@@ -177,7 +186,7 @@ module Google
       class ListTopicSnapshotsRequest; 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.
       # @!attribute [rw] snapshots
@@ -213,17 +222,17 @@ module Google
       #     The value of this field will be `_deleted-topic_` if the topic has been
       #     deleted.
       # @!attribute [rw] push_config
-      #   @return [Google::Pubsub::V1::PushConfig]
+      #   @return [Google::Cloud::PubSub::V1::PushConfig]
       #     If push delivery is used with this subscription, this field is
       #     used to configure it. An empty `pushConfig` signifies that the subscriber
       #     will pull and ack messages using API methods.
       # @!attribute [rw] ack_deadline_seconds
       #   @return [Integer]
-      #     This value is the maximum time after a subscriber receives a message
-      #     before the subscriber should acknowledge the message. After message
-      #     delivery but before the ack deadline expires and before the message is
-      #     acknowledged, it is an outstanding message and will not be delivered
-      #     again during that time (on a best-effort basis).
+      #     The approximate amount of time (on a best-effort basis) Pub/Sub waits for
+      #     the subscriber to acknowledge receipt before resending the message. In the
+      #     interval after the message is delivered and before it is acknowledged, it
+      #     is considered to be <i>outstanding</i>. During that time period, the
+      #     message will not be redelivered (on a best-effort basis).
       #
       #     For pull subscriptions, this value is used as the initial value for the ack
       #     deadline. To override this value for a given message, call
@@ -244,8 +253,11 @@ 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="https://cloud.google.com/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.
       # @!attribute [rw] message_retention_duration
@@ -256,14 +268,38 @@ 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.
       # @!attribute [rw] labels
       #   @return [Hash{String => String}]
-      #     User labels.
+      #     See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+      #     managing labels</a>.
+      # @!attribute [rw] expiration_policy
+      #   @return [Google::Cloud::PubSub::V1::ExpirationPolicy]
+      #     A policy that specifies the conditions for this subscription's expiration.
+      #     A subscription is considered active as long as any connected subscriber is
+      #     successfully consuming messages from the subscription or is issuing
+      #     operations on the subscription. If `expiration_policy` is not set, a
+      #     *default policy* with `ttl` of 31 days will be used. The minimum allowed
+      #     value for `expiration_policy.ttl` is 1 day.
+      #     <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 Subscription; end
 
+      # A policy that specifies the conditions for resource expiration (i.e.,
+      # automatic resource deletion).
+      # @!attribute [rw] ttl
+      #   @return [Google::Protobuf::Duration]
+      #     Specifies the "time-to-live" duration for an associated resource. The
+      #     resource expires if it is not active for a period of `ttl`. The definition
+      #     of "activity" depends on the type of the associated resource. The minimum
+      #     and maximum allowed values for `ttl` depend on the type of the associated
+      #     resource, as well. If `ttl` is not set, the associated resource never
+      #     expires.
+      class ExpirationPolicy; end
+
       # Configuration for a push delivery endpoint.
       # @!attribute [rw] push_endpoint
       #   @return [String]
@@ -299,7 +335,7 @@ module Google
       #   @return [String]
       #     This ID can be used to acknowledge the received message.
       # @!attribute [rw] message
-      #   @return [Google::Pubsub::V1::PubsubMessage]
+      #   @return [Google::Cloud::PubSub::V1::PubsubMessage]
       #     The message.
       class ReceivedMessage; end
 
@@ -312,7 +348,7 @@ module Google
 
       # Request for the UpdateSubscription method.
       # @!attribute [rw] subscription
-      #   @return [Google::Pubsub::V1::Subscription]
+      #   @return [Google::Cloud::PubSub::V1::Subscription]
       #     The updated subscription object.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
@@ -323,8 +359,8 @@ module Google
       # Request for the `ListSubscriptions` method.
       # @!attribute [rw] project
       #   @return [String]
-      #     The name of the cloud project that subscriptions belong to.
-      #     Format is `projects/{project}`.
+      #     The name of the project in which to list subscriptions.
+      #     Format is `projects/{project-id}`.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Maximum number of subscriptions to return.
@@ -337,7 +373,7 @@ module Google
 
       # Response for the `ListSubscriptions` method.
       # @!attribute [rw] subscriptions
-      #   @return [Array<Google::Pubsub::V1::Subscription>]
+      #   @return [Array<Google::Cloud::PubSub::V1::Subscription>]
       #     The subscriptions that match the request.
       # @!attribute [rw] next_page_token
       #   @return [String]
@@ -359,7 +395,7 @@ module Google
       #     The name of the subscription.
       #     Format is `projects/{project}/subscriptions/{sub}`.
       # @!attribute [rw] push_config
-      #   @return [Google::Pubsub::V1::PushConfig]
+      #   @return [Google::Cloud::PubSub::V1::PushConfig]
       #     The push configuration for future deliveries.
       #
       #     An empty `pushConfig` indicates that the Pub/Sub system should
@@ -378,9 +414,7 @@ module Google
       #     If this field set to true, the system will respond immediately even if
       #     it there are no messages available to return in the `Pull` response.
       #     Otherwise, the system may wait (for a bounded amount of time) until at
-      #     least one message is available, rather than returning no messages. The
-      #     client may cancel the request if it does not wish to wait any longer for
-      #     the response.
+      #     least one message is available, rather than returning no messages.
       # @!attribute [rw] max_messages
       #   @return [Integer]
       #     The maximum number of messages returned for this request. The Pub/Sub
@@ -389,11 +423,11 @@ module Google
 
       # Response for the `Pull` method.
       # @!attribute [rw] received_messages
-      #   @return [Array<Google::Pubsub::V1::ReceivedMessage>]
-      #     Received Pub/Sub messages. The Pub/Sub system will return zero messages if
-      #     there are no more available in the backlog. The Pub/Sub system may return
-      #     fewer than the `maxMessages` requested even if there are more messages
-      #     available in the backlog.
+      #   @return [Array<Google::Cloud::PubSub::V1::ReceivedMessage>]
+      #     Received Pub/Sub messages. The list will be empty if there are no more
+      #     messages available in the backlog. For JSON, the response can be entirely
+      #     empty. The Pub/Sub system may return fewer than the `maxMessages` requested
+      #     even if there are more messages available in the backlog.
       class PullResponse; end
 
       # Request for the ModifyAckDeadline method.
@@ -409,8 +443,9 @@ module Google
       #     The new ack deadline with respect to the time this request was sent to
       #     the Pub/Sub system. For example, if the value is 10, the new
       #     ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
-      #     was made. Specifying zero may immediately make the message available for
-      #     another pull request.
+      #     was made. Specifying zero might immediately make the message available for
+      #     delivery to another subscriber client. This typically results in an
+      #     increase in the rate of message redeliveries (that is, duplicates).
       #     The minimum deadline you can specify is 0 seconds.
       #     The maximum deadline you can specify is 600 seconds (10 minutes).
       class ModifyAckDeadlineRequest; end
@@ -473,12 +508,12 @@ module Google
       # Response for the `StreamingPull` method. This response is used to stream
       # messages from the server to the client.
       # @!attribute [rw] received_messages
-      #   @return [Array<Google::Pubsub::V1::ReceivedMessage>]
+      #   @return [Array<Google::Cloud::PubSub::V1::ReceivedMessage>]
       #     Received Pub/Sub messages. This will not be empty.
       class StreamingPullResponse; 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.
       # @!attribute [rw] name
@@ -486,7 +521,9 @@ 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="https://cloud.google.com/pubsub/docs/admin#resource_names">
+      #     resource name rules</a>.
       #     Format is `projects/{project}/snapshots/{snap}`.
       # @!attribute [rw] subscription
       #   @return [String]
@@ -501,15 +538,16 @@ module Google
       #     Format is `projects/{project}/subscriptions/{sub}`.
       # @!attribute [rw] labels
       #   @return [Hash{String => String}]
-      #     User labels.
+      #     See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+      #     managing labels</a>.
       class CreateSnapshotRequest; 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.
       # @!attribute [rw] snapshot
-      #   @return [Google::Pubsub::V1::Snapshot]
+      #   @return [Google::Cloud::PubSub::V1::Snapshot]
       #     The updated snapshot object.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
@@ -517,8 +555,13 @@ module Google
       #     Must be specified and non-empty.
       class UpdateSnapshotRequest; 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="https://cloud.google.com/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.
       # @!attribute [rw] name
@@ -541,11 +584,12 @@ module Google
       #     snapshot that would expire in less than 1 hour after creation.
       # @!attribute [rw] labels
       #   @return [Hash{String => String}]
-      #     User labels.
+      #     See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+      #     managing labels</a>.
       class Snapshot; end
 
       # Request for the GetSnapshot 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.
       # @!attribute [rw] snapshot
@@ -555,13 +599,13 @@ module Google
       class GetSnapshotRequest; end
 
       # Request 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.
       # @!attribute [rw] project
       #   @return [String]
-      #     The name of the cloud project that snapshots belong to.
-      #     Format is `projects/{project}`.
+      #     The name of the project in which to list snapshots.
+      #     Format is `projects/{project-id}`.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Maximum number of snapshots to return.
@@ -573,11 +617,11 @@ module Google
       class ListSnapshotsRequest; 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.
       # @!attribute [rw] snapshots
-      #   @return [Array<Google::Pubsub::V1::Snapshot>]
+      #   @return [Array<Google::Cloud::PubSub::V1::Snapshot>]
       #     The resulting snapshots.
       # @!attribute [rw] next_page_token
       #   @return [String]
@@ -586,7 +630,7 @@ module Google
       class ListSnapshotsResponse; end
 
       # Request for the `DeleteSnapshot` 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.
       # @!attribute [rw] snapshot
@@ -595,8 +639,8 @@ module Google
       #     Format is `projects/{project}/snapshots/{snap}`.
       class DeleteSnapshotRequest; 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.
       # @!attribute [rw] subscription
@@ -622,7 +666,9 @@ module Google
       #     Format is `projects/{project}/snapshots/{snap}`.
       class SeekRequest; end
 
+      # Response for the `Seek` method (this response is empty).
       class SeekResponse; end
     end
   end
+  end
 end