google-cloud-tasks 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d347f5912f20027711d7d4a3f66f3a52182cc0822927829525820a9cc3fa7394
-  data.tar.gz: d942d2138c10248742c72cb58d8e9d7784b8501bb5ccf482229407f94110f5c3
+  metadata.gz: 07063017ddc2c5f294c92738e866194e62fc147613af5cb948d80896fefb050c
+  data.tar.gz: 4142af8246017146d7ad67e50d934b247df1ef68a16e1f3028034775ffaa09cf
 SHA512:
-  metadata.gz: 0fdabdc356f1abdcb1e7ecd63293983cadfdf7f287e4f96a087f533043f4e4afc6321b3bb0f33d470622beaf6d9336b21a5fbf044426de909fea2839f5ba4d5c
-  data.tar.gz: 539bccd3907a1104077abd52d618228eb3446e09601eb97a8c00429205015d54449905f2e300869fd93828feb7d4d264179e5caf9ae0a61f0167156b9d37fe99
+  metadata.gz: 24dbec2fe9eba337408d29e63b68de903f135fadbfd89a92ad630b3da4e8c57aa2b8c73115cf1f4953369d34873be9fdf6ce3537e4970241a9edfb3b1d01815d
+  data.tar.gz: 1ed6c801a5d45a2b6022e2adaf1012b144d42c3ed29a002e4b28843208323b6c77918c2dd49e754fab3adbf78b5df7356c2e964bb2537925db90cd5568953c56

data/README.md

@@ -12,7 +12,7 @@ steps:
 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
 3. [Enable the Cloud Tasks API.](https://console.cloud.google.com/apis/library/tasks.googleapis.com)
-4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-tasks/latest/file.AUTHENTICATION.html)
 
 ### Installation
 ```
@@ -27,14 +27,14 @@ $ gem install google-cloud-tasks
 - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
   to see the full list of Cloud APIs that we cover.
 
-[Client Library Documentation]: https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-tasks/latest/google/cloud/tasks/v2
+[Client Library Documentation]: https://googleapis.dev/ruby/google-cloud-tasks/latest
 [Product Documentation]: https://cloud.google.com/tasks
 
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

data/lib/google/cloud/tasks.rb

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

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

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

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

@@ -391,9 +391,7 @@ module Google
           # Queues are returned in lexicographical order.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The location name.
+          #   Required. The location name.
           #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
           # @param filter [String]
           #   `filter` can be used to specify a subset of queues. Any {Google::Cloud::Tasks::V2::Queue Queue}
@@ -462,9 +460,7 @@ module Google
           # Gets a queue.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The resource name of the queue. For example:
+          #   Required. The resource name of the queue. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -506,18 +502,14 @@ module Google
           # this method.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The location name in which the queue will be created.
+          #   Required. The location name in which the queue will be created.
           #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
           #
           #   The list of allowed locations can be obtained by calling Cloud
           #   Tasks' implementation of
           #   {Google::Cloud::Location::Locations::ListLocations ListLocations}.
           # @param queue [Google::Cloud::Tasks::V2::Queue | Hash]
-          #   Required.
-          #
-          #   The queue to create.
+          #   Required. The queue to create.
           #
           #   {Google::Cloud::Tasks::V2::Queue#name Queue's name} cannot be the same as an existing queue.
           #   A hash of the same form as `Google::Cloud::Tasks::V2::Queue`
@@ -570,9 +562,7 @@ module Google
           # this method.
           #
           # @param queue [Google::Cloud::Tasks::V2::Queue | Hash]
-          #   Required.
-          #
-          #   The queue to create or update.
+          #   Required. The queue to create or update.
           #
           #   The queue's {Google::Cloud::Tasks::V2::Queue#name name} must be specified.
           #
@@ -632,9 +622,7 @@ module Google
           # this method.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -670,9 +658,7 @@ module Google
           # might be dispatched before the purge takes effect. A purge is irreversible.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -709,9 +695,7 @@ module Google
           # {Google::Cloud::Tasks::V2::Queue#state state} is {Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -754,9 +738,7 @@ module Google
           # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -941,9 +923,7 @@ module Google
           # time.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           # @param response_view [Google::Cloud::Tasks::V2::Task::View]
           #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2::Task Task} will be
@@ -1013,9 +993,7 @@ module Google
           # Gets a task.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param response_view [Google::Cloud::Tasks::V2::Task::View]
           #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2::Task Task} will be
@@ -1065,16 +1043,12 @@ module Google
           # * The maximum task size is 100KB.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The queue name. For example:
+          #   Required. The queue name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
           #
           #   The queue must already exist.
           # @param task [Google::Cloud::Tasks::V2::Task | Hash]
-          #   Required.
-          #
-          #   The task to add.
+          #   Required. The task to add.
           #
           #   Task names have the following format:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
@@ -1162,9 +1136,7 @@ module Google
           # failed.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -1218,9 +1190,7 @@ module Google
           # task that has already succeeded or permanently failed.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The task name. For example:
+          #   Required. The task name. For example:
           #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
           # @param response_view [Google::Cloud::Tasks::V2::Task::View]
           #   The response_view specifies which subset of the {Google::Cloud::Tasks::V2::Task Task} will be

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

@@ -5,13 +5,14 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
 require 'google/cloud/tasks/v2/queue_pb'
 require 'google/cloud/tasks/v2/task_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
-require 'google/rpc/code_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.tasks.v2.ListQueuesRequest" do
     optional :parent, :string, 1

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

@@ -20,9 +20,7 @@ module Google
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::ListQueues ListQueues}.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required.
-        #
-        #     The location name.
+        #     Required. The location name.
         #     For example: `projects/PROJECT_ID/locations/LOCATION_ID`
         # @!attribute [rw] filter
         #   @return [String]
@@ -78,18 +76,14 @@ module Google
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::GetQueue GetQueue}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The resource name of the queue. For example:
+        #     Required. The resource name of the queue. For example:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
         class GetQueueRequest; end
 
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::CreateQueue CreateQueue}.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required.
-        #
-        #     The location name in which the queue will be created.
+        #     Required. The location name in which the queue will be created.
         #     For example: `projects/PROJECT_ID/locations/LOCATION_ID`
         #
         #     The list of allowed locations can be obtained by calling Cloud
@@ -97,9 +91,7 @@ module Google
         #     {Google::Cloud::Location::Locations::ListLocations ListLocations}.
         # @!attribute [rw] queue
         #   @return [Google::Cloud::Tasks::V2::Queue]
-        #     Required.
-        #
-        #     The queue to create.
+        #     Required. The queue to create.
         #
         #     {Google::Cloud::Tasks::V2::Queue#name Queue's name} cannot be the same as an existing queue.
         class CreateQueueRequest; end
@@ -107,9 +99,7 @@ module Google
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::UpdateQueue UpdateQueue}.
         # @!attribute [rw] queue
         #   @return [Google::Cloud::Tasks::V2::Queue]
-        #     Required.
-        #
-        #     The queue to create or update.
+        #     Required. The queue to create or update.
         #
         #     The queue's {Google::Cloud::Tasks::V2::Queue#name name} must be specified.
         #
@@ -126,45 +116,35 @@ module Google
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::DeleteQueue DeleteQueue}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The queue name. For example:
+        #     Required. The queue name. For example:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
         class DeleteQueueRequest; end
 
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::PurgeQueue PurgeQueue}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The queue name. For example:
+        #     Required. The queue name. For example:
         #     `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
         class PurgeQueueRequest; end
 
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::PauseQueue PauseQueue}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The queue name. For example:
+        #     Required. The queue name. For example:
         #     `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
         class PauseQueueRequest; end
 
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::ResumeQueue ResumeQueue}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The queue name. For example:
+        #     Required. The queue name. For example:
         #     `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
         class ResumeQueueRequest; end
 
         # Request message for listing tasks using {Google::Cloud::Tasks::V2::CloudTasks::ListTasks ListTasks}.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required.
-        #
-        #     The queue name. For example:
+        #     Required. The queue name. For example:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
         # @!attribute [rw] response_view
         #   @return [Google::Cloud::Tasks::V2::Task::View]
@@ -221,9 +201,7 @@ module Google
         # Request message for getting a task using {Google::Cloud::Tasks::V2::CloudTasks::GetTask GetTask}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The task name. For example:
+        #     Required. The task name. For example:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @!attribute [rw] response_view
         #   @return [Google::Cloud::Tasks::V2::Task::View]
@@ -244,17 +222,13 @@ module Google
         # Request message for {Google::Cloud::Tasks::V2::CloudTasks::CreateTask CreateTask}.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required.
-        #
-        #     The queue name. For example:
+        #     Required. The queue name. For example:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
         #
         #     The queue must already exist.
         # @!attribute [rw] task
         #   @return [Google::Cloud::Tasks::V2::Task]
-        #     Required.
-        #
-        #     The task to add.
+        #     Required. The task to add.
         #
         #     Task names have the following format:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
@@ -307,9 +281,7 @@ module Google
         # {Google::Cloud::Tasks::V2::CloudTasks::DeleteTask DeleteTask}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The task name. For example:
+        #     Required. The task name. For example:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         class DeleteTaskRequest; end
 
@@ -317,9 +289,7 @@ module Google
         # {Google::Cloud::Tasks::V2::CloudTasks::RunTask RunTask}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The task name. For example:
+        #     Required. The task name. For example:
         #     `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @!attribute [rw] response_view
         #   @return [Google::Cloud::Tasks::V2::Task::View]

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

@@ -165,8 +165,7 @@ module Google
         #     If unspecified when the queue is created, Cloud Tasks will pick the
         #     default.
         #
-        #     * For {Google::Cloud::Tasks::V2::AppEngineHttpQueue App Engine queues}, the maximum allowed value
-        #       is 500.
+        #     * The maximum allowed value is 500.
         #
         #
         #     This field has the same meaning as
@@ -195,7 +194,7 @@ module Google
         #     value of
         #     {Google::Cloud::Tasks::V2::RateLimits#max_dispatches_per_second max_dispatches_per_second}.
         #
-        #     For App Engine queues that were created or updated using
+        #     For queues that were created or updated using
         #     `queue.yaml/xml`, `max_burst_size` is equal to
         #     [bucket_size](https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size).
         #     Since `max_burst_size` is output only, if

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

@@ -45,11 +45,10 @@ module Google
         # 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 set,
-        #   {Google::Cloud::Tasks::V2::AppEngineHttpQueue#app_engine_routing_override app_engine_routing_override}
-        #   is used for all tasks in the queue, no matter what the setting
-        #   is for the
-        #   {Google::Cloud::Tasks::V2::AppEngineHttpRequest#app_engine_routing task-level app_engine_routing}.
+        # * If [app_engine_routing_override is set on the
+        #   queue][Queue.app_engine_routing_override], this value is used for all
+        #   tasks in the queue, no matter what the setting is for the [task-level
+        #   app_engine_routing][AppEngineHttpRequest.app_engine_routing].
         #
         #
         # The `url` that the task will be sent to is:
@@ -72,7 +71,7 @@ module Google
         # 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
-        # {Queue::RetryConfig retry configuration}. `503` (Service Unavailable) is
+        # {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
@@ -95,10 +94,10 @@ module Google
         #   @return [Google::Cloud::Tasks::V2::AppEngineRouting]
         #     Task-level setting for App Engine routing.
         #
-        #     If set,
-        #     {Google::Cloud::Tasks::V2::AppEngineHttpQueue#app_engine_routing_override app_engine_routing_override}
-        #     is used for all tasks in the queue, no matter what the setting is for the
-        #     {Google::Cloud::Tasks::V2::AppEngineHttpRequest#app_engine_routing task-level app_engine_routing}.
+        #     * If [app_engine_routing_override is set on the
+        #       queue][Queue.app_engine_routing_override], this value is used for all
+        #       tasks in the queue, no matter what the setting is for the [task-level
+        #       app_engine_routing][AppEngineHttpRequest.app_engine_routing].
         # @!attribute [rw] relative_uri
         #   @return [String]
         #     The relative URI.
@@ -173,6 +172,13 @@ module Google
         # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
         # and [App Engine Flex request
         # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+        #
+        # Using {Google::Cloud::Tasks::V2::AppEngineRouting AppEngineRouting} requires
+        # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
+        # Google IAM permission for the project
+        # and the following scope:
+        #
+        # `https://www.googleapis.com/auth/cloud-platform`
         # @!attribute [rw] service
         #   @return [String]
         #     App service.