An abstract interface that provides location-related information for a service. Service-specific metadata is provided through the Location.metadata field.
The resource that owns the locations collection, if applicable.
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 in AIP-160.
page_size
int32
The maximum number of results to return. If not set, the service selects a default.
page_token
string
A page token received from the next_page_token field in the response. Send that page token to receive the subsequent page.
extra_location_types[]
string
Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended 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-09-10 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eLocations\u003c/code\u003e interface provides location-related information for a service, with service-specific metadata available through the \u003ccode\u003eLocation.metadata\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGetLocation\u003c/code\u003e method retrieves information about a specific location and requires specific OAuth scopes for authorization, such as \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eListLocations\u003c/code\u003e method allows you to list supported locations for a service, also requiring specific OAuth scopes for authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eListLocationsRequest\u003c/code\u003e allows for filtering results using parameters like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, \u003ccode\u003epage_size\u003c/code\u003e, and \u003ccode\u003epage_token\u003c/code\u003e, while \u003ccode\u003eListLocationsResponse\u003c/code\u003e returns a list of locations and a next-page token.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eLocation\u003c/code\u003e resource contains details such as the location's \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003elocation_id\u003c/code\u003e, \u003ccode\u003edisplay_name\u003c/code\u003e, \u003ccode\u003elabels\u003c/code\u003e, and service-specific \u003ccode\u003emetadata\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["Index\n\n- [Locations](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Locations) (interface)\n- [GetLocationRequest](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.GetLocationRequest) (message)\n- [ListLocationsRequest](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.ListLocationsRequest) (message)\n- [ListLocationsResponse](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.ListLocationsResponse) (message)\n- [Location](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Location) (message)\n\nLocations An abstract interface that provides location-related information for a service. Service-specific metadata is provided through the [Location.metadata](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Location.FIELDS.google.protobuf.Any.google.cloud.location.Location.metadata) field.\n\n| GetLocation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` rpc GetLocation(`[GetLocationRequest](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.GetLocationRequest)`) returns (`[Location](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Location)`) ` Gets information about a location. Authorization scopes : Requires one of the following OAuth scopes: - `https://www.googleapis.com/auth/cloud-platform` - ` https://www.googleapis.com/auth/dialogflow` For more information, see the [Authentication Overview](/docs/authentication#authorization-gcp). |\n\n| ListLocations |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` rpc ListLocations(`[ListLocationsRequest](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.ListLocationsRequest)`) returns (`[ListLocationsResponse](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.ListLocationsResponse)`) ` Lists information about the supported locations for this service. Authorization scopes : Requires one of the following OAuth scopes: - `https://www.googleapis.com/auth/cloud-platform` - ` https://www.googleapis.com/auth/dialogflow` For more information, see the [Authentication Overview](/docs/authentication#authorization-gcp). |\n\nGetLocationRequest The request message for [Locations.GetLocation](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Locations.GetLocation).\n\n| Fields ||\n|--------|------------------------------------------|\n| `name` | `string` Resource name for the location. |\n\nListLocationsRequest The request message for [Locations.ListLocations](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Locations.ListLocations).\n\n| Fields ||\n|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource that owns the locations collection, if applicable. |\n| `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 in [AIP-160](https://google.aip.dev/160). |\n| `page_size` | `int32` The maximum number of results to return. If not set, the service selects a default. |\n| `page_token` | `string` A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. |\n| `extra_location_types[]` | `string` Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage. |\n\nListLocationsResponse The response message for [Locations.ListLocations](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Locations.ListLocations).\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `locations[]` | [Location](/dialogflow/es/docs/reference/rpc/google.cloud.location#google.cloud.location.Location) A list of locations that matches the specified filter in the request. |\n| `next_page_token` | `string` The standard List next-page token. |\n\nLocation A resource that represents a Google Cloud location.\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"` |\n| `location_id` | `string` The canonical id for this location. For example: `\"us-east1\"`. |\n| `display_name` | `string` The friendly name for this location, typically a nearby city name. For example, \"Tokyo\". |\n| `labels` | `map\u003cstring, string\u003e` Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"} |\n| `metadata` | [Any](https://protobuf.dev/reference/protobuf/google.protobuf/#any) Service-specific metadata. For example the available capacity at the given location. |"]]