Method: networks.customAssets.adBreaks.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
API zum Erstellen einer Werbeunterbrechung im Livestream.
HTTP-Anfrage
POST https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
customParent |
string
In diesem Feld wird das LiveStreamEvent angegeben, dem die Werbeunterbrechung zugeordnet werden soll. Dazu wird der benutzerdefinierte Assetschlüssel verwendet. Er muss das Format „networks/{network_code}/customAssets/{asset_code}“ haben.
|
Abfrageparameter
Parameter |
parent |
string
In diesem Feld wird das LiveStreamEvent angegeben, dem diese Werbeunterbrechung zugeordnet werden soll. Dazu wird der Assetschlüssel des Livestreams verwendet. Er muss das Format „networks/{network_code}/assets/{asset_code}“ haben.
|
content |
string
Dies ist eine alternative Möglichkeit, das LiveStreamEvent zu identifizieren, wenn es mit einem Inhalt in GAM verknüpft ist. Er muss das Format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}“ haben.
|
adBreakId |
string
Dies ist die adBreakId, die Nutzer über die Anfrage angeben können.
|
Anfragetext
Der Anfragetext enthält eine Instanz von AdBreak
.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von AdBreak
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-21 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-21 (UTC)."],[[["\u003cp\u003eThis API creates an Ad Break within a live stream using an HTTP POST request to a specified URL.\u003c/p\u003e\n"],["\u003cp\u003eAd Breaks can be associated with LiveStreamEvents using either a custom asset key (\u003ccode\u003ecustomParent\u003c/code\u003e) or a live stream asset key (\u003ccode\u003eparent\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an instance of \u003ccode\u003eAdBreak\u003c/code\u003e, and a successful response will return the newly created \u003ccode\u003eAdBreak\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eThis API requires specific OAuth scopes for authorization, such as \u003ccode\u003ehttps://www.googleapis.com/auth/contentingestion\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/video-ads\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: networks.customAssets.adBreaks.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nAPI to create an Ad Break within the live stream.\n\n### HTTP request\n\n`POST https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customParent` | `string` This field identifies the LiveStreamEvent that this ad break should be associated to using the custom asset key. It must have the format of \"networks/{network_code}/customAssets/{asset_code}\" |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` This field identifies the LiveStreamEvent that this ad break should be associated to using the live stream asset key. It must have the format of \"networks/{network_code}/assets/{asset_code}\" |\n| `content` | `string` This is an alternative way to identify the LiveStreamEvent, if it's associated with a piece of content within GAM. It must have the format of \"networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}\" |\n| `adBreakId` | `string` This is the adBreakId that users can provide through the request. |\n\n### Request body\n\nThe request body contains an instance of [AdBreak](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [AdBreak](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/contentingestion`\n- `\n https://www.googleapis.com/auth/video-ads`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]