À 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é.
Indique si une limite de fréquence d'exposition illimitée est appliquée. Lorsque ce champ est défini sur true, les autres champs de limite de la fréquence d'exposition ne s'appliquent pas.
Nombre de timeUnit pendant lequel la limite de la fréquence d'exposition s'applique.
Obligatoire lorsque unlimited est false. Les restrictions suivantes s'appliquent en fonction de la valeur de timeUnit:
TIME_UNIT_MONTHS : doit être défini sur 1
TIME_UNIT_WEEKS : doit être compris entre 1 et 4
TIME_UNIT_DAYS : doit être compris entre 1 et 6
TIME_UNIT_HOURS : doit être compris entre 1 et 23
TIME_UNIT_MINUTES : doit être compris entre 1 et 59
maxImpressions
integer
Nombre maximal de fois où un utilisateur peut voir une même annonce au cours de cette période. Doit être supérieur à 0.
Obligatoire lorsque unlimited est false et que maxViews n'est pas défini.
maxViews
integer
Facultatif. Nombre maximal de fois où un utilisateur peut cliquer sur une annonce ou la voir entièrement au cours de cette période jusqu'à ce qu'elle ne lui soit plus diffusée. Doit être supérieur à 0.
Ne s'applique qu'aux ressources YouTube et Partenaires.
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)."],[[["\u003cp\u003eFrequency capping settings determine how often a user sees the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThese settings offer control over the maximum impressions or views a user receives within a defined period.\u003c/p\u003e\n"],["\u003cp\u003eYou can set frequency caps based on various time units (lifetime, months, weeks, days, hours, minutes) and limits.\u003c/p\u003e\n"],["\u003cp\u003eThe "unlimited" option bypasses other frequency cap settings, allowing for unlimited ad exposure.\u003c/p\u003e\n"],["\u003cp\u003eFor YouTube and Partner resources, you can set limits for both impressions (ad displays) and views (clicks or full views).\u003c/p\u003e\n"]]],[],null,["# FrequencyCap\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- [JSON representation](#SCHEMA_REPRESENTATION)\n\nSettings that control the number of times a user may be shown with the same ad during a given time period.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"unlimited\": boolean, \"timeUnit\": enum (/display-video/api/reference/rest/v3/TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer, \"maxViews\": integer } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unlimited` | `boolean` Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. |\n| `timeUnit` | `enum (`[TimeUnit](/display-video/api/reference/rest/v3/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_MONTHS` - must be 1 - `TIME_UNIT_WEEKS` - must be between 1 and 4 - `TIME_UNIT_DAYS` - must be between 1 and 6 - `TIME_UNIT_HOURS` - must be between 1 and 23 - `TIME_UNIT_MINUTES` - must be between 1 and 59 |\n| `maxImpressions` | `integer` The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.max_impressions) is not set. |"]]
