[[["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\u003eThe FrequencyCap object represents a limit on the number of times a viewer can see the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes \u003ccode\u003emaxImpressions\u003c/code\u003e, \u003ccode\u003enumTimeUnits\u003c/code\u003e, and \u003ccode\u003etimeUnit\u003c/code\u003e to define the frequency cap.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etimeUnit\u003c/code\u003e offers various options like \u003ccode\u003eMINUTE\u003c/code\u003e, \u003ccode\u003eHOUR\u003c/code\u003e, \u003ccode\u003eDAY\u003c/code\u003e, \u003ccode\u003eWEEK\u003c/code\u003e, \u003ccode\u003eMONTH\u003c/code\u003e, \u003ccode\u003eLIFETIME\u003c/code\u003e, \u003ccode\u003ePOD\u003c/code\u003e, \u003ccode\u003eSTREAM\u003c/code\u003e, and \u003ccode\u003eUNKNOWN\u003c/code\u003e for flexibility in setting the desired timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThis object is relevant to \u003ccode\u003eForecastService\u003c/code\u003e, \u003ccode\u003eInventoryService\u003c/code\u003e, \u003ccode\u003eLineItemService\u003c/code\u003e, and \u003ccode\u003eProposalLineItemService\u003c/code\u003e.\u003c/p\u003e\n"]]],["The core content describes the `FrequencyCap`, which limits a viewer's exposure to a specific `LineItem` over time. Key information includes: `maxImpressions` (the maximum impressions allowed), `numTimeUnits` (the duration of the time period), and `timeUnit` (the unit of time, such as `MINUTE`, `HOUR`, `DAY`, `WEEK`, `MONTH`, or `LIFETIME`). Other enumerated time units, applicable for video streams are: `POD` and `STREAM`. `UNKNOWN` is also a possible value.\n"],null,["# type FrequencyCap (v202411)\n\n**Service** \n**ForecastService** [InventoryService](/ad-manager/api/reference/v202411/InventoryService.FrequencyCap) [LineItemService](/ad-manager/api/reference/v202411/LineItemService.FrequencyCap) [ProposalLineItemService](/ad-manager/api/reference/v202411/ProposalLineItemService.FrequencyCap) **Dependencies** \n[LineItemSummary](/ad-manager/api/reference/v202411/ForecastService.LineItemSummary) [ProposalLineItem](/ad-manager/api/reference/v202411/ForecastService.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/v202411/ForecastService.LineItem) in a specified time period.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202411`\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/v202411/ForecastService.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/v202411/ForecastService.EnvironmentType#VIDEO_PLAYER) environment. `STREAM` : Per video stream. Only valid for entities in a [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202411/ForecastService.EnvironmentType#VIDEO_PLAYER) environment. `UNKNOWN` : The value returned if the actual value is not exposed by the requested API version. \u003cbr /\u003e |"]]