type VideoPositionTarget (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Represents the options for targetable positions within a video.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
Field
|
videoPosition
|
VideoPosition
The video position to target. This attribute is required.
|
videoBumperType
|
VideoBumperType
The video bumper type to target. To target a video position or a pod position, this value must
be null. To target a bumper position this value must be populated and the line item must have a
bumper type. To target a custom ad spot, this value must be null.
Enumerations
-
BEFORE
- Represents the bumper position before the ad pod.
-
AFTER
- Represents the bumper position after the ad pod.
|
videoPositionWithinPod
|
VideoPositionWithinPod
The video position within a pod to target. To target a video position or a bumper position,
this value must be null. To target a position within a pod this value must be populated. To
target a custom ad spot, this value must be null.
|
adSpotId
|
xsd:long
A custom spot AdSpot to target. To target a video position, a bumper type or a video
position within a pod this value must be null.
|
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\u003eVideoPositionTarget\u003c/code\u003e allows you to target specific positions within a video, such as pre-roll, mid-roll, post-roll, or bumper positions.\u003c/p\u003e\n"],["\u003cp\u003eThis targeting can be further refined by specifying positions within ad pods or by targeting custom ad spots using their IDs.\u003c/p\u003e\n"],["\u003cp\u003eTargeting options include \u003ccode\u003evideoPosition\u003c/code\u003e, \u003ccode\u003evideoBumperType\u003c/code\u003e, \u003ccode\u003evideoPositionWithinPod\u003c/code\u003e, and \u003ccode\u003eadSpotId\u003c/code\u003e, providing flexibility in ad placement.\u003c/p\u003e\n"],["\u003cp\u003eFor bumper positions, you must specify the \u003ccode\u003evideoBumperType\u003c/code\u003e as either \u003ccode\u003eBEFORE\u003c/code\u003e or \u003ccode\u003eAFTER\u003c/code\u003e the ad pod, while line items need a corresponding bumper type.\u003c/p\u003e\n"],["\u003cp\u003eTo target positions within an ad pod, utilize \u003ccode\u003evideoPositionWithinPod\u003c/code\u003e, while \u003ccode\u003eadSpotId\u003c/code\u003e allows for targeting custom ad spots directly.\u003c/p\u003e\n"]]],["The `VideoPositionTarget` defines targetable positions within a video, relying on `VideoPositionTargeting`. Key attributes include: `videoPosition`, specifying the targeted position; `videoBumperType`, indicating bumper positions (BEFORE/AFTER); `videoPositionWithinPod`, for positions inside a pod; and `adSpotId`, for targeting a custom ad spot. Targeting a video or pod position requires a null `videoBumperType`, while bumper positions necessitate a populated `videoBumperType`. Each targeting type also requires specific attributes to be null or populated.\n"],null,["# type VideoPositionTarget (v202408)\n\n**Service** \n**AdRuleService** [AdjustmentService](/ad-manager/api/reference/v202408/AdjustmentService.VideoPositionTarget) [ForecastService](/ad-manager/api/reference/v202408/ForecastService.VideoPositionTarget) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.VideoPositionTarget) [NativeStyleService](/ad-manager/api/reference/v202408/NativeStyleService.VideoPositionTarget) [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.VideoPositionTarget) [ProposalService](/ad-manager/api/reference/v202408/ProposalService.VideoPositionTarget) [PublisherQueryLanguageService](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.VideoPositionTarget) [TargetingPresetService](/ad-manager/api/reference/v202408/TargetingPresetService.VideoPositionTarget) [YieldGroupService](/ad-manager/api/reference/v202408/YieldGroupService.VideoPositionTarget) **Dependencies** \n[VideoPositionTargeting](/ad-manager/api/reference/v202408/AdRuleService.VideoPositionTargeting) \n▼\n**VideoPositionTarget**\n\nRepresents the options for targetable positions within a video.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `videoPosition` | ` `[VideoPosition](/ad-manager/api/reference/v202408/AdRuleService.VideoPosition)` ` The video position to target. This attribute is required. |\n| ### `videoBumperType` | ` `[VideoBumperType](/ad-manager/api/reference/v202408/AdRuleService.VideoBumperType)` ` The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null. *** ** * ** *** **Enumerations** `BEFORE` : Represents the bumper position before the ad pod. `AFTER` : Represents the bumper position after the ad pod. \u003cbr /\u003e |\n| ### `videoPositionWithinPod` | ` `[VideoPositionWithinPod](/ad-manager/api/reference/v202408/AdRuleService.VideoPositionWithinPod)` ` The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null. |\n| ### `adSpotId` | ` `xsd:`long` A custom spot [AdSpot](/ad-manager/api/reference/v202408/AdRuleService.AdSpot) to target. To target a video position, a bumper type or a video position within a pod this value must be null. |"]]
