Method: projects.locations.queues.tasks.buffer

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/v2beta3/{queue=projects/*/locations/*/queues/*}/tasks/{taskId}:buffer

The URL uses gRPC Transcoding syntax.

Path parameters

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, a random task ID is assigned to the task.

Request body

The request body contains data with the following structure:

JSON representation
{
 "body": {
 object (HttpBody )
 }
}
Fields
body

object (HttpBody )

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 (Task )
 }
}
Fields
task

object (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.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026年07月30日 UTC.