google-cloud-tasks 1.1.0 → 1.1.1

data/lib/google/cloud/tasks/v2/doc/google/cloud/tasks/v2/task.rb

@@ -47,9 +47,7 @@ module Google
         #     An App Engine task is a task that has {Google::Cloud::Tasks::V2::AppEngineHttpRequest AppEngineHttpRequest} set.
         # @!attribute [rw] schedule_time
         #   @return [Google::Protobuf::Timestamp]
-        #     The time when the task is scheduled to be attempted.
-        #
-        #     For App Engine queues, this is when the task will be attempted or retried.
+        #     The time when the task is scheduled to be attempted or retried.
         #
         #     `schedule_time` will be truncated to the nearest microsecond.
         # @!attribute [rw] create_time

data/lib/google/cloud/tasks/v2/doc/google/iam/v1/policy.rb

@@ -79,7 +79,7 @@ module Google
       #     ensure that their change will be applied to the same version of the policy.
       #
       #     If no `etag` is provided in the call to `setIamPolicy`, then the existing
-      #     policy is overwritten blindly.
+      #     policy is overwritten.
       class Policy; end
 
       # Associates `members` with a `role`.
@@ -99,7 +99,7 @@ module Google
       #       who is authenticated with a Google account or a service account.
       #
       #     * `user:{emailid}`: An email address that represents a specific Google
-      #       account. For example, `alice@gmail.com` .
+      #       account. For example, `alice@example.com` .
       #
       #
       #     * `serviceAccount:{emailid}`: An email address that represents a service

data/lib/google/cloud/tasks/v2/queue_pb.rb

@@ -4,10 +4,10 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/cloud/tasks/v2/target_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.tasks.v2.Queue" do
     optional :name, :string, 1

data/lib/google/cloud/tasks/v2/task_pb.rb

@@ -4,11 +4,11 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/cloud/tasks/v2/target_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.tasks.v2.Task" do
     optional :name, :string, 1

data/lib/google/cloud/tasks/v2beta2.rb

@@ -35,7 +35,7 @@ module Google
       # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
       # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
       # 3. [Enable the Cloud Tasks API.](https://console.cloud.google.com/apis/library/tasks.googleapis.com)
-      # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-tasks/latest/file.AUTHENTICATION.html)
       #
       # ### Installation
       # ```
@@ -54,7 +54,7 @@ module Google
       #
       # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
       # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
       # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
       # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
       #

data/lib/google/cloud/tasks/v2beta2/cloud_tasks_client.rb

@@ -423,15 +423,14 @@ module Google
           # Queues are returned in lexicographical order.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The location name.
+          #   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::V2beta2::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::V2beta2::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 "app_engine_http_target: *".
@@ -493,9 +492,7 @@ module Google
           # Gets a queue.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The resource name of the queue. For example:
+          #   Required. The resource name of the queue. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -526,8 +523,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.
@@ -537,21 +534,16 @@ module Google
           # this method.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The location name in which the queue will be created.
+          #   Required. The location name in which the queue will be created.
           #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
           #
           #   The list of allowed locations can be obtained by calling Cloud
           #   Tasks' implementation of
           #   {Google::Cloud::Location::Locations::ListLocations ListLocations}.
           # @param queue [Google::Cloud::Tasks::V2beta2::Queue | Hash]
-          #   Required.
-          #
-          #   The queue to create.
+          #   Required. The queue to create.
           #
-          #   {Google::Cloud::Tasks::V2beta2::Queue#name Queue's name} cannot be the same as
-          #   an existing queue.
+          #   {Google::Cloud::Tasks::V2beta2::Queue#name Queue's name} cannot be the same as an existing queue.
           #   A hash of the same form as `Google::Cloud::Tasks::V2beta2::Queue`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -591,8 +583,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.
@@ -602,17 +594,13 @@ module Google
           # this method.
           #
           # @param queue [Google::Cloud::Tasks::V2beta2::Queue | Hash]
-          #   Required.
+          #   Required. The queue to create or update.
           #
-          #   The queue to create or update.
-          #
-          #   The queue's {Google::Cloud::Tasks::V2beta2::Queue#name name} must be
-          #   specified.
+          #   The queue's {Google::Cloud::Tasks::V2beta2::Queue#name name} must be specified.
           #
           #   Output only fields cannot be modified using UpdateQueue.
           #   Any value specified for an output only field will be ignored.
-          #   The queue's {Google::Cloud::Tasks::V2beta2::Queue#name name} cannot be
-          #   changed.
+          #   The queue's {Google::Cloud::Tasks::V2beta2::Queue#name name} cannot be changed.
           #   A hash of the same form as `Google::Cloud::Tasks::V2beta2::Queue`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
@@ -666,9 +654,7 @@ module Google
           # this method.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -704,9 +690,7 @@ module Google
           # might be dispatched before the purge takes effect. A purge is irreversible.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -738,15 +722,12 @@ module Google
           #
           # If a queue is paused then the system will stop dispatching tasks
           # until the queue is resumed via
-          # {Google::Cloud::Tasks::V2beta2::CloudTasks::ResumeQueue ResumeQueue}. Tasks can
-          # still be added when the queue is paused. A queue is paused if its
-          # {Google::Cloud::Tasks::V2beta2::Queue#state state} is
-          # {Google::Cloud::Tasks::V2beta2::Queue::State::PAUSED PAUSED}.
+          # {Google::Cloud::Tasks::V2beta2::CloudTasks::ResumeQueue ResumeQueue}. Tasks can still be added
+          # when the queue is paused. A queue is paused if its
+          # {Google::Cloud::Tasks::V2beta2::Queue#state state} is {Google::Cloud::Tasks::V2beta2::Queue::State::PAUSED PAUSED}.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -778,11 +759,9 @@ module Google
           #
           # This method resumes a queue after it has been
           # {Google::Cloud::Tasks::V2beta2::Queue::State::PAUSED PAUSED} or
-          # {Google::Cloud::Tasks::V2beta2::Queue::State::DISABLED DISABLED}. The state of a
-          # queue is stored in the queue's
-          # {Google::Cloud::Tasks::V2beta2::Queue#state state}; after calling this method
-          # it will be set to
-          # {Google::Cloud::Tasks::V2beta2::Queue::State::RUNNING RUNNING}.
+          # {Google::Cloud::Tasks::V2beta2::Queue::State::DISABLED DISABLED}. The state of a queue is stored
+          # in the queue's {Google::Cloud::Tasks::V2beta2::Queue#state state}; after calling this method it
+          # will be set to {Google::Cloud::Tasks::V2beta2::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
@@ -791,9 +770,7 @@ module Google
           # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -821,9 +798,9 @@ module Google
             @resume_queue.call(req, options, &block)
           end
 
-          # Gets the access control policy for a
-          # {Google::Cloud::Tasks::V2beta2::Queue Queue}. Returns an empty policy if the
-          # resource exists and does not have a policy set.
+          # Gets the access control policy for a {Google::Cloud::Tasks::V2beta2::Queue Queue}.
+          # Returns an empty policy if the resource exists and does not have a policy
+          # set.
           #
           # Authorization requires the following
           # [Google IAM](https://cloud.google.com/iam) permission on the specified
@@ -867,8 +844,8 @@ module Google
             @get_iam_policy.call(req, options, &block)
           end
 
-          # Sets the access control policy for a
-          # {Google::Cloud::Tasks::V2beta2::Queue Queue}. Replaces any existing policy.
+          # Sets the access control policy for a {Google::Cloud::Tasks::V2beta2::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.
@@ -920,10 +897,9 @@ module Google
             @set_iam_policy.call(req, options, &block)
           end
 
-          # Returns permissions that a caller has on a
-          # {Google::Cloud::Tasks::V2beta2::Queue Queue}. If the resource does not exist,
-          # this will return an empty set of permissions, not a
-          # {Google::Rpc::Code::NOT_FOUND NOT_FOUND} error.
+          # Returns permissions that a caller has on a {Google::Cloud::Tasks::V2beta2::Queue Queue}.
+          # If the resource does not exist, this will return an empty set of
+          # permissions, not a {Google::Rpc::Code::NOT_FOUND 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
@@ -970,33 +946,30 @@ module Google
 
           # Lists the tasks in a queue.
           #
-          # By default, only the {Google::Cloud::Tasks::V2beta2::Task::View::BASIC BASIC}
-          # view is retrieved due to performance considerations;
-          # {Google::Cloud::Tasks::V2beta2::ListTasksRequest#response_view response_view}
-          # controls the subset of information which is returned.
+          # By default, only the {Google::Cloud::Tasks::V2beta2::Task::View::BASIC BASIC} view is retrieved
+          # due to performance considerations;
+          # {Google::Cloud::Tasks::V2beta2::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.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           # @param response_view [Google::Cloud::Tasks::V2beta2::Task::View]
-          #   The response_view specifies which subset of the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} will be returned.
-          #
-          #   By default response_view is
-          #   {Google::Cloud::Tasks::V2beta2::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.
-          #
-          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
-          #   requires `cloudtasks.tasks.fullView` [Google
-          #   IAM](https://cloud.google.com/iam/) permission on the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} resource.
+          #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} will be
+          #   returned.
+          #
+          #   By default response_view is {Google::Cloud::Tasks::V2beta2::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.
+          #
+          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
+          #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+          #   permission on the {Google::Cloud::Tasks::V2beta2::Task Task} resource.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -1052,24 +1025,21 @@ module Google
           # Gets a task.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param response_view [Google::Cloud::Tasks::V2beta2::Task::View]
-          #   The response_view specifies which subset of the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} will be returned.
-          #
-          #   By default response_view is
-          #   {Google::Cloud::Tasks::V2beta2::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.
-          #
-          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
-          #   requires `cloudtasks.tasks.fullView` [Google
-          #   IAM](https://cloud.google.com/iam/) permission on the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} resource.
+          #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} will be
+          #   returned.
+          #
+          #   By default response_view is {Google::Cloud::Tasks::V2beta2::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.
+          #
+          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
+          #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+          #   permission on the {Google::Cloud::Tasks::V2beta2::Task Task} resource.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -1102,33 +1072,27 @@ module Google
           #
           # Tasks cannot be updated after creation; there is no UpdateTask command.
           #
-          # * For {Google::Cloud::Tasks::V2beta2::AppEngineHttpTarget App Engine queues},
-          #   the maximum task size is
+          # * For {Google::Cloud::Tasks::V2beta2::AppEngineHttpTarget App Engine queues}, the maximum task size is
           #   100KB.
-          # * For {Google::Cloud::Tasks::V2beta2::PullTarget pull queues}, the maximum
-          #   task size is 1MB.
+          # * For {Google::Cloud::Tasks::V2beta2::PullTarget pull queues}, the maximum task size is 1MB.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           #
           #   The queue must already exist.
           # @param task [Google::Cloud::Tasks::V2beta2::Task | Hash]
-          #   Required.
-          #
-          #   The task to add.
+          #   Required. The task to add.
           #
           #   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::V2beta2::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::V2beta2::Task#name response}.
+          #   The user can optionally specify a task {Google::Cloud::Tasks::V2beta2::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::V2beta2::Task#name response}.
           #
-          #   If {Google::Cloud::Tasks::V2beta2::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::V2beta2::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:
           #
@@ -1143,10 +1107,10 @@ module Google
           #   for ~9days after the original task was deleted or completed.
           #
           #   Because there is an extra lookup cost to identify duplicate task
-          #   names, these {Google::Cloud::Tasks::V2beta2::CloudTasks::CreateTask 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::V2beta2::CloudTasks::CreateTask 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
@@ -1154,19 +1118,18 @@ module Google
           #   A hash of the same form as `Google::Cloud::Tasks::V2beta2::Task`
           #   can also be provided.
           # @param response_view [Google::Cloud::Tasks::V2beta2::Task::View]
-          #   The response_view specifies which subset of the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} will be returned.
-          #
-          #   By default response_view is
-          #   {Google::Cloud::Tasks::V2beta2::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.
-          #
-          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
-          #   requires `cloudtasks.tasks.fullView` [Google
-          #   IAM](https://cloud.google.com/iam/) permission on the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} resource.
+          #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} will be
+          #   returned.
+          #
+          #   By default response_view is {Google::Cloud::Tasks::V2beta2::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.
+          #
+          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
+          #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+          #   permission on the {Google::Cloud::Tasks::V2beta2::Task Task} resource.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -1207,9 +1170,7 @@ module Google
           # failed.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -1242,19 +1203,18 @@ module Google
           #
           # This method is invoked by the worker to obtain a lease. The
           # worker must acknowledge the task via
-          # {Google::Cloud::Tasks::V2beta2::CloudTasks::AcknowledgeTask AcknowledgeTask}
-          # after they have performed the work associated with the task.
-          #
-          # The {Google::Cloud::Tasks::V2beta2::PullMessage#payload payload} is intended
-          # to store data that the worker needs to perform the work associated with the
-          # task. To return the payloads in the
-          # {Google::Cloud::Tasks::V2beta2::LeaseTasksResponse response}, set
-          # {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#response_view response_view}
-          # to {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}.
-          #
-          # A maximum of 10 qps of
-          # {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} requests are
-          # allowed per queue. {Google::Rpc::Code::RESOURCE_EXHAUSTED RESOURCE_EXHAUSTED}
+          # {Google::Cloud::Tasks::V2beta2::CloudTasks::AcknowledgeTask AcknowledgeTask} after they have
+          # performed the work associated with the task.
+          #
+          # The {Google::Cloud::Tasks::V2beta2::PullMessage#payload payload} is intended to store data that
+          # the worker needs to perform the work associated with the task. To
+          # return the payloads in the {Google::Cloud::Tasks::V2beta2::LeaseTasksResponse response}, set
+          # {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#response_view response_view} to
+          # {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}.
+          #
+          # A maximum of 10 qps of {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks}
+          # requests are allowed per
+          # queue. {Google::Rpc::Code::RESOURCE_EXHAUSTED RESOURCE_EXHAUSTED}
           # is returned when this limit is
           # exceeded. {Google::Rpc::Code::RESOURCE_EXHAUSTED RESOURCE_EXHAUSTED}
           # is also returned when
@@ -1262,18 +1222,25 @@ module Google
           # is exceeded.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           # @param lease_duration [Google::Protobuf::Duration | Hash]
+          #   Required. The duration of the lease.
+          #
+          #   Each task returned in the {Google::Cloud::Tasks::V2beta2::LeaseTasksResponse response} will
+          #   have its {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} set to the current
+          #   time plus the `lease_duration`. The task is leased until its
+          #   {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time}; thus, the task will not be
+          #   returned to another {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} call
+          #   before its {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time}.
+          #
+          #
           #   After the worker has successfully finished the work associated
           #   with the task, the worker must call via
-          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::AcknowledgeTask AcknowledgeTask}
-          #   before the {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time}.
-          #   Otherwise the task will be returned to a later
-          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} call so that
-          #   another worker can retry it.
+          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::AcknowledgeTask AcknowledgeTask} before the
+          #   {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time}. Otherwise the task will be
+          #   returned to a later {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} call so
+          #   that another worker can retry it.
           #
           #   The maximum lease duration is 1 week.
           #   `lease_duration` will be truncated to the nearest second.
@@ -1286,32 +1253,34 @@ module Google
           #   `max_tasks` as possible.
           #
           #   The largest that `max_tasks` can be is 1000.
+          #
+          #   The maximum total size of a {Google::Cloud::Tasks::V2beta2::LeaseTasksResponse lease tasks response} is
+          #   32 MB. If the sum of all task sizes requested reaches this limit,
+          #   fewer tasks than requested are returned.
           # @param response_view [Google::Cloud::Tasks::V2beta2::Task::View]
-          #   The response_view specifies which subset of the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} will be returned.
-          #
-          #   By default response_view is
-          #   {Google::Cloud::Tasks::V2beta2::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.
-          #
-          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
-          #   requires `cloudtasks.tasks.fullView` [Google
-          #   IAM](https://cloud.google.com/iam/) permission on the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} resource.
+          #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} will be
+          #   returned.
+          #
+          #   By default response_view is {Google::Cloud::Tasks::V2beta2::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.
+          #
+          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
+          #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+          #   permission on the {Google::Cloud::Tasks::V2beta2::Task Task} resource.
           # @param filter [String]
           #   `filter` can be used to specify a subset of tasks to lease.
           #
           #   When `filter` is set to `tag=<my-tag>` then the
-          #   {Google::Cloud::Tasks::V2beta2::LeaseTasksResponse response} will contain only
-          #   tasks whose {Google::Cloud::Tasks::V2beta2::PullMessage#tag tag} is equal to
-          #   `<my-tag>`. `<my-tag>` must be less than 500 characters.
+          #   {Google::Cloud::Tasks::V2beta2::LeaseTasksResponse response} will contain only tasks whose
+          #   {Google::Cloud::Tasks::V2beta2::PullMessage#tag tag} is equal to `<my-tag>`. `<my-tag>` must be
+          #   less than 500 characters.
           #
           #   When `filter` is set to `tag_function=oldest_tag()`, only tasks which have
           #   the same tag as the task with the oldest
-          #   {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} will be
-          #   returned.
+          #   {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} will be returned.
           #
           #   Grammar Syntax:
           #
@@ -1329,9 +1298,8 @@ module Google
           #   [bytes](https://cloud.google.com/appengine/docs/standard/java/javadoc/com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-),
           #   only UTF-8 encoded tags can be used in Cloud Tasks. Tag which
           #   aren't UTF-8 encoded can't be used in the
-          #   {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#filter filter} and the
-          #   task's {Google::Cloud::Tasks::V2beta2::PullMessage#tag tag} will be displayed
-          #   as empty in Cloud Tasks.
+          #   {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#filter filter} and the task's
+          #   {Google::Cloud::Tasks::V2beta2::PullMessage#tag tag} will be displayed as empty in Cloud Tasks.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -1372,31 +1340,26 @@ module Google
           # Acknowledges a pull task.
           #
           # The worker, that is, the entity that
-          # {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks leased} this task must
-          # call this method to indicate that the work associated with the task has
-          # finished.
+          # {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks leased} this task must call this method
+          # to indicate that the work associated with the task has finished.
           #
           # The worker must acknowledge a task within the
-          # {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#lease_duration lease_duration}
-          # or the lease will expire and the task will become available to be leased
+          # {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#lease_duration lease_duration} or the lease
+          # will expire and the task will become available to be leased
           # again. After the task is acknowledged, it will not be returned
           # by a later {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks},
           # {Google::Cloud::Tasks::V2beta2::CloudTasks::GetTask GetTask}, or
           # {Google::Cloud::Tasks::V2beta2::CloudTasks::ListTasks ListTasks}.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param schedule_time [Google::Protobuf::Timestamp | Hash]
-          #   Required.
-          #
-          #   The task's current schedule time, available in the
+          #   Required. The task's current schedule time, available in the
           #   {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} returned by
           #   {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} response or
-          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::RenewLease RenewLease} response.
-          #   This restriction is to ensure that your worker currently holds the lease.
+          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::RenewLease RenewLease} response. This restriction is
+          #   to ensure that your worker currently holds the lease.
           #   A hash of the same form as `Google::Protobuf::Timestamp`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -1434,28 +1397,21 @@ module Google
           #
           # The worker can use this method to extend the lease by a new
           # duration, starting from now. The new task lease will be
-          # returned in the task's
-          # {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time}.
+          # returned in the task's {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time}.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param schedule_time [Google::Protobuf::Timestamp | Hash]
-          #   Required.
-          #
-          #   The task's current schedule time, available in the
+          #   Required. The task's current schedule time, available in the
           #   {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} returned by
           #   {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} response or
-          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::RenewLease RenewLease} response.
-          #   This restriction is to ensure that your worker currently holds the lease.
+          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::RenewLease RenewLease} response. This restriction is
+          #   to ensure that your worker currently holds the lease.
           #   A hash of the same form as `Google::Protobuf::Timestamp`
           #   can also be provided.
           # @param lease_duration [Google::Protobuf::Duration | Hash]
-          #   Required.
-          #
-          #   The desired new lease duration, starting from now.
+          #   Required. The desired new lease duration, starting from now.
           #
           #
           #   The maximum lease duration is 1 week.
@@ -1463,19 +1419,18 @@ module Google
           #   A hash of the same form as `Google::Protobuf::Duration`
           #   can also be provided.
           # @param response_view [Google::Cloud::Tasks::V2beta2::Task::View]
-          #   The response_view specifies which subset of the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} will be returned.
-          #
-          #   By default response_view is
-          #   {Google::Cloud::Tasks::V2beta2::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.
-          #
-          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
-          #   requires `cloudtasks.tasks.fullView` [Google
-          #   IAM](https://cloud.google.com/iam/) permission on the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} resource.
+          #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} will be
+          #   returned.
+          #
+          #   By default response_view is {Google::Cloud::Tasks::V2beta2::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.
+          #
+          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
+          #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+          #   permission on the {Google::Cloud::Tasks::V2beta2::Task Task} resource.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -1517,39 +1472,34 @@ module Google
           # Cancel a pull task's lease.
           #
           # The worker can use this method to cancel a task's lease by
-          # setting its {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time}
-          # to now. This will make the task available to be leased to the next caller
-          # of {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks}.
+          # setting its {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} to now. This will
+          # make the task available to be leased to the next caller of
+          # {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks}.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param schedule_time [Google::Protobuf::Timestamp | Hash]
-          #   Required.
-          #
-          #   The task's current schedule time, available in the
+          #   Required. The task's current schedule time, available in the
           #   {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} returned by
           #   {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} response or
-          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::RenewLease RenewLease} response.
-          #   This restriction is to ensure that your worker currently holds the lease.
+          #   {Google::Cloud::Tasks::V2beta2::CloudTasks::RenewLease RenewLease} response. This restriction is
+          #   to ensure that your worker currently holds the lease.
           #   A hash of the same form as `Google::Protobuf::Timestamp`
           #   can also be provided.
           # @param response_view [Google::Cloud::Tasks::V2beta2::Task::View]
-          #   The response_view specifies which subset of the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} will be returned.
-          #
-          #   By default response_view is
-          #   {Google::Cloud::Tasks::V2beta2::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.
-          #
-          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
-          #   requires `cloudtasks.tasks.fullView` [Google
-          #   IAM](https://cloud.google.com/iam/) permission on the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} resource.
+          #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} will be
+          #   returned.
+          #
+          #   By default response_view is {Google::Cloud::Tasks::V2beta2::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.
+          #
+          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
+          #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+          #   permission on the {Google::Cloud::Tasks::V2beta2::Task Task} resource.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -1586,53 +1536,47 @@ 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::V2beta2::RateLimits RateLimits} or is
-          # {Google::Cloud::Tasks::V2beta2::Queue::State::PAUSED PAUSED}.
+          # the task is already running, the queue has reached its {Google::Cloud::Tasks::V2beta2::RateLimits RateLimits} or
+          # is {Google::Cloud::Tasks::V2beta2::Queue::State::PAUSED PAUSED}.
           #
           # This command is meant to be used for manual debugging. For
-          # example, {Google::Cloud::Tasks::V2beta2::CloudTasks::RunTask 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::V2beta2::CloudTasks::RunTask 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 {Google::Cloud::Tasks::V2beta2::Task#status status} after the
-          # task is dispatched but before the task is received by its target.
+          # contains the {Google::Cloud::Tasks::V2beta2::Task#status status} after the task is dispatched but
+          # before the task is received by its target.
           #
           # 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::V2beta2::Task#schedule_time schedule_time} will be
-          # reset to the time that
-          # {Google::Cloud::Tasks::V2beta2::CloudTasks::RunTask RunTask} was called plus
-          # the retry delay specified in the queue's
-          # {Google::Cloud::Tasks::V2beta2::RetryConfig RetryConfig}.
+          # {Google::Cloud::Tasks::V2beta2::Task#schedule_time schedule_time} will be reset to the time that
+          # {Google::Cloud::Tasks::V2beta2::CloudTasks::RunTask RunTask} was called plus the retry delay specified
+          # in the queue's {Google::Cloud::Tasks::V2beta2::RetryConfig RetryConfig}.
           #
           # {Google::Cloud::Tasks::V2beta2::CloudTasks::RunTask RunTask} returns
           # {Google::Rpc::Code::NOT_FOUND NOT_FOUND} when it is called on a
           # task that has already succeeded or permanently failed.
           #
-          # {Google::Cloud::Tasks::V2beta2::CloudTasks::RunTask RunTask} cannot be called
-          # on a {Google::Cloud::Tasks::V2beta2::PullMessage pull task}.
+          # {Google::Cloud::Tasks::V2beta2::CloudTasks::RunTask RunTask} cannot be called on a
+          # {Google::Cloud::Tasks::V2beta2::PullMessage pull task}.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param response_view [Google::Cloud::Tasks::V2beta2::Task::View]
-          #   The response_view specifies which subset of the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} will be returned.
-          #
-          #   By default response_view is
-          #   {Google::Cloud::Tasks::V2beta2::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.
-          #
-          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
-          #   requires `cloudtasks.tasks.fullView` [Google
-          #   IAM](https://cloud.google.com/iam/) permission on the
-          #   {Google::Cloud::Tasks::V2beta2::Task Task} resource.
+          #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} will be
+          #   returned.
+          #
+          #   By default response_view is {Google::Cloud::Tasks::V2beta2::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.
+          #
+          #   Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
+          #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+          #   permission on the {Google::Cloud::Tasks::V2beta2::Task Task} resource.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.