google-cloud-tasks-v2beta3 0.19.0 → 0.20.0

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

@@ -319,11 +319,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 ~1 hour 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 ~9 days 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::V2beta3::CloudTasks::Client#create_task CreateTask}
@@ -354,6 +353,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::V2beta3::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::V2beta3::CloudTasks::Client#delete_task DeleteTask}.
         # @!attribute [rw] name
@@ -365,6 +390,90 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for deleting a batch of tasks using
+        # {::Google::Cloud::Tasks::V2beta3::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::V2beta3::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::V2beta3::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::V2beta3::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::V2beta3::CloudTasks::Client#run_task RunTask}.
         # @!attribute [rw] name
@@ -390,6 +499,94 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Response message for [BatchCreateTasks].
+        # @!attribute [rw] tasks
+        #   @return [::Array<::Google::Cloud::Tasks::V2beta3::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::V2beta3::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::V2beta3::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
+
+        # Request message for
+        # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#update_cmek_config UpdateCmekConfig}.
+        # @!attribute [rw] cmek_config
+        #   @return [::Google::Cloud::Tasks::V2beta3::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::V2beta3::CloudTasks::Client#get_cmek_config GetCmekConfig}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The config resource name. For example:
+        #     projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
+        class GetCmekConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/tasks/v2beta3/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 V2beta3
+        # 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/v2beta3/queue.rb

@@ -71,8 +71,8 @@ module Google
         #       queue, regardless of whether the dispatch is from a first
         #       attempt or a retry).
         #     * {::Google::Cloud::Tasks::V2beta3::Queue#retry_config retry_config} controls
-        #     what happens to
-        #       particular a task after its first attempt fails. That is,
+        #     what happens to a
+        #       particular task after its first attempt fails. That is,
         #       {::Google::Cloud::Tasks::V2beta3::Queue#retry_config retry_config} controls
         #       task retries (the second attempt, third attempt, etc).
         #
@@ -126,17 +126,23 @@ module Google
         # @!attribute [rw] task_ttl
         #   @return [::Google::Protobuf::Duration]
         #     The maximum amount of time that a task will be retained in
-        #     this queue.
+        #     this queue. After a task has lived for `task_ttl`, the task will be deleted
+        #     regardless of whether it was dispatched or not.
+        #
+        #     The minimum value is 10 days. The maximum value is 10 years. 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).
         #
         #     Queues created by Cloud Tasks have a default `task_ttl` of 31 days.
-        #     After a task has lived for `task_ttl`, the task will be deleted
-        #     regardless of whether it was dispatched or not.
+        #     .
         #
-        #     The `task_ttl` for queues created via queue.yaml/xml is equal to the
-        #     maximum duration because there is a
-        #     [storage quota](https://cloud.google.com/appengine/quotas#Task_Queue) for
-        #     these queues. To view the maximum valid duration, see the documentation for
-        #     {::Google::Protobuf::Duration Duration}.
+        #     Queues created by queue.yaml/xml have a fixed `task_ttl` of the maximum
+        #     duration, because there is a
+        #     [storage
+        #     quota](https://docs.cloud.google.com/appengine/docs/standard/quotas#Task_Queue)
+        #     for these queues.
         # @!attribute [rw] tombstone_ttl
         #   @return [::Google::Protobuf::Duration]
         #     The task tombstone time to live (TTL).
@@ -148,6 +154,12 @@ module Google
         #     about task de-duplication, see the documentation for
         #     {::Google::Cloud::Tasks::V2beta3::CreateTaskRequest#task CreateTaskRequest}.
         #
+        #     The minimum value is 1 hour. The maximum value is 9 days. 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).
+        #
         #     Queues created by Cloud Tasks have a default `tombstone_ttl` of 1 hour.
         # @!attribute [rw] stackdriver_logging_config
         #   @return [::Google::Cloud::Tasks::V2beta3::StackdriverLoggingConfig]
@@ -236,9 +248,8 @@ module Google
         #     If unspecified when the queue is created, Cloud Tasks will pick the
         #     default.
         #
-        #     * For {::Google::Cloud::Tasks::V2beta3::AppEngineHttpQueue App Engine queues},
-        #     the maximum allowed value
-        #       is 500.
+        #     For {::Google::Cloud::Tasks::V2beta3::AppEngineHttpQueue App Engine queues}, the
+        #     maximum allowed value is 500.
         #
         #
         #     This field has the same meaning as
@@ -306,17 +317,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).
@@ -327,16 +346,22 @@ module Google
         #     attempted. Once `max_retry_duration` time has passed *and* the
         #     task has been attempted
         #     {::Google::Cloud::Tasks::V2beta3::RetryConfig#max_attempts max_attempts} times,
-        #     no further attempts will be made and the task will be deleted.
+        #     no 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).
@@ -350,12 +375,16 @@ module Google
         #     {::Google::Cloud::Tasks::V2beta3::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).
@@ -369,12 +398,16 @@ module Google
         #     {::Google::Cloud::Tasks::V2beta3::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).

data/proto_docs/google/cloud/tasks/v2beta3/target.rb

@@ -27,9 +27,9 @@ module Google
         # {::Google::Cloud::Tasks::V2beta3::Queue#type PULL} type. It currently exists for
         # backwards compatibility with the App Engine Task Queue SDK. This message type
         # maybe returned with methods
-        # [list][google.cloud.tasks.v2beta3.CloudTask.ListTasks] and
-        # [get][google.cloud.tasks.v2beta3.CloudTask.ListTasks], when the response view
-        # is [FULL][google.cloud.tasks.v2beta3.Task.View.Full].
+        # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#list_tasks list} and
+        # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#list_tasks get}, when the response
+        # view is {::Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL}.
         # @!attribute [rw] payload
         #   @return [::String]
         #     A data payload consumed by the worker to execute the task.
@@ -95,9 +95,10 @@ module Google
         #     Port override.
         #
         #     When specified, replaces the port part of the task URI. For instance,
-        #     for a URI http://www.google.com/foo and port=123, the overridden URI
-        #     becomes http://www.google.com:123/foo. Note that the port value must be a
-        #     positive integer. Setting the port to 0 (Zero) clears the URI port.
+        #     for a URI "https://www.example.com/example" and port=123, the overridden
+        #     URI becomes "https://www.example.com:123/example". Note that the port value
+        #     must be a positive integer. Setting the port to 0 (Zero) clears the URI
+        #     port.
         # @!attribute [rw] path_override
         #   @return [::Google::Cloud::Tasks::V2beta3::PathOverride]
         #     URI path.
@@ -125,12 +126,12 @@ module Google
             # Scheme unspecified. Defaults to HTTPS.
             SCHEME_UNSPECIFIED = 0
 
-            # Convert the scheme to HTTP, e.g., https://www.google.ca will change to
-            # http://www.google.ca.
+            # Convert the scheme to HTTP, e.g., "https://www.example.com" will change
+            # to "http://www.example.com".
             HTTP = 1
 
-            # Convert the scheme to HTTPS, e.g., http://www.google.ca will change to
-            # https://www.google.ca.
+            # Convert the scheme to HTTPS, e.g., "http://www.example.com" will change
+            # to "https://www.example.com".
             HTTPS = 2
           end
 
@@ -152,8 +153,8 @@ module Google
 
         # HTTP target.
         #
-        # When specified as a [Queue][target_type], all the tasks with [HttpRequest]
-        # will be overridden according to the target.
+        # When specified as a {::Google::Cloud::Tasks::V2beta3::Queue Queue}, all the tasks
+        # with [HttpRequest] will be overridden according to the target.
         # @!attribute [rw] uri_override
         #   @return [::Google::Cloud::Tasks::V2beta3::UriOverride]
         #     URI override.
@@ -164,9 +165,11 @@ module Google
         #     The HTTP method to use for the request.
         #
         #     When specified, it overrides
-        #     {::Google::Cloud::Tasks::V2beta3::HttpTarget#http_method HttpRequest} for the
-        #     task. Note that if the value is set to [HttpMethod][GET] the
-        #     [HttpRequest][body] of the task will be ignored at execution time.
+        #     {::Google::Cloud::Tasks::V2beta3::HttpRequest#http_method HttpRequest.http_method}
+        #     for the task. Note that if the value is set to
+        #     {::Google::Cloud::Tasks::V2beta3::HttpMethod::GET HttpMethod.GET} the
+        #     {::Google::Cloud::Tasks::V2beta3::HttpRequest#body HttpRequest.body} of the task
+        #     will be ignored at execution time.
         # @!attribute [rw] header_overrides
         #   @return [::Array<::Google::Cloud::Tasks::V2beta3::HttpTarget::HeaderOverride>]
         #     HTTP target headers.
@@ -200,27 +203,35 @@ module Google
         #
         #     The size of the headers must be less than 80KB.
         #     Queue-level headers to override headers of all the tasks in the queue.
+        #
+        #     Do not put business sensitive or personally identifying data in the HTTP
+        #     Header Override Configuration or other similar fields in accordance with
+        #     Section 12 (Resource Fields) of the
+        #     [Service Specific Terms](https://cloud.google.com/terms/service-terms).
         # @!attribute [rw] oauth_token
         #   @return [::Google::Cloud::Tasks::V2beta3::OAuthToken]
         #     If specified, an
         #     [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
-        #     will be generated and attached as the `Authorization` header in the HTTP
+        #     is generated and attached as the `Authorization` header in the HTTP
         #     request.
         #
-        #     This type of authorization should generally only be used when calling
-        #     Google APIs hosted on *.googleapis.com.
+        #     This type of authorization should generally be used only when calling
+        #     Google APIs hosted on *.googleapis.com. Note that both the service
+        #     account email and the scope MUST be specified when using the queue-level
+        #     authorization override.
         #
         #     Note: The following fields are mutually exclusive: `oauth_token`, `oidc_token`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] oidc_token
         #   @return [::Google::Cloud::Tasks::V2beta3::OidcToken]
         #     If specified, an
         #     [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
-        #     token will be generated and attached as an `Authorization` header in the
+        #     token is generated and attached as an `Authorization` header in the
         #     HTTP request.
         #
         #     This type of authorization can be used for many scenarios, including
         #     calling Cloud Run, or endpoints where you intend to validate the token
-        #     yourself.
+        #     yourself. Note that both the service account email and the audience MUST
+        #     be specified when using the queue-level authorization override.
         #
         #     Note: The following fields are mutually exclusive: `oidc_token`, `oauth_token`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class HttpTarget
@@ -242,7 +253,12 @@ module Google
           # Wraps the Header object.
           # @!attribute [rw] header
           #   @return [::Google::Cloud::Tasks::V2beta3::HttpTarget::Header]
-          #     header embodying a key and a value.
+          #     Header embodying a key and a value.
+          #
+          #     Do not put business sensitive or personally identifying data in the HTTP
+          #     Header Override Configuration or other similar fields in accordance with
+          #     Section 12 (Resource Fields) of the
+          #     [Service Specific Terms](https://cloud.google.com/terms/service-terms).
           class HeaderOverride
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -309,7 +325,7 @@ module Google
         #
         #     * Any header that is prefixed with "X-CloudTasks-" will be treated
         #     as service header. Service headers define properties of the task and are
-        #     predefined in CloudTask.
+        #     predefined in Cloud Tasks.
         #     * Host: This will be computed by Cloud Tasks and derived from
         #       {::Google::Cloud::Tasks::V2beta3::HttpRequest#url HttpRequest.url}.
         #     * Content-Length: This will be computed by Cloud Tasks.

data/proto_docs/google/cloud/tasks/v2beta3/task.rb

@@ -119,6 +119,10 @@ module Google
         #       information see
         #       [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
         #
+        #     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).
         #     `dispatch_deadline` will be truncated to the nearest millisecond. The
         #     deadline is an approximate deadline.
         # @!attribute [rw] dispatch_count
@@ -144,6 +148,11 @@ module Google
         #   @return [::Google::Cloud::Tasks::V2beta3::Task::View]
         #     Output only. The view specifies which subset of the
         #     {::Google::Cloud::Tasks::V2beta3::Task Task} has been returned.
+        # @!attribute [rw] retry_config
+        #   @return [::Google::Cloud::Tasks::V2beta3::RetryConfig]
+        #     Optional. Specifies the task-level retry config.
+        #
+        #     If present, this overrides the queue-level retry config for this task.
         class Task
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods