google-cloud-pubsub 0.20.1 → 0.21.0

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

@@ -40,10 +40,9 @@ module Google
           # @return [Boolean]
           #
           # @example
-          #   require "google/cloud"
+          #   require "google/cloud/pubsub"
           #
-          #   gcloud = Google::Cloud.new
-          #   pubsub = gcloud.pubsub
+          #   pubsub = Google::Cloud::Pubsub.new
           #
           #   topics = pubsub.topics
           #   if topics.next?
@@ -60,10 +59,9 @@ module Google
           # @return [Topic::List]
           #
           # @example
-          #   require "google/cloud"
+          #   require "google/cloud/pubsub"
           #
-          #   gcloud = Google::Cloud.new
-          #   pubsub = gcloud.pubsub
+          #   pubsub = Google::Cloud::Pubsub.new
           #
           #   topics = pubsub.topics
           #   if topics.next?
@@ -97,10 +95,9 @@ module Google
           # @return [Enumerator]
           #
           # @example Iterating each topic by passing a block:
-          #   require "google/cloud"
+          #   require "google/cloud/pubsub"
           #
-          #   gcloud = Google::Cloud.new
-          #   pubsub = gcloud.pubsub
+          #   pubsub = Google::Cloud::Pubsub.new
           #
           #   topics = pubsub.topics
           #   topics.all do |topic|
@@ -108,10 +105,9 @@ module Google
           #   end
           #
           # @example Using the enumerator by not passing a block:
-          #   require "google/cloud"
+          #   require "google/cloud/pubsub"
           #
-          #   gcloud = Google::Cloud.new
-          #   pubsub = gcloud.pubsub
+          #   pubsub = Google::Cloud::Pubsub.new
           #
           #   topics = pubsub.topics
           #   all_names = topics.all.map do |topic|
@@ -119,10 +115,9 @@ module Google
           #   end
           #
           # @example Limit the number of API calls made:
-          #   require "google/cloud"
+          #   require "google/cloud/pubsub"
           #
-          #   gcloud = Google::Cloud.new
-          #   pubsub = gcloud.pubsub
+          #   pubsub = Google::Cloud::Pubsub.new
           #
           #   topics = pubsub.topics
           #   topics.all(request_limit: 10) do |topic|

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

@@ -21,10 +21,9 @@ module Google
         # Topic Publisher object used to publish multiple messages at once.
         #
         # @example
-        #   require "google/cloud"
+        #   require "google/cloud/pubsub"
         #
-        #   gcloud = Google::Cloud.new
-        #   pubsub = gcloud.pubsub
+        #   pubsub = Google::Cloud::Pubsub.new
         #
         #   topic = pubsub.topic "my-topic"
         #   msgs = topic.publish do |t|

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

@@ -26,7 +26,8 @@ require "json"
 require "pathname"
 
 require "google/gax"
-require "google/pubsub/v1/pubsub_services_pb"
+require "google/iam/v1/iam_policy_pb"
+require "google/pubsub/v1/pubsub_pb"
 
 module Google
   module Cloud
@@ -35,10 +36,12 @@ module Google
         # The service that an application uses to manipulate topics, and to send
         # messages to a topic.
         #
-        # @!attribute [r] stub
+        # @!attribute [r] iam_policy_stub
+        #   @return [Google::Iam::V1::IAMPolicy::Stub]
+        # @!attribute [r] publisher_stub
         #   @return [Google::Pubsub::V1::Publisher::Stub]
         class PublisherApi
-          attr_reader :stub
+          attr_reader :iam_policy_stub, :publisher_stub
 
           # The default address of the service.
           SERVICE_ADDRESS = "pubsub.googleapis.com".freeze
@@ -163,8 +166,16 @@ module Google
               timeout: DEFAULT_TIMEOUT,
               app_name: "gax",
               app_version: Google::Gax::VERSION
+            # These require statements are intentionally placed here to initialize
+            # the gRPC module only when it's required.
+            # See https://github.com/googleapis/toolkit/issues/446
+            require "google/gax/grpc"
+            require "google/iam/v1/iam_policy_services_pb"
+            require "google/pubsub/v1/pubsub_services_pb"
+
             google_api_client = "#{app_name}/#{app_version} " \
-              "#{CODE_GEN_NAME_VERSION} ruby/#{RUBY_VERSION}".freeze
+              "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
+              "ruby/#{RUBY_VERSION}".freeze
             headers = { :"x-goog-api-client" => google_api_client }
             client_config_file = Pathname.new(__dir__).join(
               "publisher_client_config.json"
@@ -182,7 +193,15 @@ module Google
                 kwargs: headers
               )
             end
-            @stub = Google::Gax::Grpc.create_stub(
+            @iam_policy_stub = Google::Gax::Grpc.create_stub(
+              service_path,
+              port,
+              chan_creds: chan_creds,
+              channel: channel,
+              scopes: scopes,
+              &Google::Iam::V1::IAMPolicy::Stub.method(:new)
+            )
+            @publisher_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
               chan_creds: chan_creds,
@@ -191,28 +210,40 @@ module Google
               &Google::Pubsub::V1::Publisher::Stub.method(:new)
             )
 
+            @set_iam_policy = Google::Gax.create_api_call(
+              @iam_policy_stub.method(:set_iam_policy),
+              defaults["set_iam_policy"]
+            )
+            @get_iam_policy = Google::Gax.create_api_call(
+              @iam_policy_stub.method(:get_iam_policy),
+              defaults["get_iam_policy"]
+            )
+            @test_iam_permissions = Google::Gax.create_api_call(
+              @iam_policy_stub.method(:test_iam_permissions),
+              defaults["test_iam_permissions"]
+            )
             @create_topic = Google::Gax.create_api_call(
-              @stub.method(:create_topic),
+              @publisher_stub.method(:create_topic),
               defaults["create_topic"]
             )
             @publish = Google::Gax.create_api_call(
-              @stub.method(:publish),
+              @publisher_stub.method(:publish),
               defaults["publish"]
             )
             @get_topic = Google::Gax.create_api_call(
-              @stub.method(:get_topic),
+              @publisher_stub.method(:get_topic),
               defaults["get_topic"]
             )
             @list_topics = Google::Gax.create_api_call(
-              @stub.method(:list_topics),
+              @publisher_stub.method(:list_topics),
               defaults["list_topics"]
             )
             @list_topic_subscriptions = Google::Gax.create_api_call(
-              @stub.method(:list_topic_subscriptions),
+              @publisher_stub.method(:list_topic_subscriptions),
               defaults["list_topic_subscriptions"]
             )
             @delete_topic = Google::Gax.create_api_call(
-              @stub.method(:delete_topic),
+              @publisher_stub.method(:delete_topic),
               defaults["delete_topic"]
             )
           end
@@ -233,6 +264,15 @@ module Google
           #   retries, etc.
           # @return [Google::Pubsub::V1::Topic]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_name = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   response = publisher_api.create_topic(formatted_name)
+
           def create_topic \
               name,
               options: nil
@@ -255,6 +295,20 @@ module Google
           #   retries, etc.
           # @return [Google::Pubsub::V1::PublishResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #   PubsubMessage = Google::Pubsub::V1::PubsubMessage
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_topic = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   data = ''
+          #   messages_element = PubsubMessage.new
+          #   messages_element.data = data
+          #   messages = [messages_element]
+          #   response = publisher_api.publish(formatted_topic, messages)
+
           def publish \
               topic,
               messages,
@@ -275,6 +329,15 @@ module Google
           #   retries, etc.
           # @return [Google::Pubsub::V1::Topic]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_topic = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   response = publisher_api.get_topic(formatted_topic)
+
           def get_topic \
               topic,
               options: nil
@@ -303,6 +366,27 @@ module Google
           #   operations such as per-page iteration or access to the response
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_project = PublisherApi.project_path("[PROJECT]")
+          #
+          #   # Iterate over all results.
+          #   publisher_api.list_topics(formatted_project).each do |element|
+          #     # Process element.
+          #   end
+          #
+          #   # Or iterate over results one page at a time.
+          #   publisher_api.list_topics(formatted_project).each_page do |page|
+          #     # Process each page at a time.
+          #     page.each do |element|
+          #       # Process element.
+          #     end
+          #   end
+
           def list_topics \
               project,
               page_size: nil,
@@ -333,6 +417,27 @@ module Google
           #   operations such as per-page iteration or access to the response
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_topic = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #
+          #   # Iterate over all results.
+          #   publisher_api.list_topic_subscriptions(formatted_topic).each do |element|
+          #     # Process element.
+          #   end
+          #
+          #   # Or iterate over results one page at a time.
+          #   publisher_api.list_topic_subscriptions(formatted_topic).each_page do |page|
+          #     # Process each page at a time.
+          #     page.each do |element|
+          #       # Process element.
+          #     end
+          #   end
+
           def list_topic_subscriptions \
               topic,
               page_size: nil,
@@ -356,6 +461,15 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_topic = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   publisher_api.delete_topic(formatted_topic)
+
           def delete_topic \
               topic,
               options: nil
@@ -364,6 +478,113 @@ module Google
             )
             @delete_topic.call(req, options)
           end
+
+          # Sets the access control policy on the specified resource. Replaces any
+          # existing policy.
+          #
+          # @param resource [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}+.
+          # @param policy [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.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Iam::V1::Policy]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   Policy = Google::Iam::V1::Policy
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_resource = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   policy = Policy.new
+          #   response = publisher_api.set_iam_policy(formatted_resource, policy)
+
+          def set_iam_policy \
+              resource,
+              policy,
+              options: nil
+            req = Google::Iam::V1::SetIamPolicyRequest.new(
+              resource: resource,
+              policy: policy
+            )
+            @set_iam_policy.call(req, options)
+          end
+
+          # Gets the access control policy for a resource.
+          # Returns an empty policy if the resource exists and does not have a policy
+          # set.
+          #
+          # @param resource [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}+.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Iam::V1::Policy]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_resource = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   response = publisher_api.get_iam_policy(formatted_resource)
+
+          def get_iam_policy \
+              resource,
+              options: nil
+            req = Google::Iam::V1::GetIamPolicyRequest.new(
+              resource: resource
+            )
+            @get_iam_policy.call(req, options)
+          end
+
+          # Returns permissions that a caller has on the specified resource.
+          #
+          # @param resource [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}+.
+          # @param permissions [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].
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Iam::V1::TestIamPermissionsResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/publisher_api"
+          #
+          #   PublisherApi = Google::Cloud::Pubsub::V1::PublisherApi
+          #
+          #   publisher_api = PublisherApi.new
+          #   formatted_resource = PublisherApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   permissions = []
+          #   response = publisher_api.test_iam_permissions(formatted_resource, permissions)
+
+          def test_iam_permissions \
+              resource,
+              permissions,
+              options: nil
+            req = Google::Iam::V1::TestIamPermissionsRequest.new(
+              resource: resource,
+              permissions: permissions
+            )
+            @test_iam_permissions.call(req, options)
+          end
         end
       end
     end

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

@@ -71,6 +71,21 @@
           "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
+        },
+        "SetIamPolicy": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "GetIamPolicy": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "TestIamPermissions": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
         }
       }
     }

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

@@ -26,7 +26,8 @@ require "json"
 require "pathname"
 
 require "google/gax"
-require "google/pubsub/v1/pubsub_services_pb"
+require "google/iam/v1/iam_policy_pb"
+require "google/pubsub/v1/pubsub_pb"
 
 module Google
   module Cloud
@@ -35,10 +36,12 @@ module Google
         # The service that an application uses to manipulate subscriptions and to
         # consume messages from a subscription via the +Pull+ method.
         #
-        # @!attribute [r] stub
+        # @!attribute [r] iam_policy_stub
+        #   @return [Google::Iam::V1::IAMPolicy::Stub]
+        # @!attribute [r] subscriber_stub
         #   @return [Google::Pubsub::V1::Subscriber::Stub]
         class SubscriberApi
-          attr_reader :stub
+          attr_reader :iam_policy_stub, :subscriber_stub
 
           # The default address of the service.
           SERVICE_ADDRESS = "pubsub.googleapis.com".freeze
@@ -179,8 +182,16 @@ module Google
               timeout: DEFAULT_TIMEOUT,
               app_name: "gax",
               app_version: Google::Gax::VERSION
+            # These require statements are intentionally placed here to initialize
+            # the gRPC module only when it's required.
+            # See https://github.com/googleapis/toolkit/issues/446
+            require "google/gax/grpc"
+            require "google/iam/v1/iam_policy_services_pb"
+            require "google/pubsub/v1/pubsub_services_pb"
+
             google_api_client = "#{app_name}/#{app_version} " \
-              "#{CODE_GEN_NAME_VERSION} ruby/#{RUBY_VERSION}".freeze
+              "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
+              "ruby/#{RUBY_VERSION}".freeze
             headers = { :"x-goog-api-client" => google_api_client }
             client_config_file = Pathname.new(__dir__).join(
               "subscriber_client_config.json"
@@ -197,7 +208,15 @@ module Google
                 kwargs: headers
               )
             end
-            @stub = Google::Gax::Grpc.create_stub(
+            @iam_policy_stub = Google::Gax::Grpc.create_stub(
+              service_path,
+              port,
+              chan_creds: chan_creds,
+              channel: channel,
+              scopes: scopes,
+              &Google::Iam::V1::IAMPolicy::Stub.method(:new)
+            )
+            @subscriber_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
               chan_creds: chan_creds,
@@ -206,48 +225,61 @@ module Google
               &Google::Pubsub::V1::Subscriber::Stub.method(:new)
             )
 
+            @set_iam_policy = Google::Gax.create_api_call(
+              @iam_policy_stub.method(:set_iam_policy),
+              defaults["set_iam_policy"]
+            )
+            @get_iam_policy = Google::Gax.create_api_call(
+              @iam_policy_stub.method(:get_iam_policy),
+              defaults["get_iam_policy"]
+            )
+            @test_iam_permissions = Google::Gax.create_api_call(
+              @iam_policy_stub.method(:test_iam_permissions),
+              defaults["test_iam_permissions"]
+            )
             @create_subscription = Google::Gax.create_api_call(
-              @stub.method(:create_subscription),
+              @subscriber_stub.method(:create_subscription),
               defaults["create_subscription"]
             )
             @get_subscription = Google::Gax.create_api_call(
-              @stub.method(:get_subscription),
+              @subscriber_stub.method(:get_subscription),
               defaults["get_subscription"]
             )
             @list_subscriptions = Google::Gax.create_api_call(
-              @stub.method(:list_subscriptions),
+              @subscriber_stub.method(:list_subscriptions),
               defaults["list_subscriptions"]
             )
             @delete_subscription = Google::Gax.create_api_call(
-              @stub.method(:delete_subscription),
+              @subscriber_stub.method(:delete_subscription),
               defaults["delete_subscription"]
             )
             @modify_ack_deadline = Google::Gax.create_api_call(
-              @stub.method(:modify_ack_deadline),
+              @subscriber_stub.method(:modify_ack_deadline),
               defaults["modify_ack_deadline"]
             )
             @acknowledge = Google::Gax.create_api_call(
-              @stub.method(:acknowledge),
+              @subscriber_stub.method(:acknowledge),
               defaults["acknowledge"]
             )
             @pull = Google::Gax.create_api_call(
-              @stub.method(:pull),
+              @subscriber_stub.method(:pull),
               defaults["pull"]
             )
             @modify_push_config = Google::Gax.create_api_call(
-              @stub.method(:modify_push_config),
+              @subscriber_stub.method(:modify_push_config),
               defaults["modify_push_config"]
             )
           end
 
           # Service calls
 
-          # Creates a subscription to a given topic for a given subscriber.
+          # Creates a subscription to a given topic.
           # 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.
+          # name for this subscription on the same project as the topic. Note that
+          # for REST API requests, you must specify a name.
           #
           # @param name [String]
           #   The name of the subscription. It must have the format
@@ -275,6 +307,7 @@ module Google
           #   deadline. To override this value for a given message, call
           #   +ModifyAckDeadline+ with the corresponding +ack_id+ if using
           #   pull.
+          #   The maximum custom deadline you can specify is 600 seconds (10 minutes).
           #
           #   For push delivery, this value is also used to set the request timeout for
           #   the call to the push endpoint.
@@ -282,12 +315,22 @@ module Google
           #   If the subscriber never acknowledges the message, the Pub/Sub
           #   system will eventually redeliver the message.
           #
-          #   If this parameter is not set, the default value of 10 seconds is used.
+          #   If this parameter is 0, a default value of 10 seconds is used.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @return [Google::Pubsub::V1::Subscription]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_name = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   formatted_topic = SubscriberApi.topic_path("[PROJECT]", "[TOPIC]")
+          #   response = subscriber_api.create_subscription(formatted_name, formatted_topic)
+
           def create_subscription \
               name,
               topic,
@@ -312,6 +355,15 @@ module Google
           #   retries, etc.
           # @return [Google::Pubsub::V1::Subscription]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_subscription = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   response = subscriber_api.get_subscription(formatted_subscription)
+
           def get_subscription \
               subscription,
               options: nil
@@ -340,6 +392,27 @@ module Google
           #   operations such as per-page iteration or access to the response
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_project = SubscriberApi.project_path("[PROJECT]")
+          #
+          #   # Iterate over all results.
+          #   subscriber_api.list_subscriptions(formatted_project).each do |element|
+          #     # Process element.
+          #   end
+          #
+          #   # Or iterate over results one page at a time.
+          #   subscriber_api.list_subscriptions(formatted_project).each_page do |page|
+          #     # Process each page at a time.
+          #     page.each do |element|
+          #       # Process element.
+          #     end
+          #   end
+
           def list_subscriptions \
               project,
               page_size: nil,
@@ -363,6 +436,15 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_subscription = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   subscriber_api.delete_subscription(formatted_subscription)
+
           def delete_subscription \
               subscription,
               options: nil
@@ -375,7 +457,8 @@ module Google
           # Modifies the ack deadline for a specific message. This method is useful
           # to indicate that more time is needed to process a message by the
           # subscriber, or to make the message available for redelivery if the
-          # processing was interrupted.
+          # processing was interrupted. Note that this does not modify the
+          # subscription-level +ackDeadlineSeconds+ used for subsequent messages.
           #
           # @param subscription [String]
           #   The name of the subscription.
@@ -391,6 +474,17 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_subscription = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   ack_ids = []
+          #   ack_deadline_seconds = 0
+          #   subscriber_api.modify_ack_deadline(formatted_subscription, ack_ids, ack_deadline_seconds)
+
           def modify_ack_deadline \
               subscription,
               ack_ids,
@@ -421,6 +515,16 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_subscription = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   ack_ids = []
+          #   subscriber_api.acknowledge(formatted_subscription, ack_ids)
+
           def acknowledge \
               subscription,
               ack_ids,
@@ -453,6 +557,16 @@ module Google
           #   retries, etc.
           # @return [Google::Pubsub::V1::PullResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_subscription = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   max_messages = 0
+          #   response = subscriber_api.pull(formatted_subscription, max_messages)
+
           def pull \
               subscription,
               max_messages,
@@ -486,6 +600,17 @@ module Google
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   PushConfig = Google::Pubsub::V1::PushConfig
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_subscription = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   push_config = PushConfig.new
+          #   subscriber_api.modify_push_config(formatted_subscription, push_config)
+
           def modify_push_config \
               subscription,
               push_config,
@@ -496,6 +621,113 @@ module Google
             )
             @modify_push_config.call(req, options)
           end
+
+          # Sets the access control policy on the specified resource. Replaces any
+          # existing policy.
+          #
+          # @param resource [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}+.
+          # @param policy [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.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Iam::V1::Policy]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   Policy = Google::Iam::V1::Policy
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_resource = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   policy = Policy.new
+          #   response = subscriber_api.set_iam_policy(formatted_resource, policy)
+
+          def set_iam_policy \
+              resource,
+              policy,
+              options: nil
+            req = Google::Iam::V1::SetIamPolicyRequest.new(
+              resource: resource,
+              policy: policy
+            )
+            @set_iam_policy.call(req, options)
+          end
+
+          # Gets the access control policy for a resource.
+          # Returns an empty policy if the resource exists and does not have a policy
+          # set.
+          #
+          # @param resource [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}+.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Iam::V1::Policy]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_resource = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   response = subscriber_api.get_iam_policy(formatted_resource)
+
+          def get_iam_policy \
+              resource,
+              options: nil
+            req = Google::Iam::V1::GetIamPolicyRequest.new(
+              resource: resource
+            )
+            @get_iam_policy.call(req, options)
+          end
+
+          # Returns permissions that a caller has on the specified resource.
+          #
+          # @param resource [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}+.
+          # @param permissions [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].
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Iam::V1::TestIamPermissionsResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub/v1/subscriber_api"
+          #
+          #   SubscriberApi = Google::Cloud::Pubsub::V1::SubscriberApi
+          #
+          #   subscriber_api = SubscriberApi.new
+          #   formatted_resource = SubscriberApi.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #   permissions = []
+          #   response = subscriber_api.test_iam_permissions(formatted_resource, permissions)
+
+          def test_iam_permissions \
+              resource,
+              permissions,
+              options: nil
+            req = Google::Iam::V1::TestIamPermissionsRequest.new(
+              resource: resource,
+              permissions: permissions
+            )
+            @test_iam_permissions.call(req, options)
+          end
         end
       end
     end