REST Resource: networks.sources.content.adBreaks

리소스: AdBreak

라이브 동영상 이벤트의 광고 시점에 대한 광고를 결정하는 데 사용되는 광고 시점 메타데이터입니다.

JSON 표현 
{
  "name": string,
  "createTime": string,
  "expectedDuration": string,
  "customParams": string,
  "scte35CueOut": string,
  "podTemplateName": string,
  "breakState": enum (BreakState),
  "expectedStartTime": string,
  "expireDuration": string,
  "breakSequence": string,
  "breakParams": {
    object (BreakParams)
  },
  "matchParams": {
    object (MatchParams)
  },
  "servedBreak": {
    object (ServedBreak)
  }
}
필드
name

string

출력 전용입니다. 광고 애드 브레이크의 리소스 이름입니다. 이 필드의 형식은 'networks//assets//adBreaks/'입니다.

network_code는 이 콘텐츠가 속한 Google Ad Manager의 네트워크 코드입니다.

asset_key는 광고 시점이 생성된 Google Ad Manager의 라이브 스트림 이벤트 키입니다.

adBreakId는 광고 시점의 키입니다. 출력 전용입니다.
createTime

string (Timestamp format)

출력 전용입니다. 광고 시점의 생성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
expectedDuration

string (Duration format)

필수 항목입니다. 예상 휴식 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
customParams
(deprecated)

string

선택사항입니다. Ad Manager의 맞춤 기준 타겟팅에 대한 광고 요청에 포함되는 키-값 쌍입니다. 예: 'key1=value&key2=value2,value22' 지원 중단됨: 'cust_params' 키를 사용하여 breakParams.ad_tag_params에서 cust_params를 설정하세요.
scte35CueOut

string

선택사항입니다. scte35 cue out에서 base64로 인코딩된 데이터입니다. splice_insert() 또는 time_signal() 명령어를 포함할 수 있습니다. 예: - time_signal() 사용: '/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==' - splice_insert() 사용: '/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
podTemplateName
(deprecated)

string

선택사항입니다. Google Ad Manager 광고 모음 템플릿 이름입니다. 지원 중단됨: 'ptpln' 키를 사용하여 breakParams.ad_tag_params에서 cust_params를 설정하세요.
breakState

enum (BreakState)

출력 전용입니다. 광고 시점의 현재 상태입니다.
expectedStartTime

string (Timestamp format)

선택사항입니다. 광고 시점의 예상 시작 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
expireDuration

string (Duration format)

선택사항입니다. expectedStartTime + expireDuration에서 광고 시점을 만료합니다. expectedStartTime이 설정되지 않은 경우 광고 시점은 결정이 시작된 후 expireDuration이 지나면 만료됩니다. 기본값: 30분 최솟값: 5분 최댓값: 6시간

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
breakSequence

string (int64 format)

출력 전용입니다. 광고 시점의 미드롤 시퀀스 ID입니다. mridx 키를 사용하여 breakParams.ad_tag_params를 통해 명시적으로 지정된 경우 여러 광고 시점의 breakSequence가 동일할 수 있습니다. 이렇게 하면 두 GAM 광고 시점이 효과적으로 연결됩니다.
breakParams

object (BreakParams)

선택사항입니다. 이 광고 요청에 포함할 광고 시점 매개변수입니다.
matchParams

object (MatchParams)

선택사항입니다. API를 통해 생성된 광고 시점이 매니페스트 내 광고 시점과 일치하는 방식을 결정하기 위해 스티치된 DAI에 사용됩니다. 새 광고 시점이 감지되면 breakState가 SCHEDULED 또는 DECISIONED인 이벤트의 모든 광고 시점에 대해 match 함수가 실행되어 광고 시점의 matchParams에 설정된 모든 매개변수가 감지된 광고 시점과 일치하는지 확인합니다. 다음 조건 중 하나가 충족되면 일치 항목이 발생합니다. 1. 광고 시점에는 matchParams 필드가 있으며 여기에 설정된 모든 매개변수가 새 광고 시점과 일치합니다. 2. 광고 시점이 DECISIONED이며 matchParams 필드가 없습니다.

실수로 '모두 일치' 동작 (비어 있지만 존재하는 matchParams에서 발생)이 발생하는 것을 방지하기 위해 matchParams는 설정된 경우 비어 있을 수 없습니다. 필드가 요청에 있는 경우 자체 필드 중 하나 이상이 설정되어야 합니다.

광고 시점은 다음 순서로 확인됩니다. 1. matchParams 사용, expectedStartTime 오름차순, createTime 오름차순(expectedStartTime이 없는 광고 시점은 정렬 시 우선순위가 높음) 2. matchParams 미사용, expectedStartTime 오름차순, createTime 오름차순(expectedStartTime이 없는 광고 시점은 정렬 시 우선순위가 높음)

대기 중인 모든 EABN이 일치하지 않으면 DAI는 다음 사용 가능한 미드롤 색인을 활용하는 JIT 결정 동작으로 대체됩니다.
servedBreak

object (ServedBreak)

출력 전용입니다. 게재된 광고 시점의 실제 정보를 반영합니다. COMPLETE breakState가 있는 광고 시점에만 설정됩니다.

메서드

create

 라이브 스트림 내에 광고 시점을 만드는 API

list

 라이브 스트림 내 광고 시점을 나열하는 API입니다.