Method: projects.locations.queues.get

Gets a queue.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The resource name of the queue. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID

Authorization requires the following IAM permission on the specified resource name:

  • cloudtasks.queues.get

Query parameters


string (FieldMask format)

Optional. Read mask is used for a more granular control over what the API returns. If the mask is not present all fields will be returned except [Queue.stats]. [Queue.stats] will be returned only if it was explicitly specified in the mask.

A comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Queue.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.