google-cloud-tasks-v2 1.5.0 → 1.7.0

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).

data/proto_docs/google/cloud/tasks/v2/target.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.
@@ -21,6 +21,220 @@ module Google
   module Cloud
     module Tasks
       module V2
+        # PathOverride.
+        #
+        # Path message defines path override for HTTP targets.
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     The URI path (e.g., /users/1234). Default is an empty string.
+        class PathOverride
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # QueryOverride.
+        #
+        # Query message defines query override for HTTP targets.
+        # @!attribute [rw] query_params
+        #   @return [::String]
+        #     The query parameters (e.g., qparam1=123&qparam2=456). Default is an empty
+        #     string.
+        class QueryOverride
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # URI Override.
+        #
+        # When specified, all the HTTP tasks inside the queue will be partially or
+        # fully overridden depending on the configured values.
+        # @!attribute [rw] scheme
+        #   @return [::Google::Cloud::Tasks::V2::UriOverride::Scheme]
+        #     Scheme override.
+        #
+        #     When specified, the task URI scheme is replaced by the provided value (HTTP
+        #     or HTTPS).
+        # @!attribute [rw] host
+        #   @return [::String]
+        #     Host override.
+        #
+        #     When specified, replaces the host part of the task URL. For example,
+        #     if the task URL is "https://www.google.com," and host value is set to
+        #     "example.net", the overridden URI will be changed to "https://example.net."
+        #     Host value cannot be an empty string (INVALID_ARGUMENT).
+        # @!attribute [rw] port
+        #   @return [::Integer]
+        #     Port override.
+        #
+        #     When specified, replaces the port part of the task URI. For instance,
+        #     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::V2::PathOverride]
+        #     URI path.
+        #
+        #     When specified, replaces the existing path of the task URL. Setting the
+        #     path value to an empty string clears the URI path segment.
+        # @!attribute [rw] query_override
+        #   @return [::Google::Cloud::Tasks::V2::QueryOverride]
+        #     URI query.
+        #
+        #     When specified, replaces the query part of the task URI. Setting the
+        #     query value to an empty string clears the URI query segment.
+        # @!attribute [rw] uri_override_enforce_mode
+        #   @return [::Google::Cloud::Tasks::V2::UriOverride::UriOverrideEnforceMode]
+        #     URI Override Enforce Mode
+        #
+        #     When specified, determines the Target UriOverride mode. If not specified,
+        #     it defaults to ALWAYS.
+        class UriOverride
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The Scheme for an HTTP request. By default, it is HTTPS.
+          module Scheme
+            # Scheme unspecified. Defaults to HTTPS.
+            SCHEME_UNSPECIFIED = 0
+
+            # 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.example.com" will change
+            # to "https://www.example.com".
+            HTTPS = 2
+          end
+
+          # UriOverrideEnforceMode defines when the URI override is enforced.
+          module UriOverrideEnforceMode
+            # UriOverrideEnforceMode Unspecified. Defaults to ALWAYS.
+            URI_OVERRIDE_ENFORCE_MODE_UNSPECIFIED = 0
+
+            # In the IF_NOT_EXISTS mode, queue-level configuration is only
+            # applied where task-level configuration does not exist.
+            IF_NOT_EXISTS = 1
+
+            # In the ALWAYS mode, queue-level configuration overrides all
+            # task-level configuration
+            ALWAYS = 2
+          end
+        end
+
+        # HTTP target.
+        #
+        # When specified at the {::Google::Cloud::Tasks::V2::Queue Queue} level, all tasks
+        # with {::Google::Cloud::Tasks::V2::HttpRequest HttpRequest} are overridden
+        # according to the target.
+        # @!attribute [rw] uri_override
+        #   @return [::Google::Cloud::Tasks::V2::UriOverride]
+        #     URI override.
+        #
+        #     When specified, overrides the execution URI for all the tasks in the queue.
+        # @!attribute [rw] http_method
+        #   @return [::Google::Cloud::Tasks::V2::HttpMethod]
+        #     The HTTP method to use for the request.
+        #
+        #     When specified, it overrides
+        #     {::Google::Cloud::Tasks::V2::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.
+        # @!attribute [rw] header_overrides
+        #   @return [::Array<::Google::Cloud::Tasks::V2::HttpTarget::HeaderOverride>]
+        #     HTTP target headers.
+        #
+        #     This map contains the header field names and values.
+        #     Headers will be set when running the
+        #     {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask} and/or
+        #     [BufferTask][google.cloud.tasks.v2.CloudTasks.BufferTask].
+        #
+        #     These headers represent a subset of the headers that will be configured for
+        #     the task's HTTP request. Some HTTP request headers will be ignored or
+        #     replaced.
+        #
+        #     A partial list of headers that will be ignored or replaced is:
+        #     * Several predefined headers, prefixed with "X-CloudTasks-", can
+        #     be used to define properties of the task.
+        #     * Host: This will be computed by Cloud Tasks and derived from
+        #     [HttpRequest.url][google.cloud.tasks.v2.Target.HttpRequest.url].
+        #     * Content-Length: This will be computed by Cloud Tasks.
+        #
+        #     `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+        #     `Content-Type` to a media type when the
+        #      {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task task is created}.
+        #      For example, `Content-Type` can be set to `"application/octet-stream"` or
+        #      `"application/json"`. The default value is set to `"application/json"`.
+        #
+        #     * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+        #
+        #     Headers which can have multiple values (according to RFC2616) can be
+        #     specified using comma-separated values.
+        #
+        #     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::V2::OAuthToken]
+        #     If specified, an
+        #     [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+        #     is generated and attached as the `Authorization` header in the HTTP
+        #     request.
+        #
+        #     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::V2::OidcToken]
+        #     If specified, an
+        #     [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+        #     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. 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
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Defines a header message. A header can have a key and a value.
+          # @!attribute [rw] key
+          #   @return [::String]
+          #     The Key of the header.
+          # @!attribute [rw] value
+          #   @return [::String]
+          #     The Value of the header.
+          class Header
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Wraps the Header object.
+          # @!attribute [rw] header
+          #   @return [::Google::Cloud::Tasks::V2::HttpTarget::Header]
+          #     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
+          end
+        end
+
         # HTTP request.
         #
         # The task will be pushed to the worker as an HTTP request. If the worker
@@ -72,7 +286,7 @@ module Google
         #
         #     This map contains the header field names and values.
         #     Headers can be set when the
-        #     [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+        #     {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task task is created}.
         #
         #     These headers represent a subset of the headers that will accompany the
         #     task's HTTP request. Some HTTP request headers will be ignored or replaced.
@@ -88,7 +302,7 @@ module Google
         #
         #     `Content-Type` won't be set by Cloud Tasks. You can explicitly set
         #     `Content-Type` to a media type when the
-        #      [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+        #      {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task task is created}.
         #      For example, `Content-Type` can be set to `"application/octet-stream"` or
         #      `"application/json"`.
         #

data/proto_docs/google/cloud/tasks/v2/task.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.
@@ -104,6 +104,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
@@ -129,6 +133,14 @@ module Google
         #   @return [::Google::Cloud::Tasks::V2::Task::View]
         #     Output only. The view specifies which subset of the
         #     {::Google::Cloud::Tasks::V2::Task Task} has been returned.
+        # @!attribute [rw] retry_config
+        #   @return [::Google::Cloud::Tasks::V2::RetryConfig]
+        #     Optional. Specifies the task-level
+        #     {::Google::Cloud::Tasks::V2::RetryConfig RetryConfig}.
+        #
+        #     If present, this overrides the
+        #     {::Google::Cloud::Tasks::V2::Queue#retry_config Queue.retry_config} for this
+        #     task.
         class Task
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/iam/v1/iam_policy.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/iam/v1/options.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/iam/v1/policy.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/longrunning/operations.rb

@@ -0,0 +1,191 @@
+# 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 Longrunning
+    # This resource represents a long-running operation that is the result of a
+    # network API call.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The server-assigned name, which is only unique within the same service that
+    #     originally returns it. If you use the default HTTP mapping, the
+    #     `name` should be a resource name ending with `operations/{unique_id}`.
+    # @!attribute [rw] metadata
+    #   @return [::Google::Protobuf::Any]
+    #     Service-specific metadata associated with the operation.  It typically
+    #     contains progress information and common metadata such as create time.
+    #     Some services might not provide such metadata.  Any method that returns a
+    #     long-running operation should document the metadata type, if any.
+    # @!attribute [rw] done
+    #   @return [::Boolean]
+    #     If the value is `false`, it means the operation is still in progress.
+    #     If `true`, the operation is completed, and either `error` or `response` is
+    #     available.
+    # @!attribute [rw] error
+    #   @return [::Google::Rpc::Status]
+    #     The error result of the operation in case of failure or cancellation.
+    #
+    #     Note: The following fields are mutually exclusive: `error`, `response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+    # @!attribute [rw] response
+    #   @return [::Google::Protobuf::Any]
+    #     The normal, successful response of the operation.  If the original
+    #     method returns no data on success, such as `Delete`, the response is
+    #     `google.protobuf.Empty`.  If the original method is standard
+    #     `Get`/`Create`/`Update`, the response should be the resource.  For other
+    #     methods, the response should have the type `XxxResponse`, where `Xxx`
+    #     is the original method name.  For example, if the original method name
+    #     is `TakeSnapshot()`, the inferred response type is
+    #     `TakeSnapshotResponse`.
+    #
+    #     Note: The following fields are mutually exclusive: `response`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+    class Operation
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # The request message for
+    # Operations.GetOperation.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The name of the operation resource.
+    class GetOperationRequest
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # The request message for
+    # Operations.ListOperations.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The name of the operation's parent resource.
+    # @!attribute [rw] filter
+    #   @return [::String]
+    #     The standard list filter.
+    # @!attribute [rw] page_size
+    #   @return [::Integer]
+    #     The standard list page size.
+    # @!attribute [rw] page_token
+    #   @return [::String]
+    #     The standard list page token.
+    # @!attribute [rw] return_partial_success
+    #   @return [::Boolean]
+    #     When set to `true`, operations that are reachable are returned as normal,
+    #     and those that are unreachable are returned in the
+    #     [ListOperationsResponse.unreachable] field.
+    #
+    #     This can only be `true` when reading across collections e.g. when `parent`
+    #     is set to `"projects/example/locations/-"`.
+    #
+    #     This field is not by default supported and will result in an
+    #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+    #     service or product specific documentation.
+    class ListOperationsRequest
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # The response message for
+    # Operations.ListOperations.
+    # @!attribute [rw] operations
+    #   @return [::Array<::Google::Longrunning::Operation>]
+    #     A list of operations that matches the specified filter in the request.
+    # @!attribute [rw] next_page_token
+    #   @return [::String]
+    #     The standard List next-page token.
+    # @!attribute [rw] unreachable
+    #   @return [::Array<::String>]
+    #     Unordered list. Unreachable resources. Populated when the request sets
+    #     `ListOperationsRequest.return_partial_success` and reads across
+    #     collections e.g. when attempting to list all resources across all supported
+    #     locations.
+    class ListOperationsResponse
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # The request message for
+    # Operations.CancelOperation.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The name of the operation resource to be cancelled.
+    class CancelOperationRequest
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # The request message for
+    # Operations.DeleteOperation.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The name of the operation resource to be deleted.
+    class DeleteOperationRequest
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # The request message for
+    # Operations.WaitOperation.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The name of the operation resource to wait on.
+    # @!attribute [rw] timeout
+    #   @return [::Google::Protobuf::Duration]
+    #     The maximum duration to wait before timing out. If left blank, the wait
+    #     will be at most the time permitted by the underlying HTTP/RPC protocol.
+    #     If RPC context deadline is also specified, the shorter one will be used.
+    class WaitOperationRequest
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # A message representing the message types used by a long-running operation.
+    #
+    # Example:
+    #
+    #     rpc Export(ExportRequest) returns (google.longrunning.Operation) {
+    #       option (google.longrunning.operation_info) = {
+    #         response_type: "ExportResponse"
+    #         metadata_type: "ExportMetadata"
+    #       };
+    #     }
+    # @!attribute [rw] response_type
+    #   @return [::String]
+    #     Required. The message name of the primary return type for this
+    #     long-running operation.
+    #     This type will be used to deserialize the LRO's response.
+    #
+    #     If the response is in a different package from the rpc, a fully-qualified
+    #     message name must be used (e.g. `google.protobuf.Struct`).
+    #
+    #     Note: Altering this value constitutes a breaking change.
+    # @!attribute [rw] metadata_type
+    #   @return [::String]
+    #     Required. The message name of the metadata type for this long-running
+    #     operation.
+    #
+    #     If the response is in a different package from the rpc, a fully-qualified
+    #     message name must be used (e.g. `google.protobuf.Struct`).
+    #
+    #     Note: Altering this value constitutes a breaking change.
+    class OperationInfo
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/protobuf/any.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.