Method: networks.customAssets.adBreaks.list
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
API สำหรับแสดงช่วงพักโฆษณาภายในไลฟ์สด
คำขอ HTTP
GET https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks
URL ใช้ไวยากรณ์การแปลงรหัส 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}"
|
pageSize |
integer
ไม่บังคับ จำนวนช่วงพักโฆษณาสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงพักโฆษณาสูงสุด 10 รายการ ค่าสูงสุดคือ 100 และค่าที่สูงกว่า 100 จะถูกบังคับให้เป็น 100
|
pageToken |
string
ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ adBreaks.list ก่อนหน้า ระบุข้อมูลนี้เพื่อดึงข้อมูลหน้าถัดไป เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ adBreaks.list ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ
|
เนื้อความของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ListAdBreaksResponse
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-21 UTC
[null,null,["อัปเดตล่าสุด 2025-08-21 UTC"],[[["\u003cp\u003eThis API allows you to retrieve a list of ad breaks associated with a live stream event using either a custom asset key, a live stream asset key, or a content ID within Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify optional parameters such as parent, content, pageSize, and pageToken to filter and paginate the results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful response will contain a ListAdBreaksResponse object.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API, you will need authorization with either the \u003ccode\u003ehttps://www.googleapis.com/auth/contentingestion\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/video-ads\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: networks.customAssets.adBreaks.list\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 list Ad Breaks within the live stream.\n\n### HTTP request\n\n`GET 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` Optional. 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` Optional. 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` Optional. 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| `pageSize` | `integer` Optional. The maximum number of ad breaks to return. The service may return fewer than this value. If unspecified, at most 10 ad breaks will be returned. The maximum value is 100; values above 100 will be coerced to 100. |\n| `pageToken` | `string` Optional. A page token, received from a previous `adBreaks.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `adBreaks.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListAdBreaksResponse](/ad-manager/video/rest/v1/ListAdBreaksResponse).\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)."]]
