enum MidrollFrequencyType (v202411)
Stay organized with collections
Save and categorize content based on your preferences.
Frequency types for mid-roll ad rule slots.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202411
| Enumeration |
Description |
NONE
|
The ad rule slot is not a mid-roll and hence MidrollFrequency
should be ignored.
|
EVERY_N_SECONDS
|
MidrollFrequency is a time interval and mentioned as a single
numeric value in seconds. For example, "100" would mean "play a
mid-roll every 100 seconds".
|
FIXED_TIME
|
MidrollFrequency is a comma-delimited list of points in time
(in seconds) when an ad should play. For example, "100,300" would mean
"play an ad at 100 seconds and 300 seconds".
|
EVERY_N_CUEPOINTS
|
MidrollFrequency is a cue point interval and is a single integer
value, such as "5", which means "play a mid-roll every 5th cue point".
|
FIXED_CUE_POINTS
|
Same as FIXED_TIME, except the values represent the ordinal cue
points ("1,3,5", for example).
|
UNKNOWN
|
The value returned if the actual value is not exposed by the requested API version.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eMidrollFrequencyType\u003c/code\u003e defines how often mid-roll ads should play within ad rule slots in Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eIt offers options for frequency based on time intervals, specific time points, cue point intervals, or specific cue points.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eNONE\u003c/code\u003e indicates the ad rule slot is not for mid-rolls, while \u003ccode\u003eUNKNOWN\u003c/code\u003e represents values not exposed by the API version.\u003c/p\u003e\n"],["\u003cp\u003eValues like \u003ccode\u003eEVERY_N_SECONDS\u003c/code\u003e or \u003ccode\u003eFIXED_TIME\u003c/code\u003e use seconds for time-based frequency, whereas \u003ccode\u003eEVERY_N_CUEPOINTS\u003c/code\u003e or \u003ccode\u003eFIXED_CUE_POINTS\u003c/code\u003e utilize cue points.\u003c/p\u003e\n"],["\u003cp\u003eThis enumeration helps control the frequency and placement of mid-roll ads within video content using ad rules.\u003c/p\u003e\n"]]],["The document details the `MidrollFrequencyType` enumeration, used for mid-roll ad rule slots. It defines how `MidrollFrequency` should be interpreted. `NONE` indicates no mid-roll. `EVERY_N_SECONDS` uses a time interval in seconds. `FIXED_TIME` uses a comma-separated list of times in seconds. `EVERY_N_CUEPOINTS` specifies an interval between cue points. `FIXED_CUE_POINTS` lists specific cue point ordinals. `UNKNOWN` is for values not exposed by the API.\n"],null,["# enum MidrollFrequencyType (v202411)\n\n**Service** \n**AdRuleService** **Dependencies** \n[BaseAdRuleSlot](/ad-manager/api/reference/v202411/AdRuleService.BaseAdRuleSlot) \n▼\n**MidrollFrequencyType**\n\nFrequency types for mid-roll [ad rule slots](/ad-manager/api/reference/v202411/AdRuleService.BaseAdRuleSlot).\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202411`\n\n| Enumeration | Description |\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `NONE` | The ad rule slot is not a mid-roll and hence `MidrollFrequency` should be ignored. |\n| `EVERY_N_SECONDS` | `MidrollFrequency` is a time interval and mentioned as a single numeric value in seconds. For example, \"100\" would mean \"play a mid-roll every 100 seconds\". |\n| `FIXED_TIME` | `MidrollFrequency` is a comma-delimited list of points in time (in seconds) when an ad should play. For example, \"100,300\" would mean \"play an ad at 100 seconds and 300 seconds\". |\n| `EVERY_N_CUEPOINTS` | `MidrollFrequency` is a cue point interval and is a single integer value, such as \"5\", which means \"play a mid-roll every 5th cue point\". |\n| `FIXED_CUE_POINTS` | Same as [FIXED_TIME](#FIXED_TIME), except the values represent the ordinal cue points (\"1,3,5\", for example). |\n| `UNKNOWN` | The value returned if the actual value is not exposed by the requested API version. |"]]
