Method: networks.customAssets.adBreaks.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
customParent |
string
這個欄位會使用自訂素材資源金鑰,識別廣告插播應與哪個 LiveStreamEvent 建立關聯。格式必須為「networks/{network_code}/customAssets/{asset_code}」
|
查詢參數
參數 |
parent |
string
這個欄位會使用直播活動素材資源金鑰,識別廣告插播應與哪個 LiveStreamEvent 建立關聯。格式必須為「networks/{network_code}/assets/{asset_code}」
|
content |
string
如果 LiveStreamEvent 與 GAM 中的內容相關聯,這是識別該活動的替代方式。格式為「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」
|
adBreakId |
string
這是使用者可透過要求提供的 adBreakId。
|
回應主體
如果成功,回應主體會包含新建立的 AdBreak
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
詳情請參閱 OAuth 2.0 總覽。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[null,null,["上次更新時間:2025-08-21 (世界標準時間)。"],[[["\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)."]]