Method: networks.sources.content.adBreaks.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
API per creare un'interruzione pubblicitaria all'interno del live streaming.
Richiesta HTTP
POST https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
content |
string
Questo è un modo alternativo per identificare LiveStreamEvent, se è associato a un contenuto all'interno di GAM. Deve essere nel formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"
|
Parametri di query
| Parametri |
parent |
string
Questo campo identifica l'oggetto LiveStreamEvent a cui deve essere associata questa interruzione pubblicitaria utilizzando la chiave asset del live streaming. Deve essere nel formato "networks/{network_code}/assets/{asset_code}"
|
customParent |
string
Questo campo identifica l'evento LiveStreamEvent a cui deve essere associata questa interruzione pubblicitaria utilizzando la chiave asset personalizzata. Deve essere nel formato "networks/{network_code}/customAssets/{asset_code}"
|
adBreakId |
string
Questo è l'adBreakId che gli utenti possono fornire tramite la richiesta.
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di AdBreak.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di AdBreak.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-21 UTC.
[null,null,["Ultimo aggiornamento 2025-08-21 UTC."],[[["\u003cp\u003eThis API creates ad breaks within live streams using an HTTP POST request to a specified URL.\u003c/p\u003e\n"],["\u003cp\u003eIdentification of the live stream event can be done using either the content ID (for GAM-associated streams) or asset keys (live stream or custom).\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires an AdBreak object, and a successful response returns the newly created AdBreak object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes, such as 'contentingestion' or 'video-ads', for access and functionality.\u003c/p\u003e\n"]]],["This API facilitates the creation of an Ad Break within a live stream. It uses a `POST` request to a specified URL, which includes path and query parameters. The `content` path parameter specifies the associated content, while query parameters (`parent`, `customParent`, `adBreakId`) link the Ad Break to a LiveStreamEvent. The request body requires an `AdBreak` instance. Successful creation returns a new `AdBreak` instance in the response body. Access requires OAuth scopes: `contentingestion` or `video-ads`.\n"],null,["# Method: networks.sources.content.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/{content=networks/*/sources/*/content/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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\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| `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| `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)."]]
