google-cloud-tasks-v2 0.6.0 → 0.8.0

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

@@ -29,8 +29,10 @@ module Google
         # any other HTTP response code is returned or no response is received, the
         # task will be retried according to the following:
         #
-        # * User-specified throttling: {::Google::Cloud::Tasks::V2::Queue#retry_config retry configuration},
-        #   {::Google::Cloud::Tasks::V2::Queue#rate_limits rate limits}, and the [queue's state][google.cloud.tasks.v2.Queue.state].
+        # * User-specified throttling: [retry
+        # configuration][google.cloud.tasks.v2.Queue.retry_config],
+        #   {::Google::Cloud::Tasks::V2::Queue#rate_limits rate limits}, and the [queue's
+        #   state][google.cloud.tasks.v2.Queue.state].
         #
         # * System throttling: To prevent the worker from overloading, Cloud Tasks may
         #   temporarily reduce the queue's effective rate. User-specified settings
@@ -39,10 +41,11 @@ module Google
         #  System throttling happens because:
         #
         #   * Cloud Tasks backs off on all errors. Normally the backoff specified in
-        #     {::Google::Cloud::Tasks::V2::Queue#rate_limits rate limits} will be used. But if the worker returns
-        #     `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
-        #     errors is high, Cloud Tasks will use a higher backoff rate. The retry
-        #     specified in the `Retry-After` HTTP response header is considered.
+        #     {::Google::Cloud::Tasks::V2::Queue#rate_limits rate limits} will be used. But
+        #     if the worker returns `429` (Too Many Requests), `503` (Service
+        #     Unavailable), or the rate of errors is high, Cloud Tasks will use a
+        #     higher backoff rate. The retry specified in the `Retry-After` HTTP
+        #     response header is considered.
         #
         #   * To prevent traffic spikes and to smooth sudden increases in traffic,
         #     dispatches ramp up slowly when the queue is newly created or idle and
@@ -98,8 +101,9 @@ module Google
         #     HTTP request body.
         #
         #     A request body is allowed only if the
-        #     {::Google::Cloud::Tasks::V2::HttpRequest#http_method HTTP method} is POST, PUT, or PATCH. It is an
-        #     error to set body on a task with an incompatible {::Google::Cloud::Tasks::V2::HttpMethod HttpMethod}.
+        #     {::Google::Cloud::Tasks::V2::HttpRequest#http_method HTTP method} is POST, PUT,
+        #     or PATCH. It is an error to set body on a task with an incompatible
+        #     {::Google::Cloud::Tasks::V2::HttpMethod HttpMethod}.
         # @!attribute [rw] oauth_token
         #   @return [::Google::Cloud::Tasks::V2::OAuthToken]
         #     If specified, an
@@ -138,7 +142,8 @@ module Google
         # The message defines the HTTP request that is sent to an App Engine app when
         # the task is dispatched.
         #
-        # Using {::Google::Cloud::Tasks::V2::AppEngineHttpRequest AppEngineHttpRequest} requires
+        # Using {::Google::Cloud::Tasks::V2::AppEngineHttpRequest AppEngineHttpRequest}
+        # requires
         # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
         # Google IAM permission for the project
         # and the following scope:
@@ -158,8 +163,9 @@ module Google
         # The request to the handler, however, will appear to have used the HTTP
         # protocol.
         #
-        # The {::Google::Cloud::Tasks::V2::AppEngineRouting AppEngineRouting} used to construct the URL that the task is
-        # delivered to can be set at the queue-level or task-level:
+        # The {::Google::Cloud::Tasks::V2::AppEngineRouting AppEngineRouting} used to
+        # construct the URL that the task is delivered to can be set at the queue-level
+        # or task-level:
         #
         # * If [app_engine_routing_override is set on the
         #    queue][Queue.app_engine_routing_override], this value is used for all
@@ -185,14 +191,15 @@ module Google
         # The task attempt has succeeded if the app's request handler returns an HTTP
         # response code in the range [`200` - `299`]. The task attempt has failed if
         # the app's handler returns a non-2xx response code or Cloud Tasks does
-        # not receive response before the {::Google::Cloud::Tasks::V2::Task#dispatch_deadline deadline}. Failed
-        # tasks will be retried according to the
-        # {::Google::Cloud::Tasks::V2::Queue#retry_config retry configuration}. `503` (Service Unavailable) is
-        # considered an App Engine system error instead of an application error and
-        # will cause Cloud Tasks' traffic congestion control to temporarily throttle
-        # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
-        # Requests) response from an app handler does not cause traffic congestion
-        # control to throttle the queue.
+        # not receive response before the
+        # {::Google::Cloud::Tasks::V2::Task#dispatch_deadline deadline}. Failed tasks will
+        # be retried according to the [retry
+        # configuration][google.cloud.tasks.v2.Queue.retry_config]. `503` (Service
+        # Unavailable) is considered an App Engine system error instead of an
+        # application error and will cause Cloud Tasks' traffic congestion control to
+        # temporarily throttle the queue's dispatches. Unlike other types of task
+        # targets, a `429` (Too Many Requests) response from an app handler does not
+        # cause traffic congestion control to throttle the queue.
         # @!attribute [rw] http_method
         #   @return [::Google::Cloud::Tasks::V2::HttpMethod]
         #     The HTTP method to use for the request. The default is POST.
@@ -239,8 +246,8 @@ module Google
         #       `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
         #       modified `User-Agent`.
         #
-        #     If the task has a {::Google::Cloud::Tasks::V2::AppEngineHttpRequest#body body}, Cloud
-        #     Tasks sets the following headers:
+        #     If the task has a {::Google::Cloud::Tasks::V2::AppEngineHttpRequest#body body},
+        #     Cloud Tasks sets the following headers:
         #
         #     * `Content-Type`: By default, the `Content-Type` header is set to
         #       `"application/octet-stream"`. The default can be overridden by explicitly
@@ -264,14 +271,16 @@ module Google
         #     visible when the task is returned in a Cloud Tasks response.
         #
         #     Although there is no specific limit for the maximum number of headers or
-        #     the size, there is a limit on the maximum size of the {::Google::Cloud::Tasks::V2::Task Task}. For more
-        #     information, see the {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask} documentation.
+        #     the size, there is a limit on the maximum size of the
+        #     {::Google::Cloud::Tasks::V2::Task Task}. For more information, see the
+        #     {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask} documentation.
         # @!attribute [rw] body
         #   @return [::String]
         #     HTTP request body.
         #
         #     A request body is allowed only if the HTTP method is POST or PUT. It is
-        #     an error to set a body on a task with an incompatible {::Google::Cloud::Tasks::V2::HttpMethod HttpMethod}.
+        #     an error to set a body on a task with an incompatible
+        #     {::Google::Cloud::Tasks::V2::HttpMethod HttpMethod}.
         class AppEngineHttpRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -315,16 +324,17 @@ module Google
         #     service when the task is attempted.
         #
         #     For some queues or tasks which were created using the App Engine
-        #     Task Queue API, {::Google::Cloud::Tasks::V2::AppEngineRouting#host host} is not parsable
-        #     into {::Google::Cloud::Tasks::V2::AppEngineRouting#service service},
+        #     Task Queue API, {::Google::Cloud::Tasks::V2::AppEngineRouting#host host} is not
+        #     parsable into {::Google::Cloud::Tasks::V2::AppEngineRouting#service service},
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#version version}, and
-        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance}. For example, some tasks
-        #     which were created using the App Engine SDK use a custom domain
+        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance}. For example,
+        #     some tasks which were created using the App Engine SDK use a custom domain
         #     name; custom domains are not parsed by Cloud Tasks. If
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#host host} is not parsable, then
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#service service},
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#version version}, and
-        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance} are the empty string.
+        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance} are the empty
+        #     string.
         # @!attribute [rw] version
         #   @return [::String]
         #     App version.
@@ -333,16 +343,17 @@ module Google
         #     version when the task is attempted.
         #
         #     For some queues or tasks which were created using the App Engine
-        #     Task Queue API, {::Google::Cloud::Tasks::V2::AppEngineRouting#host host} is not parsable
-        #     into {::Google::Cloud::Tasks::V2::AppEngineRouting#service service},
+        #     Task Queue API, {::Google::Cloud::Tasks::V2::AppEngineRouting#host host} is not
+        #     parsable into {::Google::Cloud::Tasks::V2::AppEngineRouting#service service},
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#version version}, and
-        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance}. For example, some tasks
-        #     which were created using the App Engine SDK use a custom domain
+        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance}. For example,
+        #     some tasks which were created using the App Engine SDK use a custom domain
         #     name; custom domains are not parsed by Cloud Tasks. If
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#host host} is not parsable, then
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#service service},
         #     {::Google::Cloud::Tasks::V2::AppEngineRouting#version version}, and
-        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance} are the empty string.
+        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance} are the empty
+        #     string.
         # @!attribute [rw] instance
         #   @return [::String]
         #     App instance.
@@ -364,9 +375,10 @@ module Google
         #
         #     The host is constructed from the domain name of the app associated with
         #     the queue's project ID (for example <app-id>.appspot.com), and the
-        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#service service}, {::Google::Cloud::Tasks::V2::AppEngineRouting#version version},
-        #     and {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance}. Tasks which were created using
-        #     the App Engine SDK might have a custom domain name.
+        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#service service},
+        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#version version}, and
+        #     {::Google::Cloud::Tasks::V2::AppEngineRouting#instance instance}. Tasks which
+        #     were created using the App Engine SDK might have a custom domain name.
         #
         #     For more information, see
         #     [How Requests are

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

@@ -24,7 +24,8 @@ module Google
         # A unit of scheduled work.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Optionally caller-specified in {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask}.
+        #     Optionally caller-specified in
+        #     {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask}.
         #
         #     The task name.
         #
@@ -48,12 +49,14 @@ module Google
         #   @return [::Google::Cloud::Tasks::V2::AppEngineHttpRequest]
         #     HTTP request that is sent to the App Engine app handler.
         #
-        #     An App Engine task is a task that has {::Google::Cloud::Tasks::V2::AppEngineHttpRequest AppEngineHttpRequest} set.
+        #     An App Engine task is a task that has
+        #     {::Google::Cloud::Tasks::V2::AppEngineHttpRequest AppEngineHttpRequest} set.
         # @!attribute [rw] http_request
         #   @return [::Google::Cloud::Tasks::V2::HttpRequest]
         #     HTTP request that is sent to the worker.
         #
-        #     An HTTP task is a task that has {::Google::Cloud::Tasks::V2::HttpRequest HttpRequest} set.
+        #     An HTTP task is a task that has
+        #     {::Google::Cloud::Tasks::V2::HttpRequest HttpRequest} set.
         # @!attribute [rw] schedule_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The time when the task is scheduled to be attempted or retried.
@@ -78,10 +81,12 @@ module Google
         #
         #     The default and maximum values depend on the type of request:
         #
-        #     * For {::Google::Cloud::Tasks::V2::HttpRequest HTTP tasks}, the default is 10 minutes. The deadline
+        #     * For {::Google::Cloud::Tasks::V2::HttpRequest HTTP tasks}, the default is 10
+        #     minutes. The deadline
         #       must be in the interval [15 seconds, 30 minutes].
         #
-        #     * For {::Google::Cloud::Tasks::V2::AppEngineHttpRequest App Engine tasks}, 0 indicates that the
+        #     * For {::Google::Cloud::Tasks::V2::AppEngineHttpRequest App Engine tasks}, 0
+        #     indicates that the
         #       request has the default deadline. The default deadline depends on the
         #       [scaling
         #       type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
@@ -110,15 +115,16 @@ module Google
         #   @return [::Google::Cloud::Tasks::V2::Attempt]
         #     Output only. The status of the task's first attempt.
         #
-        #     Only {::Google::Cloud::Tasks::V2::Attempt#dispatch_time dispatch_time} will be set.
-        #     The other {::Google::Cloud::Tasks::V2::Attempt Attempt} information is not retained by Cloud Tasks.
+        #     Only {::Google::Cloud::Tasks::V2::Attempt#dispatch_time dispatch_time} will be
+        #     set. The other {::Google::Cloud::Tasks::V2::Attempt Attempt} information is not
+        #     retained by Cloud Tasks.
         # @!attribute [rw] last_attempt
         #   @return [::Google::Cloud::Tasks::V2::Attempt]
         #     Output only. The status of the task's last attempt.
         # @!attribute [rw] view
         #   @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.
+        #     Output only. The view specifies which subset of the
+        #     {::Google::Cloud::Tasks::V2::Task Task} has been returned.
         class Task
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -138,7 +144,8 @@ module Google
             # sensitive data.
             #
             # This view does not include the
-            # {::Google::Cloud::Tasks::V2::AppEngineHttpRequest#body body in AppEngineHttpRequest}.
+            # [body in
+            # AppEngineHttpRequest][google.cloud.tasks.v2.AppEngineHttpRequest.body].
             # Bodies are desirable to return only when needed, because they
             # can be large and because of the sensitivity of the data that you
             # choose to store in it.

data/proto_docs/google/iam/v1/policy.rb

@@ -35,7 +35,8 @@ module Google
       # only if the expression evaluates to `true`. A condition can add constraints
       # based on attributes of the request, the resource, or both. To learn which
       # resources support conditions in their IAM policies, see the
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      # [IAM
+      # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       #
       # **JSON example:**
       #
@@ -58,7 +59,8 @@ module Google
       #           "condition": {
       #             "title": "expirable access",
       #             "description": "Does not grant access after Sep 2020",
-      #             "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
+      #             "expression": "request.time <
+      #             timestamp('2020-10-01T00:00:00.000Z')",
       #           }
       #         }
       #       ],
@@ -112,7 +114,8 @@ module Google
       #     specify any valid version or leave the field unset.
       #
       #     To learn which resources support conditions in their IAM policies, see the
-      #     [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      #     [IAM
+      #     documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       # @!attribute [rw] bindings
       #   @return [::Array<::Google::Iam::V1::Binding>]
       #     Associates a list of `members`, or principals, with a `role`. Optionally,
@@ -305,7 +308,8 @@ module Google
       #   @return [::Array<::String>]
       #     Specifies the identities that do not cause logging for this type of
       #     permission.
-      #     Follows the same format of {::Google::Iam::V1::Binding#members Binding.members}.
+      #     Follows the same format of
+      #     {::Google::Iam::V1::Binding#members Binding.members}.
       class AuditLogConfig
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    # Example 4: Pack and unpack a message in Go
+    #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # JSON
-    #
+    # ====
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/timestamp.rb

@@ -69,7 +69,6 @@ module Google
     #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
-    #
     # Example 5: Compute Timestamp from Java `Instant.now()`.
     #
     #     Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
     #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
     #             .setNanos(now.getNano()).build();
     #
-    #
     # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
     # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
     # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
     # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]

data/proto_docs/google/rpc/status.rb

@@ -28,12 +28,14 @@ module Google
     # [API Design Guide](https://cloud.google.com/apis/design/errors).
     # @!attribute [rw] code
     #   @return [::Integer]
-    #     The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+    #     The status code, which should be an enum value of
+    #     [google.rpc.Code][google.rpc.Code].
     # @!attribute [rw] message
     #   @return [::String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
+    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [::Array<::Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-tasks-v2
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-08 00:00:00.000000000 Z
+date: 2023-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: 0.19.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: 0.19.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -64,14 +64,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.1
+        version: 1.26.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.1
+        version: 1.26.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -191,14 +191,20 @@ files:
 - lib/google/cloud/tasks/v2/cloud_tasks/client.rb
 - lib/google/cloud/tasks/v2/cloud_tasks/credentials.rb
 - lib/google/cloud/tasks/v2/cloud_tasks/paths.rb
+- lib/google/cloud/tasks/v2/cloud_tasks/rest.rb
+- lib/google/cloud/tasks/v2/cloud_tasks/rest/client.rb
+- lib/google/cloud/tasks/v2/cloud_tasks/rest/service_stub.rb
 - lib/google/cloud/tasks/v2/cloudtasks_pb.rb
 - lib/google/cloud/tasks/v2/cloudtasks_services_pb.rb
 - lib/google/cloud/tasks/v2/queue_pb.rb
+- lib/google/cloud/tasks/v2/rest.rb
 - lib/google/cloud/tasks/v2/target_pb.rb
 - lib/google/cloud/tasks/v2/task_pb.rb
 - lib/google/cloud/tasks/v2/version.rb
 - proto_docs/README.md
+- proto_docs/google/api/client.rb
 - proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/cloud/tasks/v2/cloudtasks.rb
 - proto_docs/google/cloud/tasks/v2/queue.rb
@@ -233,8 +239,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.14
+rubygems_version: 3.4.2
 signing_key: 
 specification_version: 4
-summary: API Client library for the Cloud Tasks V2 API
+summary: Manages the execution of large numbers of distributed requests.
 test_files: []