google-cloud-tasks-v2 1.6.0 → 1.7.0

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/api/client.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2022 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/api/field_behavior.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/api/field_info.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # Rich semantic information of an API field beyond basic typing.
+    # @!attribute [rw] format
+    #   @return [::Google::Api::FieldInfo::Format]
+    #     The standard format of a field value. This does not explicitly configure
+    #     any API consumer, just documents the API's format for the field it is
+    #     applied to.
+    # @!attribute [rw] referenced_types
+    #   @return [::Array<::Google::Api::TypeReference>]
+    #     The type(s) that the annotated, generic field may represent.
+    #
+    #     Currently, this must only be used on fields of type `google.protobuf.Any`.
+    #     Supporting other generic types may be considered in the future.
+    class FieldInfo
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # The standard format of a field value. The supported formats are all backed
+      # by either an RFC defined by the IETF or a Google-defined AIP.
+      module Format
+        # Default, unspecified value.
+        FORMAT_UNSPECIFIED = 0
+
+        # Universally Unique Identifier, version 4, value as defined by
+        # https://datatracker.ietf.org/doc/html/rfc4122. The value may be
+        # normalized to entirely lowercase letters. For example, the value
+        # `F47AC10B-58CC-0372-8567-0E02B2C3D479` would be normalized to
+        # `f47ac10b-58cc-0372-8567-0e02b2c3d479`.
+        UUID4 = 1
+
+        # Internet Protocol v4 value as defined by [RFC
+        # 791](https://datatracker.ietf.org/doc/html/rfc791). The value may be
+        # condensed, with leading zeros in each octet stripped. For example,
+        # `001.022.233.040` would be condensed to `1.22.233.40`.
+        IPV4 = 2
+
+        # Internet Protocol v6 value as defined by [RFC
+        # 2460](https://datatracker.ietf.org/doc/html/rfc2460). The value may be
+        # normalized to entirely lowercase letters with zeros compressed, following
+        # [RFC 5952](https://datatracker.ietf.org/doc/html/rfc5952). For example,
+        # the value `2001:0DB8:0::0` would be normalized to `2001:db8::`.
+        IPV6 = 3
+
+        # An IP address in either v4 or v6 format as described by the individual
+        # values defined herein. See the comments on the IPV4 and IPV6 types for
+        # allowed normalizations of each.
+        IPV4_OR_IPV6 = 4
+      end
+    end
+
+    # A reference to a message type, for use in {::Google::Api::FieldInfo FieldInfo}.
+    # @!attribute [rw] type_name
+    #   @return [::String]
+    #     The name of the type that the annotated, generic field may represent.
+    #     If the type is in the same protobuf package, the value can be the simple
+    #     message name e.g., `"MyMessage"`. Otherwise, the value must be the
+    #     fully-qualified message name e.g., `"google.library.v1.Book"`.
+    #
+    #     If the type(s) are unknown to the service (e.g. the field accepts generic
+    #     user input), use the wildcard `"*"` to denote this behavior.
+    #
+    #     See [AIP-202](https://google.aip.dev/202#type-references) for more details.
+    class TypeReference
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/api/launch_stage.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2022 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/api/resource.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/cloud/tasks/v2/cloudtasks.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -300,11 +300,10 @@ module Google
         #     a task's ID is identical to that of an existing task or a task
         #     that was deleted or executed recently then the call will fail
         #     with [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS].
-        #     If the task's queue was created using Cloud Tasks, then another task with
-        #     the same name can't be created for ~1hour after the original task was
-        #     deleted or executed. If the task's queue was created using queue.yaml or
-        #     queue.xml, then another task with the same name can't be created
-        #     for ~9days after the original task was deleted or executed.
+        #     The IDs of deleted tasks are not immediately available for reuse.  It can
+        #     take up to 24 hours (or 9 days if the task's queue was created using a
+        #     queue.yaml or queue.xml) for the task ID to be released and made available
+        #     again.
         #
         #     Because there is an extra lookup cost to identify duplicate task
         #     names, these {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask}
@@ -334,6 +333,32 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for [BatchCreateTasks].
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The queue name. For example:
+        #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #
+        #     The queue must already exist.
+        # @!attribute [rw] requests
+        #   @return [::Array<::Google::Cloud::Tasks::V2::CreateTaskRequest>]
+        #     Required. The list of requests to create tasks.
+        #     The queue specified in parent field of each CreateTaskRequest will be
+        #     the same. This validation happens on the client side as well as in the
+        #     handler.
+        #     BatchCreateTasksRequest.parent will also be the same value as the
+        #     individual CreateTaskRequest.parent.
+        #     The maximum number of requests is 100.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. This field will be used to identify the long running operation,
+        #     avoiding duplication when user retries. If not provided, then a UUID will
+        #     be generated at server side.
+        class BatchCreateTasksRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for deleting a task using
         # {::Google::Cloud::Tasks::V2::CloudTasks::Client#delete_task DeleteTask}.
         # @!attribute [rw] name
@@ -345,6 +370,90 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for deleting a batch of tasks using
+        # {::Google::Cloud::Tasks::V2::CloudTasks::Client#batch_delete_tasks BatchDeleteTasks}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The queue name. For example:
+        #     Format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The names of the tasks to delete.
+        #     A maximum of 1000 tasks can be deleted in a batch.
+        #     For example:
+        #     Format:
+        #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. This field will be used to identify the long running operation,
+        #     avoiding duplication when user retries. If not provided, then a UUID will
+        #     be generated at server side.
+        class BatchDeleteTasksRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata for the long-running operation returned by
+        # {::Google::Cloud::Tasks::V2::CloudTasks::Client#batch_delete_tasks BatchDeleteTasks}.
+        # This message is used to hold metadata information about the
+        # batch delete tasks operation; that is, it is put in
+        # {::Google::Longrunning::Operation#metadata google.longrunning.Operation.metadata}.
+        # @!attribute [r] start_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the batch delete started.
+        # @!attribute [r] end_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the batch delete finished.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Tasks::V2::BatchDeleteTasksMetadata::State]
+        #     Output only. The state of the batch delete operation.
+        # @!attribute [r] failed_requests
+        #   @return [::Google::Protobuf::Map{::Integer => ::Google::Rpc::Status}]
+        #     Output only. A map of failed requests, where the key is the index of the
+        #     request in BatchDeleteTasksRequest.names and the value is the error status.
+        class BatchDeleteTasksMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::Integer]
+          # @!attribute [rw] value
+          #   @return [::Google::Rpc::Status]
+          class FailedRequestsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The state of the batch delete operation.
+          # This enum is not frozen and new values may be added in the future.
+          module State
+            # The default value. This value is used if the state is omitted.
+            STATE_UNSPECIFIED = 0
+
+            # The batch delete is running.
+            RUNNING = 1
+
+            # The batch delete has finished and all tasks were successfully deleted.
+            SUCCEEDED = 2
+
+            # The batch delete has finished with partial success.
+            # The tasks that failed to be deleted are reported in
+            # {::Google::Cloud::Tasks::V2::BatchDeleteTasksMetadata#failed_requests failed_requests}.
+            # When all requests in the batch fail,
+            # {::Google::Longrunning::Operation#error google.longrunning.Operation.error}
+            # will be set with `code` = `google.rpc.Code.ABORTED` and `message` = "None
+            # of the requests succeeded, refer to
+            # BatchDeleteTasksMetadata.failed_requests for individual error details".
+            PARTIALLY_SUCCEEDED = 3
+
+            # The batch delete has failed.
+            # This means the overall batch delete operation failed to complete.
+            # This can happen due to an internal error preventing the operation from
+            # finishing.
+            FAILED = 4
+          end
+        end
+
         # Request message for forcing a task to run now using
         # {::Google::Cloud::Tasks::V2::CloudTasks::Client#run_task RunTask}.
         # @!attribute [rw] name
@@ -369,6 +478,94 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request message for
+        # {::Google::Cloud::Tasks::V2::CloudTasks::Client#update_cmek_config UpdateCmekConfig}.
+        # @!attribute [rw] cmek_config
+        #   @return [::Google::Cloud::Tasks::V2::CmekConfig]
+        #     Required. The config to update.  Its name attribute distinguishes it.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     List of fields to be updated in this request.
+        class UpdateCmekConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Tasks::V2::CloudTasks::Client#get_cmek_config GetCmekConfig}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The config. For example:
+        #     `projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig`
+        class GetCmekConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for [BatchCreateTasks].
+        # @!attribute [rw] tasks
+        #   @return [::Array<::Google::Cloud::Tasks::V2::Task>]
+        #     The tasks that were successfully created.
+        class BatchCreateTasksResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata message for [BatchCreateTasks].
+        # @!attribute [rw] start_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the batch create started.
+        # @!attribute [rw] end_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the batch create finished.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Tasks::V2::BatchCreateTasksMetadata::State]
+        #     Output only. The state of the batch create operation.
+        # @!attribute [rw] failed_requests
+        #   @return [::Google::Protobuf::Map{::Integer => ::Google::Rpc::Status}]
+        #     A map of failed requests, where the key is the index of the request in
+        #     BatchCreateTasksRequest.requests and the value is the error status.
+        class BatchCreateTasksMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::Integer]
+          # @!attribute [rw] value
+          #   @return [::Google::Rpc::Status]
+          class FailedRequestsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The state of the batch create operation.
+          module State
+            # The default value. This value is used if the state is omitted.
+            STATE_UNSPECIFIED = 0
+
+            # The batch create is running.
+            RUNNING = 1
+
+            # The batch create has finished.
+            # All tasks in the request were successfully created.
+            SUCCEEDED = 2
+
+            # The batch create has finished with partial success.
+            # The tasks that failed to be created are reported in
+            # {::Google::Cloud::Tasks::V2::BatchCreateTasksMetadata#failed_requests failed_requests}.
+            PARTIALLY_SUCCEEDED = 5
+
+            # The batch create has failed.
+            # This means the overall batch create operation failed to complete.
+            # This can happen due to an internal error preventing the operation from
+            # finishing.
+            FAILED = 3
+
+            # The batch create was cancelled.
+            CANCELLED = 4
+          end
+        end
       end
     end
   end

data/proto_docs/google/cloud/tasks/v2/cmek_config.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Tasks
+      module V2
+        # Describes the customer-managed encryption key (CMEK) configuration associated
+        # with a project and location.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. The config resource name which includes the project and
+        #     location and must end in 'cmekConfig', in the format
+        #     `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
+        # @!attribute [rw] kms_key
+        #   @return [::String]
+        #     Resource name of the Cloud KMS key, of the form
+        #     `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`,
+        #     that will be used to encrypt the Queues & Tasks in the region. Setting
+        #     this as blank will turn off CMEK encryption.
+        class CmekConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/tasks/v2/queue.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -59,6 +59,9 @@ module Google
         #     {::Google::Cloud::Tasks::V2::AppEngineHttpRequest App Engine tasks} in the
         #     queue, no matter what the setting is for the [task-level
         #     app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing].
+        # @!attribute [rw] http_target
+        #   @return [::Google::Cloud::Tasks::V2::HttpTarget]
+        #     Modifies HTTP target for HTTP tasks.
         # @!attribute [rw] rate_limits
         #   @return [::Google::Cloud::Tasks::V2::RateLimits]
         #     Rate limits for task dispatches.
@@ -74,8 +77,8 @@ module Google
         #       queue, regardless of whether the dispatch is from a first
         #       attempt or a retry).
         #     * {::Google::Cloud::Tasks::V2::Queue#retry_config retry_config} controls what
-        #     happens to
-        #       particular a task after its first attempt fails. That is,
+        #     happens to a
+        #       particular task after its first attempt fails. That is,
         #       {::Google::Cloud::Tasks::V2::Queue#retry_config retry_config} controls task
         #       retries (the second attempt, third attempt, etc).
         #
@@ -187,7 +190,7 @@ module Google
         #     If unspecified when the queue is created, Cloud Tasks will pick the
         #     default.
         #
-        #     * The maximum allowed value is 500.
+        #     The maximum allowed value is 500.
         #
         #
         #     This field has the same meaning as
@@ -210,11 +213,13 @@ module Google
         #     token is removed from the bucket. Tasks will be dispatched until
         #     the queue's bucket runs out of tokens. The bucket will be
         #     continuously refilled with new tokens based on
-        #     {::Google::Cloud::Tasks::V2::RateLimits#max_dispatches_per_second max_dispatches_per_second}.
+        #     `max_dispatches_per_second`.
         #
-        #     Cloud Tasks will pick the value of `max_burst_size` based on the
-        #     value of
-        #     {::Google::Cloud::Tasks::V2::RateLimits#max_dispatches_per_second max_dispatches_per_second}.
+        #     Cloud Tasks automatically sets an appropriate `max_burst_size` based
+        #     on the value of `max_dispatches_per_second`. The value is dynamically
+        #     optimized to ensure queue stability and throughput. It is generally at
+        #     least equal to `max_dispatches_per_second` but might be higher to
+        #     accommodate bursts of traffic.
         #
         #     For queues that were created or updated using
         #     `queue.yaml/xml`, `max_burst_size` is equal to
@@ -222,11 +227,8 @@ module Google
         #     Since `max_burst_size` is output only, if
         #     {::Google::Cloud::Tasks::V2::CloudTasks::Client#update_queue UpdateQueue} is called on a
         #     queue created by `queue.yaml/xml`, `max_burst_size` will be reset based on
-        #     the value of
-        #     {::Google::Cloud::Tasks::V2::RateLimits#max_dispatches_per_second max_dispatches_per_second},
-        #     regardless of whether
-        #     {::Google::Cloud::Tasks::V2::RateLimits#max_dispatches_per_second max_dispatches_per_second}
-        #     is updated.
+        #     the value of `max_dispatches_per_second`, regardless of whether
+        #     `max_dispatches_per_second` is updated.
         # @!attribute [rw] max_concurrent_dispatches
         #   @return [::Integer]
         #     The maximum number of concurrent tasks that Cloud Tasks allows
@@ -254,17 +256,25 @@ module Google
         # These settings determine when a failed task attempt is retried.
         # @!attribute [rw] max_attempts
         #   @return [::Integer]
-        #     Number of attempts per task.
+        #     Number of attempts per task, including the first attempt. (If the
+        #     first attempt fails, there will be `max_attempts - 1` retries.)
         #
-        #     Cloud Tasks will attempt the task `max_attempts` times (that is, if the
-        #     first attempt fails, then there will be `max_attempts - 1` retries). Must
-        #     be >= -1.
+        #     Must be greater than or equal to -1, which indicates unlimited attempts.
+        #
+        #
+        #     Cloud Tasks stops retrying only when `max_attempts` and
+        #     `max_retry_duration` are both satisfied, or when the task is successfully
+        #     executed. When the task has been attempted
+        #     `max_attempts` times and when the `max_retry_duration` time has passed, no
+        #     further attempts are made, and the task is deleted. If `max_attempts` is
+        #     set to -1 and `max_retry_duration` is set to 0, the task is retried
+        #     until the [maximum task
+        #     retention](https://docs.cloud.google.com/tasks/docs/quotas#limits) limit is
+        #     reached.
         #
         #     If unspecified when the queue is created, Cloud Tasks will pick the
         #     default.
         #
-        #     -1 indicates unlimited attempts.
-        #
         #     This field has the same meaning as
         #     [task_retry_limit in
         #     queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
@@ -275,16 +285,22 @@ module Google
         #     attempted. Once `max_retry_duration` time has passed *and* the
         #     task has been attempted
         #     {::Google::Cloud::Tasks::V2::RetryConfig#max_attempts max_attempts} times, no
-        #     further attempts will be made and the task will be deleted.
+        #     further attempts are made and the task is deleted.
         #
-        #     If zero, then the task age is unlimited.
-        #
-        #     If unspecified when the queue is created, Cloud Tasks will pick the
-        #     default.
+        #     A zero (0) indicates an unlimited duration, up to the
+        #     [maximum task
+        #     retention](https://docs.cloud.google.com/tasks/docs/quotas#limits) limit.
         #
         #
+        #     The value must be given as a string that indicates the length of time
+        #     (in seconds) followed by `s` (for "seconds"). For the maximum possible
+        #     value or the format, see the documentation for
+        #     [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
         #     `max_retry_duration` will be truncated to the nearest second.
         #
+        #     If unspecified when the queue is created, Cloud Tasks will pick the
+        #     default.
+        #
         #     This field has the same meaning as
         #     [task_age_limit in
         #     queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
@@ -297,12 +313,16 @@ module Google
         #     {::Google::Cloud::Tasks::V2::RetryConfig RetryConfig} specifies that the task
         #     should be retried.
         #
-        #     If unspecified when the queue is created, Cloud Tasks will pick the
-        #     default.
-        #
         #
+        #     The value must be given as a string that indicates the length of time
+        #     (in seconds) followed by `s` (for "seconds"). For more information on the
+        #     format, see the documentation for
+        #     [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
         #     `min_backoff` will be truncated to the nearest second.
         #
+        #     If unspecified when the queue is created, Cloud Tasks will pick the
+        #     default.
+        #
         #     This field has the same meaning as
         #     [min_backoff_seconds in
         #     queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
@@ -315,12 +335,16 @@ module Google
         #     {::Google::Cloud::Tasks::V2::RetryConfig RetryConfig} specifies that the task
         #     should be retried.
         #
-        #     If unspecified when the queue is created, Cloud Tasks will pick the
-        #     default.
-        #
         #
+        #     The value must be given as a string that indicates the length of time
+        #     (in seconds) followed by `s` (for "seconds"). For more information on the
+        #     format, see the documentation for
+        #     [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
         #     `max_backoff` will be truncated to the nearest second.
         #
+        #     If unspecified when the queue is created, Cloud Tasks will pick the
+        #     default.
+        #
         #     This field has the same meaning as
         #     [max_backoff_seconds in
         #     queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).