REST Resource: advertisers.locationLists

  • Display & Video 360 API v1 has been sunset.

  • The LocationList resource is used for targeting and includes fields like name, locationListId, displayName, locationType, and advertiserId.

  • TargetingLocationType specifies the type of targeting location, with options for proximity and regional.

  • Methods available for location lists include create, get, list, and patch.

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.