Method: networks.assets.adBreaks.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
واجهة برمجة التطبيقات لإنشاء "فواصل إعلانية" ضمن البث المباشر
طلب HTTP
POST https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
يحدّد هذا الحقل LiveStreamEvent الذي يجب ربط فاصل الإعلان به باستخدام مفتاح مادة عرض البث المباشر. يجب أن يكون بالتنسيق "networks/{network_code}/assets/{asset_code}"
|
مَعلمات طلب البحث
| المعلمات |
customParent |
string
يحدّد هذا الحقل حدث LiveStreamEvent الذي يجب ربط فاصل الإعلان به باستخدام مفتاح مادة العرض المخصّص. يجب أن يكون بالتنسيق "networks/{network_code}/customAssets/{asset_code}".
|
content |
string
هذه طريقة بديلة لتحديد LiveStreamEvent، إذا كان مرتبطًا بقطعة محتوى ضمن "إدارة إعلانات Google". يجب أن يكون بالتنسيق "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"
|
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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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\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)."]]
