REST Resource: advertisers.locationLists

  • Display & Video 360 API v3 has sunset and users should transition to v4.

  • A LocationList is a resource in the API used for targeting based on location.

  • The LocationList resource has fields including name, locationListId, displayName, locationType, and advertiserId.

  • TargetingLocationType defines the type of targeting location, such as proximity or regional.

  • Available methods for LocationList include creating, getting, listing, and patching location lists.

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.