# Location Lists

[Location lists](https://support.google.com/displayvideo/answer/2705812?sjid=14176123729163846659-NA#:%7E:text=the%20privacy%20standards.-,Advertiser%2Dlevel%20location%20lists,-Advertiser%20location%20lists) are lists of geographic locations. Target a
location list to direct ads to customers in and around locations included in the
list.

In the Display \& Video 360 API, these are [`LocationList`](https://developers.google.com/display-video/api/reference/rest/current/advertisers.locationLists#LocationList) resources.
Target them under the targeting types `TARGETING_TYPE_REGIONAL_LOCATION_LIST`
and `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`. The targeting type depends on the
list's location type.

## Location list types

A list's location type determines the kinds of locations in the list and how the
list is used:

| `TargetingLocationType` ||
|---|---|
| `TARGETING_LOCATION_TYPE_REGIONAL` | |---| | Uses targeting type `TARGETING_TYPE_REGIONAL_LOCATION_LIST`. | | List of bordered regions, such as cities or countries, defined by `TARGETING_TYPE_GEO_REGION` targeting option IDs. | | Targets the total area of the included regions. | |
| `TARGETING_LOCATION_TYPE_PROXIMITY` | |---| | Uses targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`. | | List of specific locations, such as street addresses or latitude/longitude coordinates, defined by `TARGETING_TYPE_POI` targeting option IDs. | | Targets the area around each location in the list using a single given radius. | |

> [!NOTE]
> **Note:** Read more about this in the [Geography targeting guide
> page](https://developers.google.com/display-video/api/guides/concepts/targeting/geography).

## `AssignedLocation` resource

A [`AssignedLocation`](https://developers.google.com/display-video/api/reference/rest/current/advertisers.locationLists.assignedLocations#AssignedLocation) resource is a location in a location
list. It is defined by a targeting option ID.

See the [Geography Targeting page](https://developers.google.com/display-video/api/guides/concepts/targeting/geography) for details on
retrieving these targeting option IDs.

## Content management

Assigned locations are managed using functions in the
[`assignedLocations`](https://developers.google.com/display-video/api/reference/rest/current/advertisers.locationLists.assignedLocations#methods) service:

- [`create`](https://developers.google.com/display-video/api/reference/rest/current/advertisers.locationLists.assignedLocations/create) assigns a location to the list.
- [`delete`](https://developers.google.com/display-video/api/reference/rest/current/advertisers.locationLists.assignedLocations/delete) removes a location from the list.
- [`list`](https://developers.google.com/display-video/api/reference/rest/current/advertisers.locationLists.assignedLocations/list) gets locations assigned to the list.
- [`bulkEdit`](https://developers.google.com/display-video/api/reference/rest/current/advertisers.locationLists.assignedLocations/bulkEdit) edits list content in bulk. The method removes locations from and then assigns locations to the list in a single request.