À partir du
8 septembre 2025, chaque nouvelle ligne devra indiquer si elle diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et les appels à l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour savoir comment mettre à jour votre intégration afin d'effectuer cette déclaration, consultez notre
page sur les abandons de compatibilité.
REST Resource: advertisers.locationLists
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: LocationList
Liste des zones géographiques utilisées pour le ciblage.
| Représentation JSON |
{
"name": string,
"locationListId": string,
"displayName": string,
"locationType": enum (TargetingLocationType),
"advertiserId": string
} |
| Champs |
name |
string
Uniquement en sortie. Nom de la ressource de la liste d'établissements.
|
locationListId |
string (int64 format)
Uniquement en sortie. Identifiant unique de la liste de zones géographiques. Attribué par le système.
|
displayName |
string
Obligatoire. Nom à afficher de la liste des lieux. Doit être encodé en UTF-8 et ne pas dépasser 240 octets.
|
locationType |
enum (TargetingLocationType)
Obligatoire. Immuable. Type de lieu. Tous les lieux de la liste partageront ce type.
|
advertiserId |
string (int64 format)
Obligatoire. Immuable. Identifiant unique de l'annonceur auquel appartient la liste de zones géographiques.
|
TargetingLocationType
| Enums |
TARGETING_LOCATION_TYPE_UNSPECIFIED |
Valeur par défaut lorsque le type n'est pas spécifié ou est inconnu. |
TARGETING_LOCATION_TYPE_PROXIMITY |
Type de géolocalisation de proximité. |
TARGETING_LOCATION_TYPE_REGIONAL |
Type de géolocalisation régionale. |
Méthodes |
|
|
Crée une liste d'établissements. |
|
|
Récupère une liste d'établissements. |
|
|
Liste les listes d'emplacements en fonction d'un identifiant d'annonceur donné. |
|
|
Met à jour une liste d'établissements. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
