Method: networks.assets.adBreaks.create
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Canlı yayın içinde reklam arası oluşturmak için kullanılan API.
HTTP isteği
POST https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
parent |
string
Bu alan, canlı yayın öğesi anahtarı kullanılarak bu reklam arasının ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. "networks/{network_code}/assets/{asset_code}" biçiminde olmalıdır.
|
Sorgu parametreleri
Parametreler |
customParent |
string
Bu alan, özel öğe anahtarı kullanılarak bu reklam arasının ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. "networks/{network_code}/customAssets/{asset_code}" biçiminde olmalıdır.
|
content |
string
Bu, LiveStreamEvent'in GAM'deki bir içerikle ilişkilendirilmesi durumunda kullanılabilen alternatif bir tanımlama yöntemidir. "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" biçiminde olmalıdır.
|
adBreakId |
string
Bu, kullanıcıların istek aracılığıyla sağlayabileceği adBreakId'dir.
|
İstek içeriği
İstek metni, AdBreak
öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt metni, AdBreak
öğesinin yeni oluşturulmuş bir örneğini içerir.
Yetkilendirme Kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-21 UTC.
[null,null,["Son güncelleme tarihi: 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\u003eAd breaks are associated with a LiveStreamEvent using either the live stream asset key (\u003ccode\u003eparent\u003c/code\u003e), custom asset key (\u003ccode\u003ecustomParent\u003c/code\u003e), or content within GAM (\u003ccode\u003econtent\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of \u003ccode\u003eAdBreak\u003c/code\u003e, providing necessary ad break details.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns a newly created instance of \u003ccode\u003eAdBreak\u003c/code\u003e with assigned values.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires one of the specified OAuth scopes: \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,["- [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\nHTTP request\n\n`POST https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath 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\nQuery 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| `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\nRequest body\n\nThe request body contains an instance of [AdBreak](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak).\n\nResponse body\n\nIf successful, the response body contains a newly created instance of [AdBreak](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak).\n\nAuthorization 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)."]]