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
선택사항입니다. GAM 내 콘텐츠와 연결된 경우 LiveStreamEvent를 식별하는 대체 방법입니다. '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 개요를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)."]]
