google-cloud-tasks-v2 0.8.1 → 0.9.0

data/lib/google/cloud/tasks/v2/cloud_tasks/rest/client.rb

@@ -19,6 +19,7 @@
 require "google/cloud/errors"
 require "google/cloud/tasks/v2/cloudtasks_pb"
 require "google/cloud/tasks/v2/cloud_tasks/rest/service_stub"
+require "google/cloud/location/rest"
 
 module Google
   module Cloud
@@ -67,61 +68,61 @@ module Google
                                   end
                   default_config = Client::Configuration.new parent_config
 
-                  default_config.rpcs.list_queues.timeout = 10.0
+                  default_config.rpcs.list_queues.timeout = 20.0
                   default_config.rpcs.list_queues.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.get_queue.timeout = 10.0
+                  default_config.rpcs.get_queue.timeout = 20.0
                   default_config.rpcs.get_queue.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.create_queue.timeout = 10.0
+                  default_config.rpcs.create_queue.timeout = 20.0
 
-                  default_config.rpcs.update_queue.timeout = 10.0
+                  default_config.rpcs.update_queue.timeout = 20.0
 
-                  default_config.rpcs.delete_queue.timeout = 10.0
+                  default_config.rpcs.delete_queue.timeout = 20.0
                   default_config.rpcs.delete_queue.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.purge_queue.timeout = 10.0
+                  default_config.rpcs.purge_queue.timeout = 20.0
 
-                  default_config.rpcs.pause_queue.timeout = 10.0
+                  default_config.rpcs.pause_queue.timeout = 20.0
 
-                  default_config.rpcs.resume_queue.timeout = 10.0
+                  default_config.rpcs.resume_queue.timeout = 20.0
 
-                  default_config.rpcs.get_iam_policy.timeout = 10.0
+                  default_config.rpcs.get_iam_policy.timeout = 20.0
                   default_config.rpcs.get_iam_policy.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.set_iam_policy.timeout = 10.0
+                  default_config.rpcs.set_iam_policy.timeout = 20.0
 
-                  default_config.rpcs.test_iam_permissions.timeout = 10.0
+                  default_config.rpcs.test_iam_permissions.timeout = 20.0
                   default_config.rpcs.test_iam_permissions.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.list_tasks.timeout = 10.0
+                  default_config.rpcs.list_tasks.timeout = 20.0
                   default_config.rpcs.list_tasks.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.get_task.timeout = 10.0
+                  default_config.rpcs.get_task.timeout = 20.0
                   default_config.rpcs.get_task.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.create_task.timeout = 10.0
+                  default_config.rpcs.create_task.timeout = 20.0
 
-                  default_config.rpcs.delete_task.timeout = 10.0
+                  default_config.rpcs.delete_task.timeout = 20.0
                   default_config.rpcs.delete_task.retry_policy = {
                     initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.run_task.timeout = 10.0
+                  default_config.rpcs.run_task.timeout = 20.0
 
                   default_config
                 end
@@ -187,9 +188,23 @@ module Google
                 @quota_project_id = @config.quota_project
                 @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+                @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
+                  config.credentials = credentials
+                  config.quota_project = @quota_project_id
+                  config.endpoint = @config.endpoint
+                  config.bindings_override = @config.bindings_override
+                end
+
                 @cloud_tasks_stub = ::Google::Cloud::Tasks::V2::CloudTasks::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
               end
 
+              ##
+              # Get the associated client for mix-in of the Locations.
+              #
+              # @return [Google::Cloud::Location::Locations::Rest::Client]
+              #
+              attr_reader :location_client
+
               # Service calls
 
               ##
@@ -216,11 +231,10 @@ module Google
               #     Required. The location name.
               #     For example: `projects/PROJECT_ID/locations/LOCATION_ID`
               #   @param filter [::String]
-              #     `filter` can be used to specify a subset of queues. Any {::Google::Cloud::Tasks::V2::Queue Queue}
-              #     field can be used as a filter and several operators as supported.
-              #     For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
-              #     described in
-              #     [Stackdriver's Advanced Logs
+              #     `filter` can be used to specify a subset of queues. Any
+              #     {::Google::Cloud::Tasks::V2::Queue Queue} field can be used as a filter and
+              #     several operators as supported. For example: `<=, <, >=, >, !=, =, :`. The
+              #     filter syntax is the same as described in [Stackdriver's Advanced Logs
               #     Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
               #
               #     Sample filter "state: PAUSED".
@@ -233,17 +247,19 @@ module Google
               #     The maximum page size is 9800. If unspecified, the page size will
               #     be the maximum. Fewer queues than requested might be returned,
               #     even if more queues exist; use the
-              #     {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token} in the
-              #     response to determine if more queues exist.
+              #     {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token}
+              #     in the response to determine if more queues exist.
               #   @param page_token [::String]
               #     A token identifying the page of results to return.
               #
               #     To request the first page results, page_token must be empty. To
               #     request the next page of results, page_token must be the value of
-              #     {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token} returned
-              #     from the previous call to {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#list_queues ListQueues}
-              #     method. It is an error to switch the value of the
-              #     {::Google::Cloud::Tasks::V2::ListQueuesRequest#filter filter} while iterating through pages.
+              #     {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token}
+              #     returned from the previous call to
+              #     {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#list_queues ListQueues} method. It is an
+              #     error to switch the value of the
+              #     {::Google::Cloud::Tasks::V2::ListQueuesRequest#filter filter} while iterating
+              #     through pages.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Tasks::V2::Queue>]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -251,6 +267,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Tasks::V2::Queue>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::ListQueuesRequest.new
+              #
+              #   # Call the list_queues method.
+              #   result = client.list_queues request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Tasks::V2::Queue.
+              #     p item
+              #   end
+              #
               def list_queues request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -315,6 +351,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Queue]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::GetQueueRequest.new
+              #
+              #   # Call the get_queue method.
+              #   result = client.get_queue request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Queue.
+              #   p result
+              #
               def get_queue request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -354,8 +406,8 @@ module Google
               # Creates a queue.
               #
               # Queues created with this method allow tasks to live for a maximum of 31
-              # days. After a task is 31 days old, the task will be deleted regardless of whether
-              # it was dispatched or not.
+              # days. After a task is 31 days old, the task will be deleted regardless of
+              # whether it was dispatched or not.
               #
               # WARNING: Using this method may have unintended side effects if you are
               # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
@@ -385,11 +437,12 @@ module Google
               #
               #     The list of allowed locations can be obtained by calling Cloud
               #     Tasks' implementation of
-              #     [ListLocations][google.cloud.location.Locations.ListLocations].
+              #     `::Google::Cloud::Location::Locations::Rest::Client#list_locations`.
               #   @param queue [::Google::Cloud::Tasks::V2::Queue, ::Hash]
               #     Required. The queue to create.
               #
-              #     [Queue's name][google.cloud.tasks.v2.Queue.name] cannot be the same as an existing queue.
+              #     [Queue's name][google.cloud.tasks.v2.Queue.name] cannot be the same as an
+              #     existing queue.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::Tasks::V2::Queue]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -397,6 +450,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Queue]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::CreateQueueRequest.new
+              #
+              #   # Call the create_queue method.
+              #   result = client.create_queue request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Queue.
+              #   p result
+              #
               def create_queue request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -439,8 +508,8 @@ module Google
               # the queue if it does exist.
               #
               # Queues created with this method allow tasks to live for a maximum of 31
-              # days. After a task is 31 days old, the task will be deleted regardless of whether
-              # it was dispatched or not.
+              # days. After a task is 31 days old, the task will be deleted regardless of
+              # whether it was dispatched or not.
               #
               # WARNING: Using this method may have unintended side effects if you are
               # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
@@ -483,6 +552,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Queue]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::UpdateQueueRequest.new
+              #
+              #   # Call the update_queue method.
+              #   result = client.update_queue request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Queue.
+              #   p result
+              #
               def update_queue request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -558,6 +643,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::DeleteQueueRequest.new
+              #
+              #   # Call the delete_queue method.
+              #   result = client.delete_queue request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_queue request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -626,6 +727,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Queue]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::PurgeQueueRequest.new
+              #
+              #   # Call the purge_queue method.
+              #   result = client.purge_queue request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Queue.
+              #   p result
+              #
               def purge_queue request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -666,9 +783,10 @@ module Google
               #
               # If a queue is paused then the system will stop dispatching tasks
               # until the queue is resumed via
-              # {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#resume_queue ResumeQueue}. Tasks can still be added
-              # when the queue is paused. A queue is paused if its
-              # {::Google::Cloud::Tasks::V2::Queue#state state} is {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
+              # {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#resume_queue ResumeQueue}. Tasks can
+              # still be added when the queue is paused. A queue is paused if its
+              # {::Google::Cloud::Tasks::V2::Queue#state state} is
+              # {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
               #
               # @overload pause_queue(request, options = nil)
               #   Pass arguments to `pause_queue` via a request object, either of type
@@ -695,6 +813,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Queue]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::PauseQueueRequest.new
+              #
+              #   # Call the pause_queue method.
+              #   result = client.pause_queue request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Queue.
+              #   p result
+              #
               def pause_queue request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -735,9 +869,10 @@ module Google
               #
               # This method resumes a queue after it has been
               # {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED} or
-              # {::Google::Cloud::Tasks::V2::Queue::State::DISABLED DISABLED}. The state of a queue is stored
-              # in the queue's {::Google::Cloud::Tasks::V2::Queue#state state}; after calling this method it
-              # will be set to {::Google::Cloud::Tasks::V2::Queue::State::RUNNING RUNNING}.
+              # {::Google::Cloud::Tasks::V2::Queue::State::DISABLED DISABLED}. The state of a
+              # queue is stored in the queue's {::Google::Cloud::Tasks::V2::Queue#state state};
+              # after calling this method it will be set to
+              # {::Google::Cloud::Tasks::V2::Queue::State::RUNNING RUNNING}.
               #
               # WARNING: Resuming many high-QPS queues at the same time can
               # lead to target overloading. If you are resuming high-QPS
@@ -770,6 +905,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Queue]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::ResumeQueueRequest.new
+              #
+              #   # Call the resume_queue method.
+              #   result = client.resume_queue request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Queue.
+              #   p result
+              #
               def resume_queue request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -844,6 +995,22 @@ module Google
               # @return [::Google::Iam::V1::Policy]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::GetIamPolicyRequest.new
+              #
+              #   # Call the get_iam_policy method.
+              #   result = client.get_iam_policy request
+              #
+              #   # The returned object is of type Google::Iam::V1::Policy.
+              #   p result
+              #
               def get_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -880,8 +1047,8 @@ module Google
               end
 
               ##
-              # Sets the access control policy for a {::Google::Cloud::Tasks::V2::Queue Queue}. Replaces any existing
-              # policy.
+              # Sets the access control policy for a {::Google::Cloud::Tasks::V2::Queue Queue}.
+              # Replaces any existing policy.
               #
               # Note: The Cloud Console does not check queue-level IAM permissions yet.
               # Project-level permissions are required to use the Cloud Console.
@@ -928,6 +1095,22 @@ module Google
               # @return [::Google::Iam::V1::Policy]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::SetIamPolicyRequest.new
+              #
+              #   # Call the set_iam_policy method.
+              #   result = client.set_iam_policy request
+              #
+              #   # The returned object is of type Google::Iam::V1::Policy.
+              #   p result
+              #
               def set_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -964,9 +1147,10 @@ module Google
               end
 
               ##
-              # Returns permissions that a caller has on a {::Google::Cloud::Tasks::V2::Queue Queue}.
-              # If the resource does not exist, this will return an empty set of
-              # permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error.
+              # Returns permissions that a caller has on a
+              # {::Google::Cloud::Tasks::V2::Queue Queue}. If the resource does not exist, this
+              # will return an empty set of permissions, not a
+              # [NOT_FOUND][google.rpc.Code.NOT_FOUND] error.
               #
               # Note: This operation is designed to be used for building permission-aware
               # UIs and command-line tools, not for authorization checking. This operation
@@ -1002,6 +1186,22 @@ module Google
               # @return [::Google::Iam::V1::TestIamPermissionsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::TestIamPermissionsRequest.new
+              #
+              #   # Call the test_iam_permissions method.
+              #   result = client.test_iam_permissions request
+              #
+              #   # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
+              #   p result
+              #
               def test_iam_permissions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1040,10 +1240,10 @@ module Google
               ##
               # Lists the tasks in a queue.
               #
-              # By default, only the {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC} view is retrieved
-              # due to performance considerations;
-              # {::Google::Cloud::Tasks::V2::ListTasksRequest#response_view response_view} controls the
-              # subset of information which is returned.
+              # By default, only the {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC} view is
+              # retrieved due to performance considerations;
+              # {::Google::Cloud::Tasks::V2::ListTasksRequest#response_view response_view}
+              # controls the subset of information which is returned.
               #
               # The tasks may be returned in any order. The ordering may change at any
               # time.
@@ -1067,11 +1267,11 @@ module Google
               #     Required. The queue name. For example:
               #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
               #   @param response_view [::Google::Cloud::Tasks::V2::Task::View]
-              #     The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
-              #     returned.
+              #     The response_view specifies which subset of the
+              #     {::Google::Cloud::Tasks::V2::Task Task} will be returned.
               #
-              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
-              #     information is retrieved by default because some data, such as
+              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
+              #     not all information is retrieved by default because some data, such as
               #     payloads, might be desirable to return only when needed because
               #     of its large size or because of the sensitivity of data that it
               #     contains.
@@ -1083,8 +1283,8 @@ module Google
               #     Maximum page size.
               #
               #     Fewer tasks than requested might be returned, even if more tasks exist; use
-              #     {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token} in the response to
-              #     determine if more tasks exist.
+              #     {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token}
+              #     in the response to determine if more tasks exist.
               #
               #     The maximum page size is 1000. If unspecified, the page size will be the
               #     maximum.
@@ -1093,9 +1293,9 @@ module Google
               #
               #     To request the first page results, page_token must be empty. To
               #     request the next page of results, page_token must be the value of
-              #     {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token} returned
-              #     from the previous call to {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#list_tasks ListTasks}
-              #     method.
+              #     {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token}
+              #     returned from the previous call to
+              #     {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#list_tasks ListTasks} method.
               #
               #     The page token is valid for only 2 hours.
               # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1105,6 +1305,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Tasks::V2::Task>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::ListTasksRequest.new
+              #
+              #   # Call the list_tasks method.
+              #   result = client.list_tasks request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Tasks::V2::Task.
+              #     p item
+              #   end
+              #
               def list_tasks request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1163,11 +1383,11 @@ module Google
               #     Required. The task name. For example:
               #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
               #   @param response_view [::Google::Cloud::Tasks::V2::Task::View]
-              #     The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
-              #     returned.
+              #     The response_view specifies which subset of the
+              #     {::Google::Cloud::Tasks::V2::Task Task} will be returned.
               #
-              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
-              #     information is retrieved by default because some data, such as
+              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
+              #     not all information is retrieved by default because some data, such as
               #     payloads, might be desirable to return only when needed because
               #     of its large size or because of the sensitivity of data that it
               #     contains.
@@ -1182,6 +1402,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Task]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::GetTaskRequest.new
+              #
+              #   # Call the get_task method.
+              #   result = client.get_task request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Task.
+              #   p result
+              #
               def get_task request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1249,13 +1485,13 @@ module Google
               #
               #     Task names have the following format:
               #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
-              #     The user can optionally specify a task {::Google::Cloud::Tasks::V2::Task#name name}. If a
-              #     name is not specified then the system will generate a random
-              #     unique task id, which will be set in the task returned in the
-              #     {::Google::Cloud::Tasks::V2::Task#name response}.
+              #     The user can optionally specify a task
+              #     {::Google::Cloud::Tasks::V2::Task#name name}. If a name is not specified then
+              #     the system will generate a random unique task id, which will be set in the
+              #     task returned in the {::Google::Cloud::Tasks::V2::Task#name response}.
               #
-              #     If {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} is not set or is in the
-              #     past then Cloud Tasks will set it to the current time.
+              #     If {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} is not set or
+              #     is in the past then Cloud Tasks will set it to the current time.
               #
               #     Task De-duplication:
               #
@@ -1270,20 +1506,20 @@ module Google
               #     for ~9days after the original task was deleted or executed.
               #
               #     Because there is an extra lookup cost to identify duplicate task
-              #     names, these {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#create_task CreateTask} calls have significantly
-              #     increased latency. Using hashed strings for the task id or for
-              #     the prefix of the task id is recommended. Choosing task ids that
-              #     are sequential or have sequential prefixes, for example using a
+              #     names, these {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#create_task CreateTask}
+              #     calls have significantly increased latency. Using hashed strings for the
+              #     task id or for the prefix of the task id is recommended. Choosing task ids
+              #     that are sequential or have sequential prefixes, for example using a
               #     timestamp, causes an increase in latency and error rates in all
               #     task commands. The infrastructure relies on an approximately
               #     uniform distribution of task ids to store and serve tasks
               #     efficiently.
               #   @param response_view [::Google::Cloud::Tasks::V2::Task::View]
-              #     The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
-              #     returned.
+              #     The response_view specifies which subset of the
+              #     {::Google::Cloud::Tasks::V2::Task Task} will be returned.
               #
-              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
-              #     information is retrieved by default because some data, such as
+              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
+              #     not all information is retrieved by default because some data, such as
               #     payloads, might be desirable to return only when needed because
               #     of its large size or because of the sensitivity of data that it
               #     contains.
@@ -1298,6 +1534,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Task]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::CreateTaskRequest.new
+              #
+              #   # Call the create_task method.
+              #   result = client.create_task request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Task.
+              #   p result
+              #
               def create_task request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1365,6 +1617,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::DeleteTaskRequest.new
+              #
+              #   # Call the delete_task method.
+              #   result = client.delete_task request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_task request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1404,13 +1672,14 @@ module Google
               # Forces a task to run now.
               #
               # When this method is called, Cloud Tasks will dispatch the task, even if
-              # the task is already running, the queue has reached its {::Google::Cloud::Tasks::V2::RateLimits RateLimits} or
-              # is {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
+              # the task is already running, the queue has reached its
+              # {::Google::Cloud::Tasks::V2::RateLimits RateLimits} or is
+              # {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
               #
               # This command is meant to be used for manual debugging. For
-              # example, {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#run_task RunTask} can be used to retry a failed
-              # task after a fix has been made or to manually force a task to be
-              # dispatched now.
+              # example, {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#run_task RunTask} can be used to
+              # retry a failed task after a fix has been made or to manually force a task
+              # to be dispatched now.
               #
               # The dispatched task is returned. That is, the task that is returned
               # contains the [status][Task.status] after the task is dispatched but
@@ -1418,9 +1687,10 @@ module Google
               #
               # If Cloud Tasks receives a successful response from the task's
               # target, then the task will be deleted; otherwise the task's
-              # {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} will be reset to the time that
-              # {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#run_task RunTask} was called plus the retry delay specified
-              # in the queue's {::Google::Cloud::Tasks::V2::RetryConfig RetryConfig}.
+              # {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} will be reset to
+              # the time that {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#run_task RunTask} was
+              # called plus the retry delay specified in the queue's
+              # {::Google::Cloud::Tasks::V2::RetryConfig RetryConfig}.
               #
               # {::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client#run_task RunTask} returns
               # [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a
@@ -1445,11 +1715,11 @@ module Google
               #     Required. The task name. For example:
               #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
               #   @param response_view [::Google::Cloud::Tasks::V2::Task::View]
-              #     The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
-              #     returned.
+              #     The response_view specifies which subset of the
+              #     {::Google::Cloud::Tasks::V2::Task Task} will be returned.
               #
-              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
-              #     information is retrieved by default because some data, such as
+              #     By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
+              #     not all information is retrieved by default because some data, such as
               #     payloads, might be desirable to return only when needed because
               #     of its large size or because of the sensitivity of data that it
               #     contains.
@@ -1464,6 +1734,22 @@ module Google
               # @return [::Google::Cloud::Tasks::V2::Task]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/tasks/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Tasks::V2::RunTaskRequest.new
+              #
+              #   # Call the run_task method.
+              #   result = client.run_task request
+              #
+              #   # The returned object is of type Google::Cloud::Tasks::V2::Task.
+              #   p result
+              #
               def run_task request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1587,6 +1873,13 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
 
+                # @private
+                # Overrides for http bindings for the RPCs of this service
+                # are only used when this service is used as mixin, and only
+                # by the host service.
+                # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
+                config_attr :bindings_override, {}, ::Hash, nil
+
                 # @private
                 def initialize parent_config = nil
                   @parent_config = parent_config unless parent_config.nil?