google-cloud-pubsub 0.33.2 → 0.34.0

data/lib/google/cloud/pubsub/v1/publisher_client.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.
@@ -31,7 +31,7 @@ require "google/cloud/pubsub/v1/credentials"
 
 module Google
   module Cloud
-    module Pubsub
+    module PubSub
       module V1
         # The service that an application uses to manipulate topics, and to send
         # messages to a topic.
@@ -39,7 +39,7 @@ module Google
         # @!attribute [r] iam_policy_stub
         #   @return [Google::Iam::V1::IAMPolicy::Stub]
         # @!attribute [r] publisher_stub
-        #   @return [Google::Pubsub::V1::Publisher::Stub]
+        #   @return [Google::Cloud::PubSub::V1::Publisher::Stub]
         class PublisherClient
           # @private
           attr_reader :iam_policy_stub, :publisher_stub
@@ -164,10 +164,10 @@ module Google
             require "google/iam/v1/iam_policy_services_pb"
             require "google/pubsub/v1/pubsub_services_pb"
 
-            credentials ||= Google::Cloud::Pubsub::V1::Credentials.default
+            credentials ||= Google::Cloud::PubSub::V1::Credentials.default
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
-              updater_proc = Google::Cloud::Pubsub::V1::Credentials.new(credentials).updater_proc
+              updater_proc = Google::Cloud::PubSub::V1::Credentials.new(credentials).updater_proc
             end
             if credentials.is_a?(GRPC::Core::Channel)
               channel = credentials
@@ -231,7 +231,7 @@ module Google
               updater_proc: updater_proc,
               scopes: scopes,
               interceptors: interceptors,
-              &Google::Pubsub::V1::Publisher::Stub.method(:new)
+              &Google::Cloud::PubSub::V1::Publisher::Stub.method(:new)
             )
 
             @create_topic = Google::Gax.create_api_call(
@@ -289,7 +289,8 @@ module Google
           # Service calls
 
           # Creates the given topic with the given name. See the
-          # <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+          # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+          # resource name rules</a>.
           #
           # @param name [String]
           #   The name of the topic. It must have the format
@@ -299,29 +300,30 @@ module Google
           #   signs (`%`). It must be between 3 and 255 characters in length, and it
           #   must not start with `"goog"`.
           # @param labels [Hash{String => String}]
-          #   User labels.
-          # @param message_storage_policy [Google::Pubsub::V1::MessageStoragePolicy | Hash]
+          #   See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+          #   managing labels</a>.
+          # @param message_storage_policy [Google::Cloud::PubSub::V1::MessageStoragePolicy | Hash]
           #   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
           #   CreateTopic or to UpdateTopic. This field will be populated in the
           #   responses for GetTopic, CreateTopic, and UpdateTopic: if not present in the
           #   response, then no constraints are in effect.
-          #   A hash of the same form as `Google::Pubsub::V1::MessageStoragePolicy`
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::MessageStoragePolicy`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Topic]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Topic]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Topic]
+          # @return [Google::Cloud::PubSub::V1::Topic]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_name = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_name = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #   response = publisher_client.create_topic(formatted_name)
 
           def create_topic \
@@ -335,16 +337,16 @@ module Google
               labels: labels,
               message_storage_policy: message_storage_policy
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::Topic)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::Topic)
             @create_topic.call(req, options, &block)
           end
 
           # Updates an existing topic. Note that certain properties of a
           # topic are not modifiable.
           #
-          # @param topic [Google::Pubsub::V1::Topic | Hash]
+          # @param topic [Google::Cloud::PubSub::V1::Topic | Hash]
           #   The updated topic object.
-          #   A hash of the same form as `Google::Pubsub::V1::Topic`
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::Topic`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Indicates which fields in the provided topic to update. Must be specified
@@ -358,14 +360,14 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Topic]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Topic]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Topic]
+          # @return [Google::Cloud::PubSub::V1::Topic]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
           #
           #   # TODO: Initialize `topic`:
           #   topic = {}
@@ -383,34 +385,33 @@ module Google
               topic: topic,
               update_mask: update_mask
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::UpdateTopicRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::UpdateTopicRequest)
             @update_topic.call(req, options, &block)
           end
 
           # Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
-          # does not exist. The message payload must not be empty; it must contain
-          #  either a non-empty data field, or at least one attribute.
+          # does not exist.
           #
           # @param topic [String]
           #   The messages in the request will be published on this topic.
           #   Format is `projects/{project}/topics/{topic}`.
-          # @param messages [Array<Google::Pubsub::V1::PubsubMessage | Hash>]
+          # @param messages [Array<Google::Cloud::PubSub::V1::PubsubMessage | Hash>]
           #   The messages to publish.
-          #   A hash of the same form as `Google::Pubsub::V1::PubsubMessage`
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::PubsubMessage`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::PublishResponse]
+          # @yieldparam result [Google::Cloud::PubSub::V1::PublishResponse]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::PublishResponse]
+          # @return [Google::Cloud::PubSub::V1::PublishResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_topic = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_topic = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #   data = ''
           #   messages_element = { data: data }
           #   messages = [messages_element]
@@ -425,7 +426,7 @@ module Google
               topic: topic,
               messages: messages
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::PublishRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::PublishRequest)
             @publish.call(req, options, &block)
           end
 
@@ -438,15 +439,15 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Topic]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Topic]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Topic]
+          # @return [Google::Cloud::PubSub::V1::Topic]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_topic = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_topic = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #   response = publisher_client.get_topic(formatted_topic)
 
           def get_topic \
@@ -456,15 +457,15 @@ module Google
             req = {
               topic: topic
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::GetTopicRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::GetTopicRequest)
             @get_topic.call(req, options, &block)
           end
 
           # Lists matching topics.
           #
           # @param project [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}`.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -475,10 +476,10 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Topic>]
+          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::PubSub::V1::Topic>]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Topic>]
-          #   An enumerable of Google::Pubsub::V1::Topic instances.
+          # @return [Google::Gax::PagedEnumerable<Google::Cloud::PubSub::V1::Topic>]
+          #   An enumerable of Google::Cloud::PubSub::V1::Topic instances.
           #   See Google::Gax::PagedEnumerable documentation for other
           #   operations such as per-page iteration or access to the response
           #   object.
@@ -486,8 +487,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_project = Google::Cloud::Pubsub::V1::PublisherClient.project_path("[PROJECT]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_project = Google::Cloud::PubSub::V1::PublisherClient.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
           #   publisher_client.list_topics(formatted_project).each do |element|
@@ -511,7 +512,7 @@ module Google
               project: project,
               page_size: page_size
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::ListTopicsRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::ListTopicsRequest)
             @list_topics.call(req, options, &block)
           end
 
@@ -541,8 +542,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_topic = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_topic = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #
           #   # Iterate over all results.
           #   publisher_client.list_topic_subscriptions(formatted_topic).each do |element|
@@ -566,7 +567,7 @@ module Google
               topic: topic,
               page_size: page_size
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::ListTopicSubscriptionsRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::ListTopicSubscriptionsRequest)
             @list_topic_subscriptions.call(req, options, &block)
           end
 
@@ -589,8 +590,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_topic = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_topic = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #   publisher_client.delete_topic(formatted_topic)
 
           def delete_topic \
@@ -600,7 +601,7 @@ module Google
             req = {
               topic: topic
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::DeleteTopicRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::DeleteTopicRequest)
             @delete_topic.call(req, options, &block)
             nil
           end
@@ -630,8 +631,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_resource = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_resource = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #
           #   # TODO: Initialize `policy`:
           #   policy = {}
@@ -669,8 +670,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_resource = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_resource = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #   response = publisher_client.get_iam_policy(formatted_resource)
 
           def get_iam_policy \
@@ -708,8 +709,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   publisher_client = Google::Cloud::Pubsub::Publisher.new(version: :v1)
-          #   formatted_resource = Google::Cloud::Pubsub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_client = Google::Cloud::PubSub::Publisher.new(version: :v1)
+          #   formatted_resource = Google::Cloud::PubSub::V1::PublisherClient.topic_path("[PROJECT]", "[TOPIC]")
           #
           #   # TODO: Initialize `permissions`:
           #   permissions = []
@@ -730,5 +731,7 @@ module Google
         end
       end
     end
+
+    Pubsub = PubSub unless const_defined? :Pubsub
   end
 end

data/lib/google/cloud/pubsub/v1/publisher_client_config.json

@@ -6,10 +6,6 @@
           "DEADLINE_EXCEEDED",
           "UNAVAILABLE"
         ],
-        "http_get": [
-          "DEADLINE_EXCEEDED",
-          "UNAVAILABLE"
-        ],
         "non_idempotent": [],
         "one_plus_delivery": [
           "ABORTED",

data/lib/google/cloud/pubsub/v1/subscriber_client.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.
@@ -31,7 +31,7 @@ require "google/cloud/pubsub/v1/credentials"
 
 module Google
   module Cloud
-    module Pubsub
+    module PubSub
       module V1
         # The service that an application uses to manipulate subscriptions and to
         # consume messages from a subscription via the `Pull` method or by
@@ -40,7 +40,7 @@ module Google
         # @!attribute [r] iam_policy_stub
         #   @return [Google::Iam::V1::IAMPolicy::Stub]
         # @!attribute [r] subscriber_stub
-        #   @return [Google::Pubsub::V1::Subscriber::Stub]
+        #   @return [Google::Cloud::PubSub::V1::Subscriber::Stub]
         class SubscriberClient
           # @private
           attr_reader :iam_policy_stub, :subscriber_stub
@@ -188,10 +188,10 @@ module Google
             require "google/iam/v1/iam_policy_services_pb"
             require "google/pubsub/v1/pubsub_services_pb"
 
-            credentials ||= Google::Cloud::Pubsub::V1::Credentials.default
+            credentials ||= Google::Cloud::PubSub::V1::Credentials.default
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
-              updater_proc = Google::Cloud::Pubsub::V1::Credentials.new(credentials).updater_proc
+              updater_proc = Google::Cloud::PubSub::V1::Credentials.new(credentials).updater_proc
             end
             if credentials.is_a?(GRPC::Core::Channel)
               channel = credentials
@@ -254,7 +254,7 @@ module Google
               updater_proc: updater_proc,
               scopes: scopes,
               interceptors: interceptors,
-              &Google::Pubsub::V1::Subscriber::Stub.method(:new)
+              &Google::Cloud::PubSub::V1::Subscriber::Stub.method(:new)
             )
 
             @create_subscription = Google::Gax.create_api_call(
@@ -352,14 +352,15 @@ module Google
           # Service calls
 
           # Creates a subscription to a given topic. See the
-          # <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+          # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+          # resource name rules</a>.
           # If the subscription already exists, returns `ALREADY_EXISTS`.
           # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
           #
           # If the name is not provided in the request, the server will assign a random
           # name for this subscription on the same project as the topic, conforming
           # to the
-          # [resource name format](https://cloud.google.com/pubsub/docs/overview#names).
+          # [resource name format](https://cloud.google.com/pubsub/docs/admin#resource_names).
           # The generated name is populated in the returned Subscription object.
           # Note that for REST API requests, you must specify a name in the request.
           #
@@ -375,18 +376,18 @@ module Google
           #   Format is `projects/{project}/topics/{topic}`.
           #   The value of this field will be `_deleted-topic_` if the topic has been
           #   deleted.
-          # @param push_config [Google::Pubsub::V1::PushConfig | Hash]
+          # @param push_config [Google::Cloud::PubSub::V1::PushConfig | Hash]
           #   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.
-          #   A hash of the same form as `Google::Pubsub::V1::PushConfig`
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::PushConfig`
           #   can also be provided.
           # @param ack_deadline_seconds [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
@@ -406,8 +407,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.
           # @param message_retention_duration [Google::Protobuf::Duration | Hash]
@@ -417,27 +421,40 @@ 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.
           #   A hash of the same form as `Google::Protobuf::Duration`
           #   can also be provided.
           # @param labels [Hash{String => String}]
-          #   User labels.
+          #   See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+          #   managing labels</a>.
+          # @param expiration_policy [Google::Cloud::PubSub::V1::ExpirationPolicy | Hash]
+          #   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.
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::ExpirationPolicy`
+          #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Subscription]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Subscription]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Subscription]
+          # @return [Google::Cloud::PubSub::V1::Subscription]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_name = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
-          #   formatted_topic = Google::Cloud::Pubsub::V1::SubscriberClient.topic_path("[PROJECT]", "[TOPIC]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_name = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   formatted_topic = Google::Cloud::PubSub::V1::SubscriberClient.topic_path("[PROJECT]", "[TOPIC]")
           #   response = subscriber_client.create_subscription(formatted_name, formatted_topic)
 
           def create_subscription \
@@ -448,6 +465,7 @@ module Google
               retain_acked_messages: nil,
               message_retention_duration: nil,
               labels: nil,
+              expiration_policy: nil,
               options: nil,
               &block
             req = {
@@ -457,9 +475,10 @@ module Google
               ack_deadline_seconds: ack_deadline_seconds,
               retain_acked_messages: retain_acked_messages,
               message_retention_duration: message_retention_duration,
-              labels: labels
+              labels: labels,
+              expiration_policy: expiration_policy
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::Subscription)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::Subscription)
             @create_subscription.call(req, options, &block)
           end
 
@@ -472,15 +491,15 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Subscription]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Subscription]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Subscription]
+          # @return [Google::Cloud::PubSub::V1::Subscription]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #   response = subscriber_client.get_subscription(formatted_subscription)
 
           def get_subscription \
@@ -490,16 +509,16 @@ module Google
             req = {
               subscription: subscription
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::GetSubscriptionRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::GetSubscriptionRequest)
             @get_subscription.call(req, options, &block)
           end
 
           # Updates an existing subscription. Note that certain properties of a
           # subscription, such as its topic, are not modifiable.
           #
-          # @param subscription [Google::Pubsub::V1::Subscription | Hash]
+          # @param subscription [Google::Cloud::PubSub::V1::Subscription | Hash]
           #   The updated subscription object.
-          #   A hash of the same form as `Google::Pubsub::V1::Subscription`
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::Subscription`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Indicates which fields in the provided subscription to update.
@@ -510,14 +529,14 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Subscription]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Subscription]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Subscription]
+          # @return [Google::Cloud::PubSub::V1::Subscription]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
           #   ack_deadline_seconds = 42
           #   subscription = { ack_deadline_seconds: ack_deadline_seconds }
           #   paths_element = "ack_deadline_seconds"
@@ -534,15 +553,15 @@ module Google
               subscription: subscription,
               update_mask: update_mask
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::UpdateSubscriptionRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::UpdateSubscriptionRequest)
             @update_subscription.call(req, options, &block)
           end
 
           # Lists matching subscriptions.
           #
           # @param project [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}`.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -553,10 +572,10 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Subscription>]
+          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::PubSub::V1::Subscription>]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Subscription>]
-          #   An enumerable of Google::Pubsub::V1::Subscription instances.
+          # @return [Google::Gax::PagedEnumerable<Google::Cloud::PubSub::V1::Subscription>]
+          #   An enumerable of Google::Cloud::PubSub::V1::Subscription instances.
           #   See Google::Gax::PagedEnumerable documentation for other
           #   operations such as per-page iteration or access to the response
           #   object.
@@ -564,8 +583,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_project = Google::Cloud::Pubsub::V1::SubscriberClient.project_path("[PROJECT]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_project = Google::Cloud::PubSub::V1::SubscriberClient.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
           #   subscriber_client.list_subscriptions(formatted_project).each do |element|
@@ -589,7 +608,7 @@ module Google
               project: project,
               page_size: page_size
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::ListSubscriptionsRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::ListSubscriptionsRequest)
             @list_subscriptions.call(req, options, &block)
           end
 
@@ -612,8 +631,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #   subscriber_client.delete_subscription(formatted_subscription)
 
           def delete_subscription \
@@ -623,7 +642,7 @@ module Google
             req = {
               subscription: subscription
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::DeleteSubscriptionRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::DeleteSubscriptionRequest)
             @delete_subscription.call(req, options, &block)
             nil
           end
@@ -643,8 +662,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).
           # @param options [Google::Gax::CallOptions]
@@ -657,8 +677,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #
           #   # TODO: Initialize `ack_ids`:
           #   ack_ids = []
@@ -678,7 +698,7 @@ module Google
               ack_ids: ack_ids,
               ack_deadline_seconds: ack_deadline_seconds
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::ModifyAckDeadlineRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::ModifyAckDeadlineRequest)
             @modify_ack_deadline.call(req, options, &block)
             nil
           end
@@ -707,8 +727,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #
           #   # TODO: Initialize `ack_ids`:
           #   ack_ids = []
@@ -723,13 +743,12 @@ module Google
               subscription: subscription,
               ack_ids: ack_ids
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::AcknowledgeRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::AcknowledgeRequest)
             @acknowledge.call(req, options, &block)
             nil
           end
 
-          # Pulls messages from the server. Returns an empty list if there are no
-          # messages available in the backlog. The server may return `UNAVAILABLE` if
+          # Pulls messages from the server. The server may return `UNAVAILABLE` if
           # there are too many concurrent pull requests pending for the given
           # subscription.
           #
@@ -743,22 +762,20 @@ 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.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::PullResponse]
+          # @yieldparam result [Google::Cloud::PubSub::V1::PullResponse]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::PullResponse]
+          # @return [Google::Cloud::PubSub::V1::PullResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #
           #   # TODO: Initialize `max_messages`:
           #   max_messages = 0
@@ -775,7 +792,7 @@ module Google
               max_messages: max_messages,
               return_immediately: return_immediately
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::PullRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::PullRequest)
             @pull.call(req, options, &block)
           end
 
@@ -787,13 +804,13 @@ module Google
           # re-establish the stream. Flow control can be achieved by configuring the
           # underlying RPC channel.
           #
-          # @param reqs [Enumerable<Google::Pubsub::V1::StreamingPullRequest>]
+          # @param reqs [Enumerable<Google::Cloud::PubSub::V1::StreamingPullRequest>]
           #   The input requests.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @return [Enumerable<Google::Pubsub::V1::StreamingPullResponse>]
-          #   An enumerable of Google::Pubsub::V1::StreamingPullResponse instances.
+          # @return [Enumerable<Google::Cloud::PubSub::V1::StreamingPullResponse>]
+          #   An enumerable of Google::Cloud::PubSub::V1::StreamingPullResponse instances.
           #
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           #
@@ -805,8 +822,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #
           #   # TODO: Initialize `stream_ack_deadline_seconds`:
           #   stream_ack_deadline_seconds = 0
@@ -818,7 +835,7 @@ module Google
 
           def streaming_pull reqs, options: nil
             request_protos = reqs.lazy.map do |req|
-              Google::Gax::to_proto(req, Google::Pubsub::V1::StreamingPullRequest)
+              Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::StreamingPullRequest)
             end
             @streaming_pull.call(request_protos, options)
           end
@@ -833,14 +850,14 @@ module Google
           # @param subscription [String]
           #   The name of the subscription.
           #   Format is `projects/{project}/subscriptions/{sub}`.
-          # @param push_config [Google::Pubsub::V1::PushConfig | Hash]
+          # @param push_config [Google::Cloud::PubSub::V1::PushConfig | Hash]
           #   The push configuration for future deliveries.
           #
           #   An empty `pushConfig` indicates that the Pub/Sub system should
           #   stop pushing messages from the given subscription and allow
           #   messages to be pulled and acknowledged - effectively pausing
           #   the subscription if `Pull` or `StreamingPull` is not called.
-          #   A hash of the same form as `Google::Pubsub::V1::PushConfig`
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::PushConfig`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -852,8 +869,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #
           #   # TODO: Initialize `push_config`:
           #   push_config = {}
@@ -868,19 +885,24 @@ module Google
               subscription: subscription,
               push_config: push_config
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::ModifyPushConfigRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::ModifyPushConfigRequest)
             @modify_push_config.call(req, options, &block)
             nil
           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="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.
           #
           # @param project [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}`.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -891,10 +913,10 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Snapshot>]
+          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::PubSub::V1::Snapshot>]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Snapshot>]
-          #   An enumerable of Google::Pubsub::V1::Snapshot instances.
+          # @return [Google::Gax::PagedEnumerable<Google::Cloud::PubSub::V1::Snapshot>]
+          #   An enumerable of Google::Cloud::PubSub::V1::Snapshot instances.
           #   See Google::Gax::PagedEnumerable documentation for other
           #   operations such as per-page iteration or access to the response
           #   object.
@@ -902,8 +924,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_project = Google::Cloud::Pubsub::V1::SubscriberClient.project_path("[PROJECT]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_project = Google::Cloud::PubSub::V1::SubscriberClient.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
           #   subscriber_client.list_snapshots(formatted_project).each do |element|
@@ -927,14 +949,20 @@ module Google
               project: project,
               page_size: page_size
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::ListSnapshotsRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::ListSnapshotsRequest)
             @list_snapshots.call(req, options, &block)
           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="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.
+          # 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
@@ -942,16 +970,18 @@ module Google
           # See also the `Snapshot.expire_time` field. 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, conforming
-          # to the [resource name format](https://cloud.google.com/pubsub/docs/overview#names).
-          # The generated
-          # name is populated in the returned Snapshot object. Note that for REST API
-          # requests, you must specify a name in the request.
+          # to the
+          # [resource name format](https://cloud.google.com/pubsub/docs/admin#resource_names).
+          # The generated name is populated in the returned Snapshot object. Note that
+          # for REST API requests, you must specify a name in the request.
           #
           # @param name [String]
           #   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}`.
           # @param subscription [String]
           #   The subscription whose backlog the snapshot retains.
@@ -964,21 +994,22 @@ module Google
           #        successful completion of the CreateSnapshot request.
           #   Format is `projects/{project}/subscriptions/{sub}`.
           # @param labels [Hash{String => String}]
-          #   User labels.
+          #   See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+          #   managing labels</a>.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Snapshot]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Snapshot]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Snapshot]
+          # @return [Google::Cloud::PubSub::V1::Snapshot]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_name = Google::Cloud::Pubsub::V1::SubscriberClient.snapshot_path("[PROJECT]", "[SNAPSHOT]")
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_name = Google::Cloud::PubSub::V1::SubscriberClient.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #   response = subscriber_client.create_snapshot(formatted_name, formatted_subscription)
 
           def create_snapshot \
@@ -992,19 +1023,24 @@ module Google
               subscription: subscription,
               labels: labels
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::CreateSnapshotRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::CreateSnapshotRequest)
             @create_snapshot.call(req, options, &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="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.
           # Note that certain properties of a snapshot are not modifiable.
           #
-          # @param snapshot [Google::Pubsub::V1::Snapshot | Hash]
+          # @param snapshot [Google::Cloud::PubSub::V1::Snapshot | Hash]
           #   The updated snapshot object.
-          #   A hash of the same form as `Google::Pubsub::V1::Snapshot`
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::Snapshot`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Indicates which fields in the provided snapshot to update.
@@ -1015,14 +1051,14 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::Snapshot]
+          # @yieldparam result [Google::Cloud::PubSub::V1::Snapshot]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::Snapshot]
+          # @return [Google::Cloud::PubSub::V1::Snapshot]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
           #   seconds = 123456
           #   expire_time = { seconds: seconds }
           #   snapshot = { expire_time: expire_time }
@@ -1040,12 +1076,17 @@ module Google
               snapshot: snapshot,
               update_mask: update_mask
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::UpdateSnapshotRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::UpdateSnapshotRequest)
             @update_snapshot.call(req, options, &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="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.
           # When the snapshot is deleted, all messages retained in the snapshot
@@ -1066,8 +1107,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_snapshot = Google::Cloud::Pubsub::V1::SubscriberClient.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_snapshot = Google::Cloud::PubSub::V1::SubscriberClient.snapshot_path("[PROJECT]", "[SNAPSHOT]")
           #   subscriber_client.delete_snapshot(formatted_snapshot)
 
           def delete_snapshot \
@@ -1077,14 +1118,20 @@ module Google
             req = {
               snapshot: snapshot
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::DeleteSnapshotRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::DeleteSnapshotRequest)
             @delete_snapshot.call(req, options, &block)
             nil
           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="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. 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.
           #
@@ -1112,15 +1159,15 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Pubsub::V1::SeekResponse]
+          # @yieldparam result [Google::Cloud::PubSub::V1::SeekResponse]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Pubsub::V1::SeekResponse]
+          # @return [Google::Cloud::PubSub::V1::SeekResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_subscription = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_subscription = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #   response = subscriber_client.seek(formatted_subscription)
 
           def seek \
@@ -1134,7 +1181,7 @@ module Google
               time: time,
               snapshot: snapshot
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Pubsub::V1::SeekRequest)
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::SeekRequest)
             @seek.call(req, options, &block)
           end
 
@@ -1163,8 +1210,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #
           #   # TODO: Initialize `policy`:
           #   policy = {}
@@ -1202,8 +1249,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #   response = subscriber_client.get_iam_policy(formatted_resource)
 
           def get_iam_policy \
@@ -1241,8 +1288,8 @@ module Google
           # @example
           #   require "google/cloud/pubsub"
           #
-          #   subscriber_client = Google::Cloud::Pubsub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::Pubsub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
           #
           #   # TODO: Initialize `permissions`:
           #   permissions = []
@@ -1263,5 +1310,7 @@ module Google
         end
       end
     end
+
+    Pubsub = PubSub unless const_defined? :Pubsub
   end
 end