Method: cities.list

  • Retrieves a list of cities, filtered by name prefix, country, region, or DART IDs.

  • The request is a GET request to the specified URL, with filtering options provided as query parameters.

  • The response includes a list of cities matching the criteria, along with resource kind information.

  • Requires authorization with the dfatrafficking scope.

Retrieves a list of cities, possibly filtered.

HTTP request

GET https://dfareporting.googleapis.com/dfareporting/v4/userprofiles/{profileId}/cities

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
profileId

string (int64 format)

User profile ID associated with this request.

Query parameters

Parameters
namePrefix

string

Select only cities with names starting with this prefix.
countryDartIds[]

string (int64 format)

Select only cities from these countries.
dartIds[]

string (int64 format)

Select only cities with these DART IDs.
regionDartIds[]

string (int64 format)

Select only cities from these regions.

Request body

The request body must be empty.

Response body

City cities.list Response

If successful, the response body contains data with the following structure:

JSON representation 
{
  "kind": string,
  "cities": [
    {
      object (City)
    }
  ]
}
Fields
kind

string

Identifies what kind of resource this is. Value: the fixed string

"dfareporting#citiesListResponse"

.
cities[]

object (City)

City collection.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/dfatrafficking