Location Lists

Location lists 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 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.

AssignedLocation resource

A AssignedLocation resource is a location in a location list. It is defined by a targeting option ID.

See the Geography Targeting page for details on retrieving these targeting option IDs.

Content management

Assigned locations are managed using functions in the assignedLocations service:

  • create assigns a location to the list.
  • delete removes a location from the list.
  • list gets locations assigned to the list.
  • bulkEdit edits list content in bulk. The method removes locations from and then assigns locations to the list in a single request.