The resource that owns the locations collection, if applicable.
Query parameters
Parameters
filter
string
A filter to narrow down results to a preferred subset. The filtering language accepts strings like"displayName=tokyo", and is documented in more detail inAIP-160.
pageSize
integer
The maximum number of results to return. If not set, the service selects a default.
pageToken
string
A page token received from thenextPageTokenfield in the response. Send that page token to receive the subsequent page.
extraLocationTypes[]
string
Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-21 UTC."],[[["\u003cp\u003eThis service endpoint lists supported locations and uses a \u003ccode\u003eGET\u003c/code\u003e request with a specific URL structure that includes path and query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires no body, while the response will contain a list of locations, which are objects, and a \u003ccode\u003enextPageToken\u003c/code\u003e if there are more pages of results.\u003c/p\u003e\n"],["\u003cp\u003eFiltering results can be achieved through the \u003ccode\u003efilter\u003c/code\u003e query parameter, allowing users to narrow down the locations based on specific criteria like display name.\u003c/p\u003e\n"],["\u003cp\u003eThe service supports pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters, allowing users to retrieve large lists of locations in manageable chunks.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for accessing this endpoint requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists information about the supported locations for this service.\n\n### HTTP request\n\n`GET https://{endpoint}/v2beta1/{name=projects/*}/locations`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response message for [Locations.ListLocations](/dialogflow/es/docs/reference/rest/v2beta1/projects.locations/list#google.cloud.location.Locations.ListLocations).\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
