Creates and buffers a new task without the need to explicitly define a Task message. The queue must have HTTP target
. To create the task with a custom ID, use the following format and set TASK_ID to your desired ID: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID:buffer To create the task with an automatically generated ID, use the following format: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks:buffer.
HTTP request
POST https://cloudtasks.googleapis.com/v2/{queue=projects/*/locations/*/queues/*}/tasks/{taskId}:buffer
The URL uses gRPC Transcoding syntax.
Path parameters
queue
string
Required. The parent queue name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
The queue must already exist.
Authorization requires the following IAM
permission on the specified resource queue
:
-
cloudtasks.tasks.create
taskId
string
Optional. Task ID for the task being created. If not provided, Cloud Tasks generates an ID for the task.
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{
"body"
:
{
object (
|
| Fields | |
|---|---|
body
|
Optional. Body of the HTTP request. The body can take any generic value. The value is written to the [HttpRequest][payload] of the [Task]. |
Response body
Response message for tasks.buffer
.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"task"
:
{
object (
|
| Fields | |
|---|---|
task
|
The created task. |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/cloud-platform -
https://www.googleapis.com/auth/cloud-tasks
For more information, see the Authentication Overview .
