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를 기반으로 위치 목록을 표시합니다. |
|
위치 목록을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\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. |"]]