Kể từ
ngày 8 tháng 9 năm 2025, mỗi mục hàng mới sẽ cần phải khai báo xem mục hàng đó có phân phát quảng cáo chính trị ở Liên minh Châu Âu (EU) hay không. Display & Video 360 API và các tệp SDF được tải lên mà không cung cấp thông tin khai báo sẽ không thành công. Hãy xem
trang thông báo về những nội dung không dùng nữa để biết thêm thông tin về cách cập nhật quy trình tích hợp để đưa ra nội dung khai báo này.
REST Resource: advertisers.locationLists
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: LocationList
Danh sách vị trí dùng để nhắm mục tiêu.
Biểu diễn dưới dạng JSON |
{
"name": string,
"locationListId": string,
"displayName": string,
"locationType": enum (TargetingLocationType ),
"advertiserId": string
} |
Trường |
name |
string
Chỉ có đầu ra. Tên tài nguyên của danh sách vị trí.
|
locationListId |
string (int64 format)
Chỉ có đầu ra. Mã nhận dạng duy nhất của danh sách vị trí. Do hệ thống chỉ định.
|
displayName |
string
Bắt buộc. Tên hiển thị của danh sách vị trí. Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.
|
locationType |
enum (TargetingLocationType )
Bắt buộc. Không thể thay đổi. Loại vị trí. Tất cả vị trí trong danh sách sẽ dùng chung loại này.
|
advertiserId |
string (int64 format)
Bắt buộc. Không thể thay đổi. Mã nhận dạng duy nhất của nhà quảng cáo sở hữu danh sách vị trí.
|
TargetingLocationType
Loại vị trí nhắm mục tiêu.
Enum |
TARGETING_LOCATION_TYPE_UNSPECIFIED |
Giá trị mặc định khi loại không được chỉ định hoặc không xác định. |
TARGETING_LOCATION_TYPE_PROXIMITY |
Loại thông tin vị trí địa lý theo khoảng cách. |
TARGETING_LOCATION_TYPE_REGIONAL |
Loại cho thông tin vị trí địa lý theo khu vực. |
Phương thức |
|
Tạo danh sách vị trí mới. |
|
Lấy danh sách vị trí. |
|
Liệt kê danh sách vị trí dựa trên một mã nhận dạng nhà quảng cáo nhất định. |
|
Cập nhật danh sách vị trí. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 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. |"]]