type VideoPositionTargeting (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Represents positions within and around a video where ads can be
targeted to.
Example positions could be pre-roll
(before the video plays),
post-roll
(after a video has
completed playback) and mid-roll
(during video playback).
Empty video position targeting means that all video positions
are allowed. If a bumper line item has empty video position
targeting it will be updated to target all bumper positions.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
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\u003eVideoPositionTargeting\u003c/code\u003e allows you to target ads to specific positions within and around videos, such as pre-roll, post-roll, and mid-roll.\u003c/p\u003e\n"],["\u003cp\u003eEmpty \u003ccode\u003eVideoPositionTargeting\u003c/code\u003e indicates that all positions are allowed, and it automatically targets all bumper positions for bumper line items.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etargetedPositions\u003c/code\u003e field contains \u003ccode\u003eVideoPositionTarget\u003c/code\u003e objects, specifying the video positions being targeted by a line item.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eVideoPositionTargeting\u003c/code\u003e object is defined within the \u003ccode\u003ehttps://www.google.com/apis/ads/publisher/v202408\u003c/code\u003e namespace.\u003c/p\u003e\n"]]],["The core content describes `VideoPositionTargeting`, which defines where ads can appear within a video (e.g., pre-roll, mid-roll, post-roll). This targeting is applicable to services like `AdRuleService`, `AdjustmentService`, `ForecastService`, `LineItemService`, and others. Empty targeting means all positions are valid. `TargetedPositions` field, containing an array of `VideoPositionTarget` objects, specifies the targeted locations for a video line item. It falls under the namespace `https://www.google.com/apis/ads/publisher/v202408`.\n"],null,["# type VideoPositionTargeting (v202408)\n\n**Service** \n[AdRuleService](/ad-manager/api/reference/v202408/AdRuleService.VideoPositionTargeting) [AdjustmentService](/ad-manager/api/reference/v202408/AdjustmentService.VideoPositionTargeting) [ForecastService](/ad-manager/api/reference/v202408/ForecastService.VideoPositionTargeting) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.VideoPositionTargeting) [NativeStyleService](/ad-manager/api/reference/v202408/NativeStyleService.VideoPositionTargeting) [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.VideoPositionTargeting) [ProposalService](/ad-manager/api/reference/v202408/ProposalService.VideoPositionTargeting) **PublisherQueryLanguageService** [TargetingPresetService](/ad-manager/api/reference/v202408/TargetingPresetService.VideoPositionTargeting) [YieldGroupService](/ad-manager/api/reference/v202408/YieldGroupService.VideoPositionTargeting) **Dependencies** \n[Targeting](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.Targeting) \n▼\n**VideoPositionTargeting**\n\n\nRepresents positions within and around a video where ads can be\ntargeted to.\n\nExample positions could be `pre-roll` (before the video plays),\n`post-roll` (after a video has\ncompleted playback) and `mid-roll`\n(during video playback).\n\nEmpty video position targeting means that all video positions\nare allowed. If a bumper line item has empty video position\ntargeting it will be updated to target all bumper positions.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `targetedPositions` | ` `[VideoPositionTarget](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.VideoPositionTarget)`[]` The `VideoTargetingPosition` objects being targeted by the video [LineItem](/ad-manager/api/reference/v202408/ForecastService.LineItem). |"]]