REST Resource: networks.sources.content.adBreaks
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: AdBreak
라이브 동영상 이벤트에서 광고 시점을 결정하는 데 사용되는 광고 시점 메타데이터입니다.
JSON 표현 |
{
"name": string,
"expectedDuration": string,
"customParams": string,
"scte35CueOut": string,
"podTemplateName": string,
"breakState": enum (BreakState )
} |
필드 |
name |
string
출력 전용입니다. 광고 시점의 리소스 이름입니다. 이 필드의 형식은 'networks//assets//adBreaks/'입니다. network_code는 콘텐츠가 속한 Google Ad Manager의 네트워크 코드입니다. asset_key는 광고 시점이 생성된 Google Ad Manage 실시간 스트림 이벤트의 키입니다. adBreakId는 광고 시점의 키입니다. 출력 전용.
|
expectedDuration |
string (Duration format)
필수 항목입니다. 예상 휴식 시간입니다. 소수점 아래가 최대 9자리까지이고 's '로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s" 입니다.
|
customParams |
string
Ad Manager의 맞춤 기준 타겟팅에 대한 이 광고 시간의 광고 요청에 포함될 키-값 쌍입니다. 예: 'key1=value&key2=value2,value22'
|
scte35CueOut |
string
scte35 큐 아웃에서 Base64로 인코딩된 데이터입니다. splice_insert() 또는 time_signal() 명령어를 포함할 수 있습니다. 예: - time_signal() 포함: “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - with splice_insert(): "/DAvAAAAAAAAAA///wFAVIAACPf+4+AAADVKu1AL
|
podTemplateName |
string
Google Ad Manager 광고 모음 템플릿 이름입니다.
|
breakState |
enum (BreakState )
광고 시점의 현재 상태입니다.
|
메서드 |
|
API를 사용하여 라이브 스트림 내에 광고 시점을 만듭니다. |
|
API를 사용하여 라이브 스트림 내의 광고 시점을 나열합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eAdBreak is metadata used to manage ad breaks within live video events for ad decisioning.\u003c/p\u003e\n"],["\u003cp\u003eIt features attributes like name, expected duration, custom parameters, SCTE-35 cue-out, pod template name, and break state.\u003c/p\u003e\n"],["\u003cp\u003eYou can create and list AdBreaks using the provided API methods.\u003c/p\u003e\n"]]],["Ad Break metadata defines ad decision criteria for live video events. Key information includes the `name` (resource identifier), `expectedDuration` (in seconds), `customParams` (key-value targeting), `scte35CueOut` (Base64 encoded data), `podTemplateName`, and `breakState` (current state). The `create` method allows for creating ad breaks, and `list` allows for viewing them. The Ad break has a defined structure using a JSON representation.\n"],null,["# REST Resource: networks.sources.content.adBreaks\n\n- [Resource: AdBreak](#AdBreak)\n - [JSON representation](#AdBreak.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AdBreak\n-----------------\n\nAd break metadata used to decision ads for an ad break in a live video event.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"expectedDuration\": string, \"customParams\": string, \"scte35CueOut\": string, \"podTemplateName\": string, \"breakState\": enum (/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState) } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the Ad Break. This field will have the format of \"networks//assets//adBreaks/\". network_code is the network code in Google Ad Manager to which this content belongs. asset_key is the key of the Live Stream Event in Google Ad Manage under which the Ad Break was created. adBreakId is the key of the Ad Break. OUTPUT ONLY. |\n| `expectedDuration` | `string (`[Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)` format)` Required. Expected break duration. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `customParams` | `string` Key-value pairs to be included on ad requests for this break for custom criteria targeting in Ad Manager. Example: 'key1=value\\&key2=value2,value22' |\n| `scte35CueOut` | `string` Base 64 encoded data from the scte35 cue out. May include splice_insert() or time_signal() command. Examples: - with time_signal(): \"/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==\" - with splice_insert(): \"/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=\" |\n| `podTemplateName` | `string` Google Ad Manager pod template name. |\n| `breakState` | `enum (`[BreakState](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState)`)` The current state of the Ad Break. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------|---------------------------------------------------|\n| ### [create](/ad-manager/video/rest/v1/networks.sources.content.adBreaks/create) | API to create an Ad Break within the live stream. |\n| ### [list](/ad-manager/video/rest/v1/networks.sources.content.adBreaks/list) | API to list Ad Breaks within the live stream. |"]]