| ★ wanayoo — archive 1999 https://developers.google.com/appengine/docs/python/taskqueue/rest | Nouvelle recherche | Portail wanayoo |
The following table summarizes the REST methods exposed by the Google Task Queue API.
| Resource | Method | REST URI relative to https://www.googleapis.com/taskqueue/v1beta2 |
|---|---|---|
| TaskQueue | Get | GET .../projects/projectname/taskqueues/queuename |
| Task | List | GET .../projects/projectname/taskqueues/queuename/tasks |
| Get | GET .../projects/projectname/taskqueues/queuename/tasks/taskname |
|
| Delete | DELETE .../projects/projectname/taskqueues/queuename/tasks/taskname |
|
| Lease | POST .../projects/projectname/taskqueues/queuename/lease |
|
| Insert | POST .../projects/projectname/taskqueues/queuename/insert/taskname |
|
| Update | POST .../projects/projectname/taskqueues/queuename/update/taskname |
A TaskQueue resource represents a queue created by an App Engine application. You create TaskQueue resources within a project namespace defined by your App Engine App ID. You can use the TaskQueue resource to get information about a queue. By default, a user has no rights on a TaskQueue unless they are explicitly granted rights in queues.yaml.
Each project can hold an unlimited number of TaskQueue resources. It is currently not possible to create, modify, or delete queues using the REST API.
{
"kind": "taskqueues#taskqueue",
"id": string,
"maxLeases": number,
"stats": {
"totalTasks": number,
"oldestTask": number,
"leasedLastMinute": number,
"leasedLastHour": number,
}
}
| Property Name | Value | Description | Mutable |
|---|---|---|---|
kind |
string |
Identifies the resource type. | No |
id |
string |
The name of the task queue. This name must be unique among all queue names within this project. See the naming restrictions. | Required and mutable on insert only |
maxLeases |
number |
The number of times a client can lease a specific task before it will be automatically dropped from the queue. If not specified, all tasks will be available for indefinite retries. In practice, you should set this value to a reasonably small value so that a difficult task does not block the whole queue. | Yes |
stats |
object |
An object that holds statistics for this queue. | No |
stats.totalTasks |
number |
The total number of tasks in the queue. | No |
stats.oldestTask |
number |
The timestamp of the oldest task in the queue, in seconds since the epoch. | No |
stats.leasedLastMinute |
number |
The number of tasks leased in the last minute. | No |
stats.leasedLastHour |
number |
The number of tasks leased in the last hour. | No |
Returns information about a specified TaskQueue resource.
Authentication is required. The developer's email address must be specified as a user_email in the acl element of queue.yaml.
Request (REST)
GET https://www.googleapis.com/taskqueue/v1beta2/projects/{PROJECT_NAME}/taskqueues/{TASKQUEUE_NAME}?{QUERY_PARAMS}
Query Parameters:
| Name | Type | Description | Required |
|---|---|---|---|
| getStats | boolean | Whether to populate the stats field of the returned resource. Default value is false. | False |
Response
Returns a TaskQueue resource.
A Task resource represents a single task to be handled by a client. A task is defined by an arbitrary blob of data that should be understood by the client.
The standard usage is that a client calls TaskQueue.lease to get the next available task, performs that task, and then calls TaskQueue.delete on that task before the lease expires. If the client cannot finish the task before the lease expires, and has a reasonable chance of completing the task, it should call TaskQueue.lease again before the lease expires. If the client completes the task after the lease has expired, it still needs to delete the task. Tasks should be designed to be idempotent to avoid errors if multiple clients complete the same task.
{
"kind": "taskqueues#task",
"id": string,
"queueName": string,
"payloadBase64": string,
"enqueueTimestamp": number,
"leaseTimestamp": number
"tag": string
}
| Property Name | Value | Description | Mutable |
|---|---|---|---|
kind |
string |
The type of resource. | No |
id |
string |
The name of the task, which can be specified when inserting the task from App Engine. If not specified, a random name will be generated. We strongly recommend against specifying a task name yourself. | Optional, used on insert only |
queueName |
string |
Name of the TaskQueue that holds this task. | No |
payloadBase64 |
string |
The bytes describing the task to perform. This is a base64-encoded string. The client is expected to understand the payload format. The maximum size is 1MB. This value will be empty in calls to Tasks.list. | No |
enqueueTimestamp |
number |
The time when the task was enqueued, in seconds since the epoch. | No |
leaseTimestamp |
number |
The time at which the task lease will expire, in seconds since the epoch. If this task has never been leased, it will be zero. If this this task has been previously leased and the lease has expired, this value will be < Now(). | No |
tag |
string |
The tag for this task. Tagging tasks allows you to group them for processing using Lease.group_by_tag. |
No |
Lists all non-deleted Tasks in a TaskQueue, whether or not they are currently leased, up to a maximum of 100. The retrieved tasks will not include the task payload. Deleted tasks (whose names remain unavailable for up to seven days) do not appear in this list. Tasks are returned in the same order they are stored on the queue.
Authentication is required. The developer's email address must be specified as a user_email in the acl element of queue.yaml.
Request (REST)
GET https://www.googleapis.com/taskqueue/v1beta2/projects/{PROJECT_NAME}/taskqueues/{TASKQUEUE_NAME}/tasks
Response (JSON)
An array of tasks, as shown here:
{
"kind": "taskqueues#tasks",
"items": [
Task resource array
]
}
Gets the named task in a TaskQueue. This does not lease the task. You shouldn't need to call this method in your typical work flow.
Authentication is required. The developer's email address must be specified as a user_email in the acl element of queue.yaml.
Request (REST)
GET https://www.googleapis.com/taskqueue/v1beta2/projects/{PROJECT_NAME}/taskqueues/{TASKQUEUE_NAME}/tasks/{TASK_NAME}
Response
The requested Task resource.
Deletes a task from a TaskQueue. You should only call this method if you own the lease for a task and have completed it, unless you have some other compelling reason to remove a task from the queue.
Authentication is required. The developer's email address must be specified as a user_email in the acl element of queue.yaml.
Request (REST)
DELETE https://www.googleapis.com/taskqueue/v1beta2/projects/{PROJECT_NAME}/taskqueues/{TASKQUEUE_NAME}/tasks/{TASK_NAME}
Response
An HTTP 200 response if successful, or an HTTP error code on failure.
Acquires a lease on the topmost N unowned tasks in the specified queue.
Authentication is required. The developer's email address must be specified as a user_email in the acl element of queue.yaml.
Request (REST)
POST https://www.googleapis.com/taskqueue/v1beta2/projects/{PROJECT_NAME}/taskqueues/{TASKQUEUE_NAME}/tasks/lease?{QUERY_PARAMS}
Query Parameters:
| Name | Type | Description | Required |
|---|---|---|---|
| leaseSecs | integer | How long to lease this task, in seconds. | True |
| numTasks | integer | How many tasks to lease. | True |
| tag | string | If specified, a tag allowing you to lease tasks by that tag. Throws an error if groupByTag is False or unspecified. |
True |
| groupByTag | string | If specified with a tag, returns tasks with the same tag. If False, returns the tasks from a single tag by the oldest ETA. | True |
Response
An array of leased Task resources, as shown here:
{
"kind": "taskqueues#tasks",
"items": [
Task resource array
]
}
Insert a task into an existing queue.
Authentication is required. The developer's email address must be specified as a writer_email in the acl element of queue.yaml.
Request (REST)
POST https://www.googleapis.com/taskqueue/v1beta2/projects/{PROJECT_NAME}/taskqueues/{TASKQUEUE_NAME}/tasks/insert
Response
An array of leased Task resources, as shown here:
{
"kind": "taskqueues#tasks",
"items": [
Task resource array
]
}
Update the duration of a task lease.
Authentication is required. The developer's email address must be specified as a user_email in the acl element of queue.yaml.
Request (REST)
POST https://www.googleapis.com/taskqueue/v1beta2/projects/{PROJECT_NAME}/taskqueues/{TASKQUEUE_NAME}/tasks/update/{TASK_NAME}?{QUERY_PARAMS}
Query Parameters:
| Name | Type | Description | Required |
|---|---|---|---|
| leaseTimestamp | datetime | A timestamp indicating the number of seconds since the task was leased. | True |
| newLeaseSecs | integer | The updated lease for that task in seconds. | True |
Response
An array of leased Task resources, as shown here:
{
"kind": "taskqueues#tasks",
"items": [
Task resource array
]
}