自
2025 年 9 月 8 日起,每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明,请参阅我们的
弃用页面。
REST Resource: advertisers.locationLists
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:LocationList
JSON 表示法 |
{
"name": string,
"locationListId": string,
"displayName": string,
"locationType": enum (TargetingLocationType ),
"advertiserId": string
} |
字段 |
name |
string
仅限输出。位置列表的资源名称。
|
locationListId |
string (int64 format)
仅限输出。营业地点列表的唯一 ID。由系统分配。
|
displayName |
string
必需。营业地点列表的显示名称。必须采用 UTF-8 编码,大小不得超过 240 字节。
|
locationType |
enum (TargetingLocationType )
必需。不可变。营业地点的类型。列表中的所有营业地点都将采用此类型。
|
advertiserId |
string (int64 format)
必需。不可变。相应营业地点列表所属广告客户的唯一 ID。
|
TargetingLocationType
枚举 |
TARGETING_LOCATION_TYPE_UNSPECIFIED |
如果未指定类型或类型未知,则使用默认值。 |
TARGETING_LOCATION_TYPE_PROXIMITY |
邻近地理位置的类型。 |
TARGETING_LOCATION_TYPE_REGIONAL |
区域地理位置的类型。 |
方法 |
|
创建新的地点列表。 |
|
获取位置列表。 |
|
根据给定的广告客户 ID 列出地理位置列表。 |
|
更新位置列表。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eLocationList is a resource used for targeting and is a list of locations.\u003c/p\u003e\n"],["\u003cp\u003eEach LocationList has a name, ID, display name, location type, and advertiser ID.\u003c/p\u003e\n"],["\u003cp\u003eThere are three types of targeting location types: unspecified, proximity, and regional.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage LocationLists through methods like creating, getting, listing, and updating them.\u003c/p\u003e\n"]]],["Location lists, used for targeting, are identified by a unique ID and contain a display name, location type (proximity or regional), and the associated advertiser ID. The location type is immutable. Available actions include creating, retrieving (get), listing, and updating (patch) location lists. Each list contains location data with attributes like `name`, `displayName`, `locationType`, and `advertiserId` which is necessary when creating one.\n"],null,["# REST Resource: advertisers.locationLists\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\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/v3/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/v3/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/v3/advertisers.locationLists/create) | Creates a new location list. |\n| ### [get](/display-video/api/reference/rest/v3/advertisers.locationLists/get) | Gets a location list. |\n| ### [list](/display-video/api/reference/rest/v3/advertisers.locationLists/list) | Lists location lists based on a given advertiser id. |\n| ### [patch](/display-video/api/reference/rest/v3/advertisers.locationLists/patch) | Updates a location list. |"]]