[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eA FrequencyCap in Google Ad Manager limits the impressions a user sees from the same LineItem within a given timeframe.\u003c/p\u003e\n"],["\u003cp\u003eIt's defined by maximum impressions (\u003ccode\u003emaxImpressions\u003c/code\u003e), a time period (\u003ccode\u003enumTimeUnits\u003c/code\u003e & \u003ccode\u003etimeUnit\u003c/code\u003e), and applies to various services like Forecast, Inventory, and LineItem.\u003c/p\u003e\n"],["\u003cp\u003eTime units range from minutes to a lifetime or even per video stream/pod for video environments.\u003c/p\u003e\n"]]],["The core content describes the `FrequencyCap`, which limits a viewer's exposure to a specific `LineItem` over time. Key fields include `maxImpressions` (maximum views), `numTimeUnits` (total time period count), and `timeUnit` (time period unit). `TimeUnit` enumerations are `MINUTE`, `HOUR`, `DAY`, `WEEK`, `MONTH`, `LIFETIME`, `POD`, `STREAM`, and `UNKNOWN`. `POD` and `STREAM` are only valid for the `VIDEO_PLAYER` environment. This cap applies across services like `ForecastService`, `InventoryService`, `LineItemService` and `ProposalLineItemService`.\n"],null,["# type FrequencyCap (v202408)\n\n**Service** \n[ForecastService](/ad-manager/api/reference/v202408/ForecastService.FrequencyCap) [InventoryService](/ad-manager/api/reference/v202408/InventoryService.FrequencyCap) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.FrequencyCap) **ProposalLineItemService** **Dependencies** \n[ProposalLineItem](/ad-manager/api/reference/v202408/ProposalLineItemService.ProposalLineItem) \n▼\n**FrequencyCap**\n\nRepresents a limit on the number of times a single viewer can be exposed to the same [LineItem](/ad-manager/api/reference/v202408/ForecastService.LineItem) in a specified time period.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `maxImpressions` | ` `xsd:`int` The maximum number of impressions than can be served to a user within a specified time period. |\n| ### `numTimeUnits` | ` `xsd:`int` The number of `FrequencyCap#timeUnit` to represent the total time period. |\n| ### `timeUnit` | ` `[TimeUnit](/ad-manager/api/reference/v202408/ProposalLineItemService.TimeUnit)` ` The unit of time for specifying the time period. *** ** * ** *** **Enumerations** `MINUTE` : `HOUR` : `DAY` : `WEEK` : `MONTH` : `LIFETIME` : `POD` : Per pod of ads in a video stream. Only valid for entities in a [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202408/ProposalLineItemService.EnvironmentType#VIDEO_PLAYER) environment. `STREAM` : Per video stream. Only valid for entities in a [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202408/ProposalLineItemService.EnvironmentType#VIDEO_PLAYER) environment. `UNKNOWN` : The value returned if the actual value is not exposed by the requested API version. \u003cbr /\u003e |"]]