[[["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 number of times a viewer sees the same line item within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eIt's defined by the maximum impressions allowed (\u003ccode\u003emaxImpressions\u003c/code\u003e), the length of the time period (\u003ccode\u003enumTimeUnits\u003c/code\u003e), and the unit of time (e.g., day, week, month) (\u003ccode\u003etimeUnit\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eFrequencyCaps can be applied to various services, including ForecastService, InventoryService, LineItemService, and ProposalLineItemService.\u003c/p\u003e\n"],["\u003cp\u003eTime units for FrequencyCaps range from minutes to a lifetime and also include options like "per pod" or "per stream" for video content.\u003c/p\u003e\n"]]],["The content defines `FrequencyCap`, a mechanism to limit ad exposure to a single viewer for a given `LineItem` within a specified timeframe. It details three key fields: `maxImpressions` (maximum ad views), `numTimeUnits` (duration), and `timeUnit` (unit of time). Time units can be `MINUTE`, `HOUR`, `DAY`, `WEEK`, `MONTH`, or `LIFETIME`, or also `POD` or `STREAM` in a video environment. It is part of the `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** [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.FrequencyCap) **Dependencies** \n[LineItemSummary](/ad-manager/api/reference/v202408/LineItemService.LineItemSummary) \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/LineItemService.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/LineItemService.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/LineItemService.EnvironmentType#VIDEO_PLAYER) environment. `STREAM` : Per video stream. Only valid for entities in a [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202408/LineItemService.EnvironmentType#VIDEO_PLAYER) environment. `UNKNOWN` : The value returned if the actual value is not exposed by the requested API version. \u003cbr /\u003e |"]]
