Regen all docs. (#700)

* Stop recursing if discovery == {}

* Generate docs with 'make docs'.
diff --git a/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html b/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html
new file mode 100644
index 0000000..9056d5e
--- /dev/null
+++ b/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html
@@ -0,0 +1,2069 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="cloudtasks_v2.html">Cloud Tasks API</a> . <a href="cloudtasks_v2.projects.html">projects</a> . <a href="cloudtasks_v2.projects.locations.html">locations</a> . <a href="cloudtasks_v2.projects.locations.queues.html">queues</a> . <a href="cloudtasks_v2.projects.locations.queues.tasks.html">tasks</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#create">create(parent, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a task and adds it to a queue.</p>
+<p class="toc_element">
+  <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes a task.</p>
+<p class="toc_element">
+  <code><a href="#get">get(name, responseView=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets a task.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent, responseView=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists the tasks in a queue.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+  <code><a href="#run">run(name, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Forces a task to run now.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="create">create(parent, body, x__xgafv=None)</code>
+  <pre>Creates a task and adds it to a queue.
+
+Tasks cannot be updated after creation; there is no UpdateTask command.
+
+* The maximum task size is 100KB.
+
+Args:
+  parent: string, Required.
+
+The queue name. For example:
+`projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+
+The queue must already exist. (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Request message for CreateTask.
+    "responseView": "A String", # The response_view specifies which subset of the Task will be
+        # returned.
+        # 
+        # By default response_view is BASIC; not all
+        # information is retrieved by default because some data, such as
+        # payloads, might be desirable to return only when needed because
+        # of its large size or because of the sensitivity of data that it
+        # contains.
+        # 
+        # Authorization for FULL requires
+        # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+        # permission on the Task resource.
+    "task": { # A unit of scheduled work. # Required.
+        # 
+        # The task to add.
+        # 
+        # Task names have the following format:
+        # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
+        # The user can optionally specify a task name. If a
+        # name is not specified then the system will generate a random
+        # unique task id, which will be set in the task returned in the
+        # response.
+        # 
+        # If schedule_time is not set or is in the
+        # past then Cloud Tasks will set it to the current time.
+        # 
+        # Task De-duplication:
+        # 
+        # Explicitly specifying a task ID enables task de-duplication.  If
+        # 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.
+        # If the task's queue was created using Cloud Tasks, then another task with
+        # the same name can't be created for ~1hour 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 ~9days after the original task was deleted or executed.
+        # 
+        # Because there is an extra lookup cost to identify duplicate task
+        # names, these CreateTask calls have significantly
+        # increased latency. Using hashed strings for the task id or for
+        # the prefix of the task id is recommended. Choosing task ids that
+        # are sequential or have sequential prefixes, for example using a
+        # timestamp, causes an increase in latency and error rates in all
+        # task commands. The infrastructure relies on an approximately
+        # uniform distribution of task ids to store and serve tasks
+        # efficiently.
+      "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+          #
+          # An App Engine task is a task that has AppEngineHttpRequest set.
+          #
+          # The message defines the HTTP request that is sent to an App Engine app when
+          # the task is dispatched.
+          #
+          # Using 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:
+          #
+          # `https://www.googleapis.com/auth/cloud-platform`
+          #
+          # The task will be delivered to the App Engine app which belongs to the same
+          # project as the queue. For more information, see
+          # [How Requests are
+          # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+          # and how routing is affected by
+          # [dispatch
+          # files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
+          # Traffic is encrypted during transport and never leaves Google datacenters.
+          # Because this traffic is carried over a communication mechanism internal to
+          # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
+          # The request to the handler, however, will appear to have used the HTTP
+          # protocol.
+          #
+          # The 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
+          #    is used for all tasks in the queue, no matter what the setting
+          #    is for the
+          #    task-level app_engine_routing.
+          #
+          #
+          # The `url` that the task will be sent to is:
+          #
+          # * `url =` host `+`
+          #   relative_uri
+          #
+          # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
+          # URIs restricted with
+          # [`login:
+          # admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
+          # Because tasks are not run as any user, they cannot be dispatched to URIs
+          # restricted with
+          # [`login:
+          # required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
+          # Task dispatches also do not follow redirects.
+          #
+          # 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 deadline. Failed
+          # tasks will be retried according to the
+          # 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.
+        "body": "A 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 HttpMethod.
+        "headers": { # HTTP request headers.
+            #
+            # This map contains the header field names and values.
+            # Headers can be set when the
+            # task is created.
+            # Repeated headers are not supported but a header value can contain commas.
+            #
+            # Cloud Tasks sets some headers to default values:
+            #
+            # * `User-Agent`: By default, this header is
+            #   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+            #   This header can be modified, but Cloud Tasks will append
+            #   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+            #   modified `User-Agent`.
+            #
+            # If the task has a 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
+            #   setting `Content-Type` to a particular media type when the
+            #   task is created.
+            #   For example, `Content-Type` can be set to `"application/json"`.
+            # * `Content-Length`: This is computed by Cloud Tasks. This value is
+            #   output only.   It cannot be changed.
+            #
+            # The headers below cannot be set or overridden:
+            #
+            # * `Host`
+            # * `X-Google-*`
+            # * `X-AppEngine-*`
+            #
+            # In addition, Cloud Tasks sets some headers when the task is dispatched,
+            # such as headers containing information about the task; see
+            # [request
+            # headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers).
+            # These headers are set only when the task is dispatched, so they are not
+            # 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 Task. For more
+            # information, see the CreateTask documentation.
+          "a_key": "A String",
+        },
+        "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+            #
+            # If set,
+            # 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.
+            #
+            # Defines routing characteristics specific to App Engine - service, version,
+            # and instance.
+            #
+            # For more information about services, versions, and instances see
+            # [An Overview of App
+            # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+            # [Microservices Architecture on Google App
+            # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+            # [App Engine Standard request
+            # 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).
+          "instance": "A String", # App instance.
+              #
+              # By default, the task is sent to an instance which is available when
+              # the task is attempted.
+              #
+              # Requests can only be sent to a specific instance if
+              # [manual scaling is used in App Engine
+              # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+              # App Engine Flex does not support instances. For more information, see
+              # [App Engine Standard request
+              # 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).
+          "host": "A String", # Output only. The host that the task is sent to.
+              #
+              # 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
+              # service, version,
+              # and instance. Tasks which were created using
+              # the App Engine SDK might have a custom domain name.
+              #
+              # For more information, see
+              # [How Requests are
+              # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+          "version": "A String", # App version.
+              #
+              # By default, the task is sent to the version which is the default
+              # version when the task is attempted.
+              #
+              # For some queues or tasks which were created using the App Engine
+              # Task Queue API, host is not parsable
+              # into service,
+              # version, and
+              # 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
+              # host is not parsable, then
+              # service,
+              # version, and
+              # instance are the empty string.
+          "service": "A String", # App service.
+              #
+              # By default, the task is sent to the service which is the default
+              # service when the task is attempted.
+              #
+              # For some queues or tasks which were created using the App Engine
+              # Task Queue API, host is not parsable
+              # into service,
+              # version, and
+              # 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
+              # host is not parsable, then
+              # service,
+              # version, and
+              # instance are the empty string.
+        },
+        "relativeUri": "A String", # The relative URI.
+            #
+            # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+            # It can contain a path and query string arguments.
+            # If the relative URI is empty, then the root path "/" will be used.
+            # No spaces are allowed, and the maximum length allowed is 2083 characters.
+        "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+            #
+            # The app's request handler for the task's target URL must be able to handle
+            # HTTP requests with this http_method, otherwise the task attempt will fail
+            # with error code 405 (Method Not Allowed). See
+            # [Writing a push task request
+            # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+            # and the documentation for the request handlers in the language your app is
+            # written in e.g.
+            # [Python Request
+            # Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+      },
+      "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+          #
+          # Only dispatch_time will be set.
+          # The other Attempt information is not retained by Cloud Tasks.
+        "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+            #
+            # `schedule_time` will be truncated to the nearest microsecond.
+        "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+            #
+            # If `response_time` is unset, then the task has not been attempted or is
+            # currently running and the `response_status` field is meaningless.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "message": "A 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 field, or localized by the client.
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+        },
+        "responseTime": "A String", # Output only. The time that this attempt response was received.
+            #
+            # `response_time` will be truncated to the nearest microsecond.
+        "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+            #
+            # `dispatch_time` will be truncated to the nearest microsecond.
+      },
+      "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+        "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+            #
+            # `schedule_time` will be truncated to the nearest microsecond.
+        "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+            #
+            # If `response_time` is unset, then the task has not been attempted or is
+            # currently running and the `response_status` field is meaningless.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "message": "A 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 field, or localized by the client.
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+        },
+        "responseTime": "A String", # Output only. The time that this attempt response was received.
+            #
+            # `response_time` will be truncated to the nearest microsecond.
+        "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+            #
+            # `dispatch_time` will be truncated to the nearest microsecond.
+      },
+      "name": "A String", # Optionally caller-specified in CreateTask.
+          #
+          # The task name.
+          #
+          # The task name must have the following format:
+          # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+          #
+          # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+          #    hyphens (-), colons (:), or periods (.).
+          #    For more information, see
+          #    [Identifying
+          #    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+          # * `LOCATION_ID` is the canonical ID for the task's location.
+          #    The list of available locations can be obtained by calling
+          #    ListLocations.
+          #    For more information, see https://cloud.google.com/about/locations/.
+          # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+          #   hyphens (-). The maximum length is 100 characters.
+          # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+          #   hyphens (-), or underscores (_). The maximum length is 500 characters.
+      "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+          #
+          # For App Engine queues, this is when the task will be attempted or retried.
+          #
+          # `schedule_time` will be truncated to the nearest microsecond.
+      "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+          # respond by this deadline then the request is cancelled and the attempt
+          # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+          # task according to the RetryConfig.
+          #
+          # Note that when the request is cancelled, Cloud Tasks will stop listing for
+          # the response, but whether the worker stops processing depends on the
+          # worker. For example, if the worker is stuck, it may not react to cancelled
+          # requests.
+          #
+          # The default and maximum values depend on the type of request:
+          #
+          #
+          # * For 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)
+          #   of the service: 10 minutes for standard apps with automatic scaling, 24
+          #   hours for standard apps with manual and basic scaling, and 60 minutes for
+          #   flex apps. If the request deadline is set, it must be in the interval [15
+          #   seconds, 24 hours 15 seconds]. Regardless of the task's
+          #   `dispatch_deadline`, the app handler will not run for longer than than
+          #   the service's timeout. We recommend setting the `dispatch_deadline` to
+          #   at most a few seconds more than the app handler's timeout. For more
+          #   information see
+          #   [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
+          #
+          # `dispatch_deadline` will be truncated to the nearest millisecond. The
+          # deadline is an approximate deadline.
+      "view": "A String", # Output only. The view specifies which subset of the Task has
+          # been returned.
+      "createTime": "A String", # Output only. The time that the task was created.
+          #
+          # `create_time` will be truncated to the nearest second.
+      "dispatchCount": 42, # Output only. The number of attempts dispatched.
+          #
+          # This count includes attempts which have been dispatched but haven't
+          # received a response.
+      "responseCount": 42, # Output only. The number of attempts which have received a response.
+    },
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A unit of scheduled work.
+    "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+        #
+        # An App Engine task is a task that has AppEngineHttpRequest set.
+        #
+        # The message defines the HTTP request that is sent to an App Engine app when
+        # the task is dispatched.
+        #
+        # Using 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:
+        #
+        # `https://www.googleapis.com/auth/cloud-platform`
+        #
+        # The task will be delivered to the App Engine app which belongs to the same
+        # project as the queue. For more information, see
+        # [How Requests are
+        # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+        # and how routing is affected by
+        # [dispatch
+        # files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
+        # Traffic is encrypted during transport and never leaves Google datacenters.
+        # Because this traffic is carried over a communication mechanism internal to
+        # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
+        # The request to the handler, however, will appear to have used the HTTP
+        # protocol.
+        #
+        # The 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
+        #    is used for all tasks in the queue, no matter what the setting
+        #    is for the
+        #    task-level app_engine_routing.
+        #
+        #
+        # The `url` that the task will be sent to is:
+        #
+        # * `url =` host `+`
+        #   relative_uri
+        #
+        # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
+        # URIs restricted with
+        # [`login:
+        # admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
+        # Because tasks are not run as any user, they cannot be dispatched to URIs
+        # restricted with
+        # [`login:
+        # required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
+        # Task dispatches also do not follow redirects.
+        #
+        # 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 deadline. Failed
+        # tasks will be retried according to the
+        # 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.
+      "body": "A 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 HttpMethod.
+      "headers": { # HTTP request headers.
+          #
+          # This map contains the header field names and values.
+          # Headers can be set when the
+          # task is created.
+          # Repeated headers are not supported but a header value can contain commas.
+          #
+          # Cloud Tasks sets some headers to default values:
+          #
+          # * `User-Agent`: By default, this header is
+          #   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+          #   This header can be modified, but Cloud Tasks will append
+          #   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+          #   modified `User-Agent`.
+          #
+          # If the task has a 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
+          #   setting `Content-Type` to a particular media type when the
+          #   task is created.
+          #   For example, `Content-Type` can be set to `"application/json"`.
+          # * `Content-Length`: This is computed by Cloud Tasks. This value is
+          #   output only.   It cannot be changed.
+          #
+          # The headers below cannot be set or overridden:
+          #
+          # * `Host`
+          # * `X-Google-*`
+          # * `X-AppEngine-*`
+          #
+          # In addition, Cloud Tasks sets some headers when the task is dispatched,
+          # such as headers containing information about the task; see
+          # [request
+          # headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers).
+          # These headers are set only when the task is dispatched, so they are not
+          # 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 Task. For more
+          # information, see the CreateTask documentation.
+        "a_key": "A String",
+      },
+      "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+          #
+          # If set,
+          # 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.
+          #
+          # Defines routing characteristics specific to App Engine - service, version,
+          # and instance.
+          #
+          # For more information about services, versions, and instances see
+          # [An Overview of App
+          # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+          # [Microservices Architecture on Google App
+          # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+          # [App Engine Standard request
+          # 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).
+        "instance": "A String", # App instance.
+            #
+            # By default, the task is sent to an instance which is available when
+            # the task is attempted.
+            #
+            # Requests can only be sent to a specific instance if
+            # [manual scaling is used in App Engine
+            # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+            # App Engine Flex does not support instances. For more information, see
+            # [App Engine Standard request
+            # 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).
+        "host": "A String", # Output only. The host that the task is sent to.
+            #
+            # 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
+            # service, version,
+            # and instance. Tasks which were created using
+            # the App Engine SDK might have a custom domain name.
+            #
+            # For more information, see
+            # [How Requests are
+            # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+        "version": "A String", # App version.
+            #
+            # By default, the task is sent to the version which is the default
+            # version when the task is attempted.
+            #
+            # For some queues or tasks which were created using the App Engine
+            # Task Queue API, host is not parsable
+            # into service,
+            # version, and
+            # 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
+            # host is not parsable, then
+            # service,
+            # version, and
+            # instance are the empty string.
+        "service": "A String", # App service.
+            #
+            # By default, the task is sent to the service which is the default
+            # service when the task is attempted.
+            #
+            # For some queues or tasks which were created using the App Engine
+            # Task Queue API, host is not parsable
+            # into service,
+            # version, and
+            # 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
+            # host is not parsable, then
+            # service,
+            # version, and
+            # instance are the empty string.
+      },
+      "relativeUri": "A String", # The relative URI.
+          #
+          # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+          # It can contain a path and query string arguments.
+          # If the relative URI is empty, then the root path "/" will be used.
+          # No spaces are allowed, and the maximum length allowed is 2083 characters.
+      "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+          #
+          # The app's request handler for the task's target URL must be able to handle
+          # HTTP requests with this http_method, otherwise the task attempt will fail
+          # with error code 405 (Method Not Allowed). See
+          # [Writing a push task request
+          # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+          # and the documentation for the request handlers in the language your app is
+          # written in e.g.
+          # [Python Request
+          # Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+    },
+    "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+        #
+        # Only dispatch_time will be set.
+        # The other Attempt information is not retained by Cloud Tasks.
+      "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+          #
+          # `schedule_time` will be truncated to the nearest microsecond.
+      "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+          #
+          # If `response_time` is unset, then the task has not been attempted or is
+          # currently running and the `response_status` field is meaningless.
+          # different programming environments, including REST APIs and RPC APIs. It is
+          # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+          # three pieces of data: error code, error message, and error details.
+          #
+          # You can find out more about this error model and how to work with it in the
+          # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        "message": "A 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 field, or localized by the client.
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details.  There is a common set of
+            # message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+      },
+      "responseTime": "A String", # Output only. The time that this attempt response was received.
+          #
+          # `response_time` will be truncated to the nearest microsecond.
+      "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+          #
+          # `dispatch_time` will be truncated to the nearest microsecond.
+    },
+    "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+      "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+          #
+          # `schedule_time` will be truncated to the nearest microsecond.
+      "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+          #
+          # If `response_time` is unset, then the task has not been attempted or is
+          # currently running and the `response_status` field is meaningless.
+          # different programming environments, including REST APIs and RPC APIs. It is
+          # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+          # three pieces of data: error code, error message, and error details.
+          #
+          # You can find out more about this error model and how to work with it in the
+          # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        "message": "A 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 field, or localized by the client.
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details.  There is a common set of
+            # message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+      },
+      "responseTime": "A String", # Output only. The time that this attempt response was received.
+          #
+          # `response_time` will be truncated to the nearest microsecond.
+      "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+          #
+          # `dispatch_time` will be truncated to the nearest microsecond.
+    },
+    "name": "A String", # Optionally caller-specified in CreateTask.
+        #
+        # The task name.
+        #
+        # The task name must have the following format:
+        # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #
+        # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+        #    hyphens (-), colons (:), or periods (.).
+        #    For more information, see
+        #    [Identifying
+        #    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+        # * `LOCATION_ID` is the canonical ID for the task's location.
+        #    The list of available locations can be obtained by calling
+        #    ListLocations.
+        #    For more information, see https://cloud.google.com/about/locations/.
+        # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+        #   hyphens (-). The maximum length is 100 characters.
+        # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+        #   hyphens (-), or underscores (_). The maximum length is 500 characters.
+    "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+        #
+        # For App Engine queues, this is when the task will be attempted or retried.
+        #
+        # `schedule_time` will be truncated to the nearest microsecond.
+    "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+        # respond by this deadline then the request is cancelled and the attempt
+        # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+        # task according to the RetryConfig.
+        #
+        # Note that when the request is cancelled, Cloud Tasks will stop listing for
+        # the response, but whether the worker stops processing depends on the
+        # worker. For example, if the worker is stuck, it may not react to cancelled
+        # requests.
+        #
+        # The default and maximum values depend on the type of request:
+        #
+        #
+        # * For 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)
+        #   of the service: 10 minutes for standard apps with automatic scaling, 24
+        #   hours for standard apps with manual and basic scaling, and 60 minutes for
+        #   flex apps. If the request deadline is set, it must be in the interval [15
+        #   seconds, 24 hours 15 seconds]. Regardless of the task's
+        #   `dispatch_deadline`, the app handler will not run for longer than than
+        #   the service's timeout. We recommend setting the `dispatch_deadline` to
+        #   at most a few seconds more than the app handler's timeout. For more
+        #   information see
+        #   [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
+        #
+        # `dispatch_deadline` will be truncated to the nearest millisecond. The
+        # deadline is an approximate deadline.
+    "view": "A String", # Output only. The view specifies which subset of the Task has
+        # been returned.
+    "createTime": "A String", # Output only. The time that the task was created.
+        #
+        # `create_time` will be truncated to the nearest second.
+    "dispatchCount": 42, # Output only. The number of attempts dispatched.
+        #
+        # This count includes attempts which have been dispatched but haven't
+        # received a response.
+    "responseCount": 42, # Output only. The number of attempts which have received a response.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="delete">delete(name, x__xgafv=None)</code>
+  <pre>Deletes a task.
+
+A task can be deleted if it is scheduled or dispatched. A task
+cannot be deleted if it has executed successfully or permanently
+failed.
+
+Args:
+  name: string, Required.
+
+The task name. For example:
+`projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      #
+      #     service Foo {
+      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      #     }
+      #
+      # The JSON representation for `Empty` is empty JSON object `{}`.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="get">get(name, responseView=None, x__xgafv=None)</code>
+  <pre>Gets a task.
+
+Args:
+  name: string, Required.
+
+The task name. For example:
+`projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` (required)
+  responseView: string, The response_view specifies which subset of the Task will be
+returned.
+
+By default response_view is BASIC; not all
+information is retrieved by default because some data, such as
+payloads, might be desirable to return only when needed because
+of its large size or because of the sensitivity of data that it
+contains.
+
+Authorization for FULL requires
+`cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+permission on the Task resource.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A unit of scheduled work.
+    "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+        #
+        # An App Engine task is a task that has AppEngineHttpRequest set.
+        #
+        # The message defines the HTTP request that is sent to an App Engine app when
+        # the task is dispatched.
+        #
+        # Using 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:
+        #
+        # `https://www.googleapis.com/auth/cloud-platform`
+        #
+        # The task will be delivered to the App Engine app which belongs to the same
+        # project as the queue. For more information, see
+        # [How Requests are
+        # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+        # and how routing is affected by
+        # [dispatch
+        # files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
+        # Traffic is encrypted during transport and never leaves Google datacenters.
+        # Because this traffic is carried over a communication mechanism internal to
+        # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
+        # The request to the handler, however, will appear to have used the HTTP
+        # protocol.
+        #
+        # The 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
+        #    is used for all tasks in the queue, no matter what the setting
+        #    is for the
+        #    task-level app_engine_routing.
+        #
+        #
+        # The `url` that the task will be sent to is:
+        #
+        # * `url =` host `+`
+        #   relative_uri
+        #
+        # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
+        # URIs restricted with
+        # [`login:
+        # admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
+        # Because tasks are not run as any user, they cannot be dispatched to URIs
+        # restricted with
+        # [`login:
+        # required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
+        # Task dispatches also do not follow redirects.
+        #
+        # 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 deadline. Failed
+        # tasks will be retried according to the
+        # 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.
+      "body": "A 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 HttpMethod.
+      "headers": { # HTTP request headers.
+          #
+          # This map contains the header field names and values.
+          # Headers can be set when the
+          # task is created.
+          # Repeated headers are not supported but a header value can contain commas.
+          #
+          # Cloud Tasks sets some headers to default values:
+          #
+          # * `User-Agent`: By default, this header is
+          #   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+          #   This header can be modified, but Cloud Tasks will append
+          #   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+          #   modified `User-Agent`.
+          #
+          # If the task has a 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
+          #   setting `Content-Type` to a particular media type when the
+          #   task is created.
+          #   For example, `Content-Type` can be set to `"application/json"`.
+          # * `Content-Length`: This is computed by Cloud Tasks. This value is
+          #   output only.   It cannot be changed.
+          #
+          # The headers below cannot be set or overridden:
+          #
+          # * `Host`
+          # * `X-Google-*`
+          # * `X-AppEngine-*`
+          #
+          # In addition, Cloud Tasks sets some headers when the task is dispatched,
+          # such as headers containing information about the task; see
+          # [request
+          # headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers).
+          # These headers are set only when the task is dispatched, so they are not
+          # 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 Task. For more
+          # information, see the CreateTask documentation.
+        "a_key": "A String",
+      },
+      "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+          #
+          # If set,
+          # 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.
+          #
+          # Defines routing characteristics specific to App Engine - service, version,
+          # and instance.
+          #
+          # For more information about services, versions, and instances see
+          # [An Overview of App
+          # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+          # [Microservices Architecture on Google App
+          # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+          # [App Engine Standard request
+          # 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).
+        "instance": "A String", # App instance.
+            #
+            # By default, the task is sent to an instance which is available when
+            # the task is attempted.
+            #
+            # Requests can only be sent to a specific instance if
+            # [manual scaling is used in App Engine
+            # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+            # App Engine Flex does not support instances. For more information, see
+            # [App Engine Standard request
+            # 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).
+        "host": "A String", # Output only. The host that the task is sent to.
+            #
+            # 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
+            # service, version,
+            # and instance. Tasks which were created using
+            # the App Engine SDK might have a custom domain name.
+            #
+            # For more information, see
+            # [How Requests are
+            # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+        "version": "A String", # App version.
+            #
+            # By default, the task is sent to the version which is the default
+            # version when the task is attempted.
+            #
+            # For some queues or tasks which were created using the App Engine
+            # Task Queue API, host is not parsable
+            # into service,
+            # version, and
+            # 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
+            # host is not parsable, then
+            # service,
+            # version, and
+            # instance are the empty string.
+        "service": "A String", # App service.
+            #
+            # By default, the task is sent to the service which is the default
+            # service when the task is attempted.
+            #
+            # For some queues or tasks which were created using the App Engine
+            # Task Queue API, host is not parsable
+            # into service,
+            # version, and
+            # 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
+            # host is not parsable, then
+            # service,
+            # version, and
+            # instance are the empty string.
+      },
+      "relativeUri": "A String", # The relative URI.
+          #
+          # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+          # It can contain a path and query string arguments.
+          # If the relative URI is empty, then the root path "/" will be used.
+          # No spaces are allowed, and the maximum length allowed is 2083 characters.
+      "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+          #
+          # The app's request handler for the task's target URL must be able to handle
+          # HTTP requests with this http_method, otherwise the task attempt will fail
+          # with error code 405 (Method Not Allowed). See
+          # [Writing a push task request
+          # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+          # and the documentation for the request handlers in the language your app is
+          # written in e.g.
+          # [Python Request
+          # Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+    },
+    "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+        #
+        # Only dispatch_time will be set.
+        # The other Attempt information is not retained by Cloud Tasks.
+      "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+          #
+          # `schedule_time` will be truncated to the nearest microsecond.
+      "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+          #
+          # If `response_time` is unset, then the task has not been attempted or is
+          # currently running and the `response_status` field is meaningless.
+          # different programming environments, including REST APIs and RPC APIs. It is
+          # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+          # three pieces of data: error code, error message, and error details.
+          #
+          # You can find out more about this error model and how to work with it in the
+          # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        "message": "A 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 field, or localized by the client.
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details.  There is a common set of
+            # message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+      },
+      "responseTime": "A String", # Output only. The time that this attempt response was received.
+          #
+          # `response_time` will be truncated to the nearest microsecond.
+      "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+          #
+          # `dispatch_time` will be truncated to the nearest microsecond.
+    },
+    "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+      "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+          #
+          # `schedule_time` will be truncated to the nearest microsecond.
+      "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+          #
+          # If `response_time` is unset, then the task has not been attempted or is
+          # currently running and the `response_status` field is meaningless.
+          # different programming environments, including REST APIs and RPC APIs. It is
+          # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+          # three pieces of data: error code, error message, and error details.
+          #
+          # You can find out more about this error model and how to work with it in the
+          # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        "message": "A 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 field, or localized by the client.
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details.  There is a common set of
+            # message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+      },
+      "responseTime": "A String", # Output only. The time that this attempt response was received.
+          #
+          # `response_time` will be truncated to the nearest microsecond.
+      "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+          #
+          # `dispatch_time` will be truncated to the nearest microsecond.
+    },
+    "name": "A String", # Optionally caller-specified in CreateTask.
+        #
+        # The task name.
+        #
+        # The task name must have the following format:
+        # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #
+        # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+        #    hyphens (-), colons (:), or periods (.).
+        #    For more information, see
+        #    [Identifying
+        #    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+        # * `LOCATION_ID` is the canonical ID for the task's location.
+        #    The list of available locations can be obtained by calling
+        #    ListLocations.
+        #    For more information, see https://cloud.google.com/about/locations/.
+        # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+        #   hyphens (-). The maximum length is 100 characters.
+        # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+        #   hyphens (-), or underscores (_). The maximum length is 500 characters.
+    "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+        #
+        # For App Engine queues, this is when the task will be attempted or retried.
+        #
+        # `schedule_time` will be truncated to the nearest microsecond.
+    "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+        # respond by this deadline then the request is cancelled and the attempt
+        # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+        # task according to the RetryConfig.
+        #
+        # Note that when the request is cancelled, Cloud Tasks will stop listing for
+        # the response, but whether the worker stops processing depends on the
+        # worker. For example, if the worker is stuck, it may not react to cancelled
+        # requests.
+        #
+        # The default and maximum values depend on the type of request:
+        #
+        #
+        # * For 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)
+        #   of the service: 10 minutes for standard apps with automatic scaling, 24
+        #   hours for standard apps with manual and basic scaling, and 60 minutes for
+        #   flex apps. If the request deadline is set, it must be in the interval [15
+        #   seconds, 24 hours 15 seconds]. Regardless of the task's
+        #   `dispatch_deadline`, the app handler will not run for longer than than
+        #   the service's timeout. We recommend setting the `dispatch_deadline` to
+        #   at most a few seconds more than the app handler's timeout. For more
+        #   information see
+        #   [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
+        #
+        # `dispatch_deadline` will be truncated to the nearest millisecond. The
+        # deadline is an approximate deadline.
+    "view": "A String", # Output only. The view specifies which subset of the Task has
+        # been returned.
+    "createTime": "A String", # Output only. The time that the task was created.
+        #
+        # `create_time` will be truncated to the nearest second.
+    "dispatchCount": 42, # Output only. The number of attempts dispatched.
+        #
+        # This count includes attempts which have been dispatched but haven't
+        # received a response.
+    "responseCount": 42, # Output only. The number of attempts which have received a response.
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(parent, responseView=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
+  <pre>Lists the tasks in a queue.
+
+By default, only the BASIC view is retrieved
+due to performance considerations;
+response_view controls the
+subset of information which is returned.
+
+The tasks may be returned in any order. The ordering may change at any
+time.
+
+Args:
+  parent: string, Required.
+
+The queue name. For example:
+`projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` (required)
+  responseView: string, The response_view specifies which subset of the Task will be
+returned.
+
+By default response_view is BASIC; not all
+information is retrieved by default because some data, such as
+payloads, might be desirable to return only when needed because
+of its large size or because of the sensitivity of data that it
+contains.
+
+Authorization for FULL requires
+`cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+permission on the Task resource.
+  pageSize: integer, Maximum page size.
+
+Fewer tasks than requested might be returned, even if more tasks exist; use
+next_page_token in the response to
+determine if more tasks exist.
+
+The maximum page size is 1000. If unspecified, the page size will be the
+maximum.
+  pageToken: string, A token identifying the page of results to return.
+
+To request the first page results, page_token must be empty. To
+request the next page of results, page_token must be the value of
+next_page_token returned
+from the previous call to ListTasks
+method.
+
+The page token is valid for only 2 hours.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for listing tasks using ListTasks.
+    "nextPageToken": "A String", # A token to retrieve next page of results.
+        #
+        # To return the next page of results, call
+        # ListTasks with this value as the
+        # page_token.
+        #
+        # If the next_page_token is empty, there are no more results.
+    "tasks": [ # The list of tasks.
+      { # A unit of scheduled work.
+        "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+            #
+            # An App Engine task is a task that has AppEngineHttpRequest set.
+            #
+            # The message defines the HTTP request that is sent to an App Engine app when
+            # the task is dispatched.
+            #
+            # Using 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:
+            #
+            # `https://www.googleapis.com/auth/cloud-platform`
+            #
+            # The task will be delivered to the App Engine app which belongs to the same
+            # project as the queue. For more information, see
+            # [How Requests are
+            # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+            # and how routing is affected by
+            # [dispatch
+            # files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
+            # Traffic is encrypted during transport and never leaves Google datacenters.
+            # Because this traffic is carried over a communication mechanism internal to
+            # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
+            # The request to the handler, however, will appear to have used the HTTP
+            # protocol.
+            #
+            # The 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
+            #    is used for all tasks in the queue, no matter what the setting
+            #    is for the
+            #    task-level app_engine_routing.
+            #
+            #
+            # The `url` that the task will be sent to is:
+            #
+            # * `url =` host `+`
+            #   relative_uri
+            #
+            # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
+            # URIs restricted with
+            # [`login:
+            # admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
+            # Because tasks are not run as any user, they cannot be dispatched to URIs
+            # restricted with
+            # [`login:
+            # required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
+            # Task dispatches also do not follow redirects.
+            #
+            # 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 deadline. Failed
+            # tasks will be retried according to the
+            # 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.
+          "body": "A 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 HttpMethod.
+          "headers": { # HTTP request headers.
+              #
+              # This map contains the header field names and values.
+              # Headers can be set when the
+              # task is created.
+              # Repeated headers are not supported but a header value can contain commas.
+              #
+              # Cloud Tasks sets some headers to default values:
+              #
+              # * `User-Agent`: By default, this header is
+              #   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+              #   This header can be modified, but Cloud Tasks will append
+              #   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+              #   modified `User-Agent`.
+              #
+              # If the task has a 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
+              #   setting `Content-Type` to a particular media type when the
+              #   task is created.
+              #   For example, `Content-Type` can be set to `"application/json"`.
+              # * `Content-Length`: This is computed by Cloud Tasks. This value is
+              #   output only.   It cannot be changed.
+              #
+              # The headers below cannot be set or overridden:
+              #
+              # * `Host`
+              # * `X-Google-*`
+              # * `X-AppEngine-*`
+              #
+              # In addition, Cloud Tasks sets some headers when the task is dispatched,
+              # such as headers containing information about the task; see
+              # [request
+              # headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers).
+              # These headers are set only when the task is dispatched, so they are not
+              # 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 Task. For more
+              # information, see the CreateTask documentation.
+            "a_key": "A String",
+          },
+          "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+              #
+              # If set,
+              # 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.
+              #
+              # Defines routing characteristics specific to App Engine - service, version,
+              # and instance.
+              #
+              # For more information about services, versions, and instances see
+              # [An Overview of App
+              # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+              # [Microservices Architecture on Google App
+              # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+              # [App Engine Standard request
+              # 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).
+            "instance": "A String", # App instance.
+                #
+                # By default, the task is sent to an instance which is available when
+                # the task is attempted.
+                #
+                # Requests can only be sent to a specific instance if
+                # [manual scaling is used in App Engine
+                # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+                # App Engine Flex does not support instances. For more information, see
+                # [App Engine Standard request
+                # 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).
+            "host": "A String", # Output only. The host that the task is sent to.
+                #
+                # 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
+                # service, version,
+                # and instance. Tasks which were created using
+                # the App Engine SDK might have a custom domain name.
+                #
+                # For more information, see
+                # [How Requests are
+                # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+            "version": "A String", # App version.
+                #
+                # By default, the task is sent to the version which is the default
+                # version when the task is attempted.
+                #
+                # For some queues or tasks which were created using the App Engine
+                # Task Queue API, host is not parsable
+                # into service,
+                # version, and
+                # 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
+                # host is not parsable, then
+                # service,
+                # version, and
+                # instance are the empty string.
+            "service": "A String", # App service.
+                #
+                # By default, the task is sent to the service which is the default
+                # service when the task is attempted.
+                #
+                # For some queues or tasks which were created using the App Engine
+                # Task Queue API, host is not parsable
+                # into service,
+                # version, and
+                # 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
+                # host is not parsable, then
+                # service,
+                # version, and
+                # instance are the empty string.
+          },
+          "relativeUri": "A String", # The relative URI.
+              #
+              # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+              # It can contain a path and query string arguments.
+              # If the relative URI is empty, then the root path "/" will be used.
+              # No spaces are allowed, and the maximum length allowed is 2083 characters.
+          "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+              #
+              # The app's request handler for the task's target URL must be able to handle
+              # HTTP requests with this http_method, otherwise the task attempt will fail
+              # with error code 405 (Method Not Allowed). See
+              # [Writing a push task request
+              # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+              # and the documentation for the request handlers in the language your app is
+              # written in e.g.
+              # [Python Request
+              # Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+        },
+        "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+            #
+            # Only dispatch_time will be set.
+            # The other Attempt information is not retained by Cloud Tasks.
+          "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+              #
+              # `schedule_time` will be truncated to the nearest microsecond.
+          "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+              #
+              # If `response_time` is unset, then the task has not been attempted or is
+              # currently running and the `response_status` field is meaningless.
+              # different programming environments, including REST APIs and RPC APIs. It is
+              # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+              # three pieces of data: error code, error message, and error details.
+              #
+              # You can find out more about this error model and how to work with it in the
+              # [API Design Guide](https://cloud.google.com/apis/design/errors).
+            "message": "A 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 field, or localized by the client.
+            "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+            "details": [ # A list of messages that carry the error details.  There is a common set of
+                # message types for APIs to use.
+              {
+                "a_key": "", # Properties of the object. Contains field @type with type URL.
+              },
+            ],
+          },
+          "responseTime": "A String", # Output only. The time that this attempt response was received.
+              #
+              # `response_time` will be truncated to the nearest microsecond.
+          "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+              #
+              # `dispatch_time` will be truncated to the nearest microsecond.
+        },
+        "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+          "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+              #
+              # `schedule_time` will be truncated to the nearest microsecond.
+          "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+              #
+              # If `response_time` is unset, then the task has not been attempted or is
+              # currently running and the `response_status` field is meaningless.
+              # different programming environments, including REST APIs and RPC APIs. It is
+              # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+              # three pieces of data: error code, error message, and error details.
+              #
+              # You can find out more about this error model and how to work with it in the
+              # [API Design Guide](https://cloud.google.com/apis/design/errors).
+            "message": "A 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 field, or localized by the client.
+            "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+            "details": [ # A list of messages that carry the error details.  There is a common set of
+                # message types for APIs to use.
+              {
+                "a_key": "", # Properties of the object. Contains field @type with type URL.
+              },
+            ],
+          },
+          "responseTime": "A String", # Output only. The time that this attempt response was received.
+              #
+              # `response_time` will be truncated to the nearest microsecond.
+          "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+              #
+              # `dispatch_time` will be truncated to the nearest microsecond.
+        },
+        "name": "A String", # Optionally caller-specified in CreateTask.
+            #
+            # The task name.
+            #
+            # The task name must have the following format:
+            # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+            #
+            # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+            #    hyphens (-), colons (:), or periods (.).
+            #    For more information, see
+            #    [Identifying
+            #    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+            # * `LOCATION_ID` is the canonical ID for the task's location.
+            #    The list of available locations can be obtained by calling
+            #    ListLocations.
+            #    For more information, see https://cloud.google.com/about/locations/.
+            # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+            #   hyphens (-). The maximum length is 100 characters.
+            # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+            #   hyphens (-), or underscores (_). The maximum length is 500 characters.
+        "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+            #
+            # For App Engine queues, this is when the task will be attempted or retried.
+            #
+            # `schedule_time` will be truncated to the nearest microsecond.
+        "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+            # respond by this deadline then the request is cancelled and the attempt
+            # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+            # task according to the RetryConfig.
+            #
+            # Note that when the request is cancelled, Cloud Tasks will stop listing for
+            # the response, but whether the worker stops processing depends on the
+            # worker. For example, if the worker is stuck, it may not react to cancelled
+            # requests.
+            #
+            # The default and maximum values depend on the type of request:
+            #
+            #
+            # * For 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)
+            #   of the service: 10 minutes for standard apps with automatic scaling, 24
+            #   hours for standard apps with manual and basic scaling, and 60 minutes for
+            #   flex apps. If the request deadline is set, it must be in the interval [15
+            #   seconds, 24 hours 15 seconds]. Regardless of the task's
+            #   `dispatch_deadline`, the app handler will not run for longer than than
+            #   the service's timeout. We recommend setting the `dispatch_deadline` to
+            #   at most a few seconds more than the app handler's timeout. For more
+            #   information see
+            #   [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
+            #
+            # `dispatch_deadline` will be truncated to the nearest millisecond. The
+            # deadline is an approximate deadline.
+        "view": "A String", # Output only. The view specifies which subset of the Task has
+            # been returned.
+        "createTime": "A String", # Output only. The time that the task was created.
+            #
+            # `create_time` will be truncated to the nearest second.
+        "dispatchCount": 42, # Output only. The number of attempts dispatched.
+            #
+            # This count includes attempts which have been dispatched but haven't
+            # received a response.
+        "responseCount": 42, # Output only. The number of attempts which have received a response.
+      },
+    ],
+  }</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+  <pre>Retrieves the next page of results.
+
+Args:
+  previous_request: The request for the previous page. (required)
+  previous_response: The response from the request for the previous page. (required)
+
+Returns:
+  A request object that you can call 'execute()' on to request the next
+  page. Returns None if there are no more items in the collection.
+    </pre>
+</div>
+
+<div class="method">
+    <code class="details" id="run">run(name, body, x__xgafv=None)</code>
+  <pre>Forces a task to run now.
+
+When this method is called, Cloud Tasks will dispatch the task, even if
+the task is already running, the queue has reached its RateLimits or
+is PAUSED.
+
+This command is meant to be used for manual debugging. For
+example, RunTask can be used to retry a failed
+task after a fix has been made or to manually force a task to be
+dispatched now.
+
+The dispatched task is returned. That is, the task that is returned
+contains the status after the task is dispatched but
+before the task is received by its target.
+
+If Cloud Tasks receives a successful response from the task's
+target, then the task will be deleted; otherwise the task's
+schedule_time will be reset to the time that
+RunTask was called plus the retry delay specified
+in the queue's RetryConfig.
+
+RunTask returns
+NOT_FOUND when it is called on a
+task that has already succeeded or permanently failed.
+
+Args:
+  name: string, Required.
+
+The task name. For example:
+`projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` (required)
+  body: object, The request body. (required)
+    The object takes the form of:
+
+{ # Request message for forcing a task to run now using
+      # RunTask.
+    "responseView": "A String", # The response_view specifies which subset of the Task will be
+        # returned.
+        # 
+        # By default response_view is BASIC; not all
+        # information is retrieved by default because some data, such as
+        # payloads, might be desirable to return only when needed because
+        # of its large size or because of the sensitivity of data that it
+        # contains.
+        # 
+        # Authorization for FULL requires
+        # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+        # permission on the Task resource.
+  }
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A unit of scheduled work.
+    "appEngineHttpRequest": { # App Engine HTTP request. # HTTP request that is sent to the App Engine app handler.
+        #
+        # An App Engine task is a task that has AppEngineHttpRequest set.
+        #
+        # The message defines the HTTP request that is sent to an App Engine app when
+        # the task is dispatched.
+        #
+        # Using 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:
+        #
+        # `https://www.googleapis.com/auth/cloud-platform`
+        #
+        # The task will be delivered to the App Engine app which belongs to the same
+        # project as the queue. For more information, see
+        # [How Requests are
+        # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+        # and how routing is affected by
+        # [dispatch
+        # files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
+        # Traffic is encrypted during transport and never leaves Google datacenters.
+        # Because this traffic is carried over a communication mechanism internal to
+        # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
+        # The request to the handler, however, will appear to have used the HTTP
+        # protocol.
+        #
+        # The 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
+        #    is used for all tasks in the queue, no matter what the setting
+        #    is for the
+        #    task-level app_engine_routing.
+        #
+        #
+        # The `url` that the task will be sent to is:
+        #
+        # * `url =` host `+`
+        #   relative_uri
+        #
+        # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
+        # URIs restricted with
+        # [`login:
+        # admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
+        # Because tasks are not run as any user, they cannot be dispatched to URIs
+        # restricted with
+        # [`login:
+        # required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
+        # Task dispatches also do not follow redirects.
+        #
+        # 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 deadline. Failed
+        # tasks will be retried according to the
+        # 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.
+      "body": "A 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 HttpMethod.
+      "headers": { # HTTP request headers.
+          #
+          # This map contains the header field names and values.
+          # Headers can be set when the
+          # task is created.
+          # Repeated headers are not supported but a header value can contain commas.
+          #
+          # Cloud Tasks sets some headers to default values:
+          #
+          # * `User-Agent`: By default, this header is
+          #   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+          #   This header can be modified, but Cloud Tasks will append
+          #   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+          #   modified `User-Agent`.
+          #
+          # If the task has a 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
+          #   setting `Content-Type` to a particular media type when the
+          #   task is created.
+          #   For example, `Content-Type` can be set to `"application/json"`.
+          # * `Content-Length`: This is computed by Cloud Tasks. This value is
+          #   output only.   It cannot be changed.
+          #
+          # The headers below cannot be set or overridden:
+          #
+          # * `Host`
+          # * `X-Google-*`
+          # * `X-AppEngine-*`
+          #
+          # In addition, Cloud Tasks sets some headers when the task is dispatched,
+          # such as headers containing information about the task; see
+          # [request
+          # headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers).
+          # These headers are set only when the task is dispatched, so they are not
+          # 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 Task. For more
+          # information, see the CreateTask documentation.
+        "a_key": "A String",
+      },
+      "appEngineRouting": { # App Engine Routing. # Task-level setting for App Engine routing.
+          #
+          # If set,
+          # 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.
+          #
+          # Defines routing characteristics specific to App Engine - service, version,
+          # and instance.
+          #
+          # For more information about services, versions, and instances see
+          # [An Overview of App
+          # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+          # [Microservices Architecture on Google App
+          # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+          # [App Engine Standard request
+          # 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).
+        "instance": "A String", # App instance.
+            #
+            # By default, the task is sent to an instance which is available when
+            # the task is attempted.
+            #
+            # Requests can only be sent to a specific instance if
+            # [manual scaling is used in App Engine
+            # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+            # App Engine Flex does not support instances. For more information, see
+            # [App Engine Standard request
+            # 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).
+        "host": "A String", # Output only. The host that the task is sent to.
+            #
+            # 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
+            # service, version,
+            # and instance. Tasks which were created using
+            # the App Engine SDK might have a custom domain name.
+            #
+            # For more information, see
+            # [How Requests are
+            # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+        "version": "A String", # App version.
+            #
+            # By default, the task is sent to the version which is the default
+            # version when the task is attempted.
+            #
+            # For some queues or tasks which were created using the App Engine
+            # Task Queue API, host is not parsable
+            # into service,
+            # version, and
+            # 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
+            # host is not parsable, then
+            # service,
+            # version, and
+            # instance are the empty string.
+        "service": "A String", # App service.
+            #
+            # By default, the task is sent to the service which is the default
+            # service when the task is attempted.
+            #
+            # For some queues or tasks which were created using the App Engine
+            # Task Queue API, host is not parsable
+            # into service,
+            # version, and
+            # 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
+            # host is not parsable, then
+            # service,
+            # version, and
+            # instance are the empty string.
+      },
+      "relativeUri": "A String", # The relative URI.
+          #
+          # The relative URI must begin with "/" and must be a valid HTTP relative URI.
+          # It can contain a path and query string arguments.
+          # If the relative URI is empty, then the root path "/" will be used.
+          # No spaces are allowed, and the maximum length allowed is 2083 characters.
+      "httpMethod": "A String", # The HTTP method to use for the request. The default is POST.
+          #
+          # The app's request handler for the task's target URL must be able to handle
+          # HTTP requests with this http_method, otherwise the task attempt will fail
+          # with error code 405 (Method Not Allowed). See
+          # [Writing a push task request
+          # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+          # and the documentation for the request handlers in the language your app is
+          # written in e.g.
+          # [Python Request
+          # Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+    },
+    "firstAttempt": { # The status of a task attempt. # Output only. The status of the task's first attempt.
+        #
+        # Only dispatch_time will be set.
+        # The other Attempt information is not retained by Cloud Tasks.
+      "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+          #
+          # `schedule_time` will be truncated to the nearest microsecond.
+      "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+          #
+          # If `response_time` is unset, then the task has not been attempted or is
+          # currently running and the `response_status` field is meaningless.
+          # different programming environments, including REST APIs and RPC APIs. It is
+          # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+          # three pieces of data: error code, error message, and error details.
+          #
+          # You can find out more about this error model and how to work with it in the
+          # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        "message": "A 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 field, or localized by the client.
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details.  There is a common set of
+            # message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+      },
+      "responseTime": "A String", # Output only. The time that this attempt response was received.
+          #
+          # `response_time` will be truncated to the nearest microsecond.
+      "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+          #
+          # `dispatch_time` will be truncated to the nearest microsecond.
+    },
+    "lastAttempt": { # The status of a task attempt. # Output only. The status of the task's last attempt.
+      "scheduleTime": "A String", # Output only. The time that this attempt was scheduled.
+          #
+          # `schedule_time` will be truncated to the nearest microsecond.
+      "responseStatus": { # The `Status` type defines a logical error model that is suitable for # Output only. The response from the worker for this attempt.
+          #
+          # If `response_time` is unset, then the task has not been attempted or is
+          # currently running and the `response_status` field is meaningless.
+          # different programming environments, including REST APIs and RPC APIs. It is
+          # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+          # three pieces of data: error code, error message, and error details.
+          #
+          # You can find out more about this error model and how to work with it in the
+          # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        "message": "A 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 field, or localized by the client.
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details.  There is a common set of
+            # message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+      },
+      "responseTime": "A String", # Output only. The time that this attempt response was received.
+          #
+          # `response_time` will be truncated to the nearest microsecond.
+      "dispatchTime": "A String", # Output only. The time that this attempt was dispatched.
+          #
+          # `dispatch_time` will be truncated to the nearest microsecond.
+    },
+    "name": "A String", # Optionally caller-specified in CreateTask.
+        #
+        # The task name.
+        #
+        # The task name must have the following format:
+        # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #
+        # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+        #    hyphens (-), colons (:), or periods (.).
+        #    For more information, see
+        #    [Identifying
+        #    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+        # * `LOCATION_ID` is the canonical ID for the task's location.
+        #    The list of available locations can be obtained by calling
+        #    ListLocations.
+        #    For more information, see https://cloud.google.com/about/locations/.
+        # * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+        #   hyphens (-). The maximum length is 100 characters.
+        # * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+        #   hyphens (-), or underscores (_). The maximum length is 500 characters.
+    "scheduleTime": "A String", # The time when the task is scheduled to be attempted.
+        #
+        # For App Engine queues, this is when the task will be attempted or retried.
+        #
+        # `schedule_time` will be truncated to the nearest microsecond.
+    "dispatchDeadline": "A String", # The deadline for requests sent to the worker. If the worker does not
+        # respond by this deadline then the request is cancelled and the attempt
+        # is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+        # task according to the RetryConfig.
+        #
+        # Note that when the request is cancelled, Cloud Tasks will stop listing for
+        # the response, but whether the worker stops processing depends on the
+        # worker. For example, if the worker is stuck, it may not react to cancelled
+        # requests.
+        #
+        # The default and maximum values depend on the type of request:
+        #
+        #
+        # * For 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)
+        #   of the service: 10 minutes for standard apps with automatic scaling, 24
+        #   hours for standard apps with manual and basic scaling, and 60 minutes for
+        #   flex apps. If the request deadline is set, it must be in the interval [15
+        #   seconds, 24 hours 15 seconds]. Regardless of the task's
+        #   `dispatch_deadline`, the app handler will not run for longer than than
+        #   the service's timeout. We recommend setting the `dispatch_deadline` to
+        #   at most a few seconds more than the app handler's timeout. For more
+        #   information see
+        #   [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
+        #
+        # `dispatch_deadline` will be truncated to the nearest millisecond. The
+        # deadline is an approximate deadline.
+    "view": "A String", # Output only. The view specifies which subset of the Task has
+        # been returned.
+    "createTime": "A String", # Output only. The time that the task was created.
+        #
+        # `create_time` will be truncated to the nearest second.
+    "dispatchCount": 42, # Output only. The number of attempts dispatched.
+        #
+        # This count includes attempts which have been dispatched but haven't
+        # received a response.
+    "responseCount": 42, # Output only. The number of attempts which have received a response.
+  }</pre>
+</div>
+
+</body></html>
\ No newline at end of file