Method: networks.sources.content.adBreaks.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
API برای ایجاد یک Ad Break در جریان زنده.
درخواست HTTP
POST https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
content | string این یک راه جایگزین برای شناسایی LiveStreamEvent است، اگر با محتوایی در GAM مرتبط باشد. باید فرمت "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" را داشته باشد. |
پارامترهای پرس و جو
| پارامترها |
|---|
parent | string این فیلد LiveStreamEvent را مشخص می کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی پخش جریانی زنده به آن مرتبط شود. باید فرمت "networks/{network_code}/assets/{asset_code}" را داشته باشد. |
customParent | string این فیلد LiveStreamEvent را مشخص می‌کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی سفارشی مرتبط شود. باید فرمت "networks/{network_code}/customAssets/{asset_code}" را داشته باشد. |
adBreakId | string این adBreakId است که کاربران می توانند از طریق درخواست ارائه کنند. |
درخواست بدن
بدنه درخواست شامل یک نمونه از AdBreak است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از AdBreak است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/contentingestion -
https://www.googleapis.com/auth/video-ads
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
،
API برای ایجاد یک Ad Break در جریان زنده.
درخواست HTTP
POST https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
content | string این یک راه جایگزین برای شناسایی LiveStreamEvent است، اگر با محتوایی در GAM مرتبط باشد. باید فرمت "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" را داشته باشد. |
پارامترهای پرس و جو
| پارامترها |
|---|
parent | string این فیلد LiveStreamEvent را مشخص می کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی پخش جریانی زنده به آن مرتبط شود. باید فرمت "networks/{network_code}/assets/{asset_code}" را داشته باشد. |
customParent | string این فیلد LiveStreamEvent را مشخص می‌کند که این وقفه تبلیغاتی باید با استفاده از کلید دارایی سفارشی مرتبط شود. باید فرمت "networks/{network_code}/customAssets/{asset_code}" را داشته باشد. |
adBreakId | string این adBreakId است که کاربران می توانند از طریق درخواست ارائه کنند. |
درخواست بدن
بدنه درخواست شامل یک نمونه از AdBreak است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از AdBreak است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/contentingestion -
https://www.googleapis.com/auth/video-ads
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
