Od
8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej
stronie dotyczącej wycofania.
REST Resource: advertisers.locationLists
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: LocationList
Lista lokalizacji używanych do kierowania.
| Zapis JSON |
{
"name": string,
"locationListId": string,
"displayName": string,
"locationType": enum (TargetingLocationType),
"advertiserId": string
} |
| Pola |
name |
string
Tylko dane wyjściowe. Nazwa zasobu listy lokalizacji.
|
locationListId |
string (int64 format)
Tylko dane wyjściowe. Unikalny identyfikator listy lokalizacji. Przypisany przez system.
|
displayName |
string
Wymagane. Wyświetlana nazwa listy lokalizacji. Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
|
locationType |
enum (TargetingLocationType)
Wymagane. Niezmienna. Typ lokalizacji. Wszystkie lokalizacje na liście będą miały ten sam typ.
|
advertiserId |
string (int64 format)
Wymagane. Niezmienna. Unikalny identyfikator reklamodawcy, do którego należy lista lokalizacji.
|
TargetingLocationType
Typ lokalizacji kierowania.
| Wartości w polu enum |
TARGETING_LOCATION_TYPE_UNSPECIFIED |
Wartość domyślna, gdy typ nie jest określony lub jest nieznany. |
TARGETING_LOCATION_TYPE_PROXIMITY |
Typ zbliżonej lokalizacji geograficznej. |
TARGETING_LOCATION_TYPE_REGIONAL |
Typ regionalnej lokalizacji geograficznej. |
Metody |
|
|
Tworzy nową listę lokalizacji. |
|
|
Pobiera listę lokalizacji. |
|
|
Wyświetla listy lokalizacji na podstawie danego identyfikatora reklamodawcy. |
|
|
Aktualizuje listę lokalizacji. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
