Method: networks.liveStreamEvents.adBreaks.create
Stay organized with collections
Save and categorize content based on your preferences.
API to create an AdBreak
object.
Informs DAI of an upcoming ad break for a live stream event, with an optional expected start time. DAI will begin decisioning ads for the break shortly before the expected start time, if provided. Each live stream event can only have one incomplete ad break at any given time. The next ad break can be scheduled after the previous ad break has started serving, indicated by its state being COMPLETE
, or it has been deleted.
This method cannot be used if the LiveStreamEvent
has prefetching ad breaks enabled or the event is not active. If a LiveStreamEvent
is deactivated after creating an ad break and before the ad break is complete, the ad break is discarded.
An ad break's state is complete when the following occurs: - Full service DAI: after a matching ad break shows in the LiveStreamEvent
manifest only when the ad break has started decisioning. - Pod Serving: after the ad break is requested using the ad break ID or break sequence.
HTTP request
POST https://admanager.googleapis.com/v1/{parent}/adBreaks
Path parameters
Parameters |
parent |
string
Required. The parent resource where this AdBreak will be created identified by an asset key or custom asset key. Formats: networks/{networkCode}/liveStreamEventsByAssetKey/{assetKey} networks/{networkCode}/liveStreamEventsByCustomAssetKey/{customAssetKey}
|
Request body
The request body contains an instance of AdBreak
.
Response body
If successful, the response body contains a newly created instance of AdBreak
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/admanager
For more information, see the OAuth 2.0 Overview.
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-20 UTC.
[null,null,["Last updated 2025-08-20 UTC."],[],[],null,["# Method: networks.liveStreamEvents.adBreaks.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nAPI to create an `AdBreak` object.\n\nInforms DAI of an upcoming ad break for a live stream event, with an optional expected start time. DAI will begin decisioning ads for the break shortly before the expected start time, if provided. Each live stream event can only have one incomplete ad break at any given time. The next ad break can be scheduled after the previous ad break has started serving, indicated by its state being [`COMPLETE`](/ad-manager/api/beta/reference/rest/v1/networks.liveStreamEvents.adBreaks#AdBreak.AdBreakState.ENUM_VALUES.COMPLETE), or it has been deleted.\n\nThis method cannot be used if the `LiveStreamEvent` has [prefetching ad breaks enabled](https://developers.google.com/ad-manager/api/reference/latest/LiveStreamEventService.LiveStreamEvent#prefetchenabled) or the event is not active. If a `LiveStreamEvent` is deactivated after creating an ad break and before the ad break is complete, the ad break is discarded.\n\nAn ad break's state is complete when the following occurs: - Full service DAI: after a matching ad break shows in the `LiveStreamEvent` manifest only when the ad break has started decisioning. - Pod Serving: after the ad break is requested using the ad break ID or break sequence.\n\n### HTTP request\n\n`POST https://admanager.googleapis.com/v1/{parent}/adBreaks`\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource where this `AdBreak` will be created identified by an asset key or custom asset key. Formats: `networks/{networkCode}/liveStreamEventsByAssetKey/{assetKey}` `networks/{networkCode}/liveStreamEventsByCustomAssetKey/{customAssetKey}` |\n\n### Request body\n\nThe request body contains an instance of [AdBreak](/ad-manager/api/beta/reference/rest/v1/networks.liveStreamEvents.adBreaks#AdBreak).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [AdBreak](/ad-manager/api/beta/reference/rest/v1/networks.liveStreamEvents.adBreaks#AdBreak).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admanager`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]