feat: switch to cloudtasks.googleapis.com default host (#268)

Author: yoshi-automation

packages/google-cloud-tasks/protos/google/cloud/tasks/v2/cloudtasks.proto

@@ -17,11 +17,11 @@ syntax = "proto3";
 
 package google.cloud.tasks.v2;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
 option java_multiple_files = true;
@@ -32,6 +32,11 @@ option java_package = "com.google.cloud.tasks.v2";
 // how those tasks are dispatched. Configurable properties include rate limits,
 // retry options, queue types, and others.
 message Queue {
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Queue"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}"
+  };
+
   // State of the queue.
   enum State {
     // Unspecified state.
@@ -175,8 +180,7 @@ message RateLimits {
   // If unspecified when the queue is created, Cloud Tasks will pick the
   // default.
   //
-  // * For [App Engine queues][google.cloud.tasks.v2.AppEngineHttpQueue], the maximum allowed value
-  //   is 500.
+  // * The maximum allowed value is 500.
   //
   //
   // This field has the same meaning as
@@ -205,7 +209,7 @@ message RateLimits {
   // value of
   // [max_dispatches_per_second][google.cloud.tasks.v2.RateLimits.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

packages/google-cloud-tasks/protos/google/cloud/tasks/v2/queue.proto

@@ -52,11 +52,10 @@ option java_package = "com.google.cloud.tasks.v2";
 // The [AppEngineRouting][google.cloud.tasks.v2.AppEngineRouting] used to construct the URL that the task is
 // delivered to can be set at the queue-level or task-level:
 //
-// * If set,
-//    [app_engine_routing_override][google.cloud.tasks.v2.AppEngineHttpQueue.app_engine_routing_override]
-//    is used for all 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].
+// * 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:
@@ -79,7 +78,7 @@ option java_package = "com.google.cloud.tasks.v2";
 // the app's handler returns a non-2xx response code or Cloud Tasks does
 // not receive response before the [deadline][google.cloud.tasks.v2.Task.dispatch_deadline]. Failed
 // tasks will be retried according to the
-// [retry configuration][Queue.RetryConfig]. `503` (Service Unavailable) is
+// [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
@@ -101,10 +100,10 @@ message AppEngineHttpRequest {
 
   // Task-level setting for App Engine routing.
   //
-  // If set,
-  // [app_engine_routing_override][google.cloud.tasks.v2.AppEngineHttpQueue.app_engine_routing_override]
-  // is used for all 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].
+  // * 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].
   AppEngineRouting app_engine_routing = 2;
 
   // The relative URI.
@@ -180,6 +179,13 @@ message AppEngineHttpRequest {
 // 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 [AppEngineRouting][google.cloud.tasks.v2.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`
 message AppEngineRouting {
   // App service.
   //

packages/google-cloud-tasks/protos/google/cloud/tasks/v2/target.proto

@@ -17,12 +17,12 @@ syntax = "proto3";
 
 package google.cloud.tasks.v2;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
 option java_multiple_files = true;
@@ -31,6 +31,11 @@ option java_package = "com.google.cloud.tasks.v2";
 
 // A unit of scheduled work.
 message Task {
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Task"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}"
+  };
+
   // The view specifies a subset of [Task][google.cloud.tasks.v2.Task] data.
   //
   // When a task is returned in a response, not all
@@ -90,9 +95,7 @@ message Task {
     AppEngineHttpRequest app_engine_http_request = 2;
   }
 
-  // The time when the task is scheduled to be attempted.
-  //
-  // For App Engine queues, this is when the task will be attempted or retried.
+  // The time when the task is scheduled to be attempted or retried.
   //
   // `schedule_time` will be truncated to the nearest microsecond.
   google.protobuf.Timestamp schedule_time = 4;