自
2025 年 9 月 8 日起,每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 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 列出位置名單。 |
|
更新位置清單。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間: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. |"]]