REST Resource: advertisers.locationLists

  • Display & Video 360 API v1 is sunsetted.

  • A LocationList resource defines a list of locations for targeting, containing properties such as name, ID, display name, location type, and advertiser ID.

  • TargetingLocationType determines the type of location used for targeting, including proximity and regional locations.

  • The API provides methods to manage location lists, allowing for creation, retrieval, listing, and updates.

Resource: LocationList

A list of locations used for targeting.

JSON representation 
{
  "name": string,
  "locationListId": string,
  "displayName": string,
  "locationType": enum (TargetingLocationType),
  "advertiserId": string
}
Fields
name

string

Output only. The resource name of the location list.
locationListId

string (int64 format)

Output only. The unique ID of the location list. Assigned by the system.
displayName

string

Required. The display name of the location list. Must be UTF-8 encoded with a maximum size of 240 bytes.
locationType

enum (TargetingLocationType)

Required. Immutable. The type of location. All locations in the list will share this type.
advertiserId

string (int64 format)

Required. Immutable. The unique ID of the advertiser the location list belongs to.

TargetingLocationType

Type of a targeting location.

Enums
TARGETING_LOCATION_TYPE_UNSPECIFIED Default value when type is not specified or is unknown.
TARGETING_LOCATION_TYPE_PROXIMITY The type for proximity geo location.
TARGETING_LOCATION_TYPE_REGIONAL The type for regional geo location.

Methods

create

 Creates a new location list.

get

 Gets a location list.

list

 Lists location lists based on a given advertiser id.

patch

 Updates a location list.