enum MidrollFrequencyType (v202408)
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/v202408
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\u003eMidrollFrequencyType defines how often mid-roll ads should play within ad rule slots in Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eIt offers various frequency options like fixed time intervals, cue points, or a combination of both.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers can choose to play ads every N seconds, at specific time points, or based on cue points in the content.\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 signifies the value is not exposed in the current API version.\u003c/p\u003e\n"]]],["The document details the `MidrollFrequencyType` enumeration for ad rule slots within the `AdRuleService`. Key frequency types include `NONE` (not a mid-roll), `EVERY_N_SECONDS` (interval-based, in seconds), `FIXED_TIME` (specific times in seconds), `EVERY_N_CUEPOINTS` (cue point intervals), and `FIXED_CUE_POINTS` (specific cue points). These types define how `MidrollFrequency` is interpreted, either as a time interval, a list of specific times, an interval of cue points, or specific cue points. `UNKNOWN` indicates an unsupported value.\n"],null,["# enum MidrollFrequencyType (v202408)\n\n**Service** \n**AdRuleService** **Dependencies** \n[BaseAdRuleSlot](/ad-manager/api/reference/v202408/AdRuleService.BaseAdRuleSlot) \n▼\n**MidrollFrequencyType**\n\nFrequency types for mid-roll [ad rule slots](/ad-manager/api/reference/v202408/AdRuleService.BaseAdRuleSlot).\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\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. |"]]