Starting
September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our
deprecations page for more details on how to update your integration to make this declaration.
REST Resource: advertisers.locationLists
Stay organized with collections
Save and categorize content based on your preferences.
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 |
|
|
Creates a new location list. |
|
|
Gets a location list. |
|
|
Lists location lists based on a given advertiser id. |
|
|
Updates a location list. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-27 UTC.
[null,null,["Last updated 2025-03-27 UTC."],[],[],null,["# REST Resource: advertisers.locationLists\n\n- [Resource: LocationList](#LocationList)\n - [JSON representation](#LocationList.SCHEMA_REPRESENTATION)\n- [TargetingLocationType](#TargetingLocationType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: LocationList\n----------------------\n\nA list of locations used for targeting.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"locationListId\": string, \"displayName\": string, \"locationType\": enum (/display-video/api/reference/rest/v4/advertisers.locationLists#TargetingLocationType), \"advertiserId\": string } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the location list. |\n| `locationListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the location list. Assigned by the system. |\n| `displayName` | `string` Required. The display name of the location list. Must be UTF-8 encoded with a maximum size of 240 bytes. |\n| `locationType` | `enum (`[TargetingLocationType](/display-video/api/reference/rest/v4/advertisers.locationLists#TargetingLocationType)`)` Required. Immutable. The type of location. All locations in the list will share this type. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. Immutable. The unique ID of the advertiser the location list belongs to. |\n\nTargetingLocationType\n---------------------\n\nType of a targeting location.\n\n| Enums ||\n|---------------------------------------|---------------------------------------------------------|\n| `TARGETING_LOCATION_TYPE_UNSPECIFIED` | Default value when type is not specified or is unknown. |\n| `TARGETING_LOCATION_TYPE_PROXIMITY` | The type for proximity geo location. |\n| `TARGETING_LOCATION_TYPE_REGIONAL` | The type for regional geo location. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------|------------------------------------------------------|\n| ### [create](/display-video/api/reference/rest/v4/advertisers.locationLists/create) | Creates a new location list. |\n| ### [get](/display-video/api/reference/rest/v4/advertisers.locationLists/get) | Gets a location list. |\n| ### [list](/display-video/api/reference/rest/v4/advertisers.locationLists/list) | Lists location lists based on a given advertiser id. |\n| ### [patch](/display-video/api/reference/rest/v4/advertisers.locationLists/patch) | Updates a location list. |"]]
