REST Resource: adBreak.networks.assets.adBreaks

리소스: AdBreak
메서드

리소스: AdBreak

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

JSON 표현

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,
  "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가 있는 광고 시점에만 설정됩니다.

BreakState

광고 시점의 상태입니다.

열거형
`BREAK_STATE_UNSPECIFIED`	광고 시점 상태를 알 수 없습니다.
`BREAK_STATE_DECISIONED`	광고 시점 결정이 시작되었지만 아직 사용자에게 제공되지 않았습니다.
`BREAK_STATE_COMPLETE`	광고 시점이 사용자에게 제공되었습니다.
`BREAK_STATE_SCHEDULED`	광고 시점이 결정되도록 예약되어 있습니다.
`BREAK_STATE_EXPIRED`	광고 시점이 만료되어 사용할 수 없습니다. 기본적으로 광고 시점은 expectedStartTime 후 30분 또는 expectedStartTime이 설정되지 않은 경우 광고 시점 시작 결정 후 30분이 지나면 만료됩니다. 만료는 expireDuration 필드를 사용하여 명시적으로 설정할 수 있습니다.

BreakParams

광고 시점과 연결된 매개변수입니다.

JSON 표현
{ "macros": [ { object (`KeyValue`) } ], "adTagParams": [ { object (`KeyValue`) } ] }

필드

필드
`macros[]`	`object (KeyValue)` 선택사항입니다. 광고 태그의 임의 자리표시자를 대체하는 맞춤 매크로 값입니다. 광고 요청 시 DAI는 `%%DAI_PATTERN:[MACRO_KEY]%%` 형식의 광고 태그 매크로를 확장합니다. 여기서 `MACRO_KEY`은 키입니다. 설정된 경우 이러한 매크로는 포드 제공 요청에 설정된 매크로보다 우선합니다.
`adTagParams[]`	`object (KeyValue)` 선택사항입니다. 기본 광고 요청의 광고 태그 매개변수를 재정의합니다. 이는 cust_params가 설정된 포드 게재 요청 전에 트리거되는 경우 의사결정에 사용됩니다. 일반적으로 매개변수는 광고 시점의 기본 광고 요청에 있는 쿼리 문자열 매개변수를 재정의합니다. 맞춤 URL 형식이 있는 일부 광고 서버의 경우 매개변수가 광고 서버 요구사항을 준수하기 위해 광고 태그의 특정 위치를 재정의할 수 있습니다. AdBreak에서 'mridx' 값을 설정하면 유효한 양의 정수인 경우 제공된 값으로 breakSequence 필드가 재정의됩니다. GAM 이외의 광고 서버도 마찬가지입니다. 이 매개변수를 설정하면 포드 제공 요청에 설정된 매개변수보다 우선 적용됩니다.

macros[]

object (KeyValue)

선택사항입니다. 광고 태그의 임의 자리표시자를 대체하는 맞춤 매크로 값입니다. 광고 요청 시 DAI는 %%DAI_PATTERN:[MACRO_KEY]%% 형식의 광고 태그 매크로를 확장합니다. 여기서 MACRO_KEY은 키입니다.

설정된 경우 이러한 매크로는 포드 제공 요청에 설정된 매크로보다 우선합니다.

adTagParams[]

object (KeyValue)

선택사항입니다. 기본 광고 요청의 광고 태그 매개변수를 재정의합니다.

이는 cust_params가 설정된 포드 게재 요청 전에 트리거되는 경우 의사결정에 사용됩니다.

일반적으로 매개변수는 광고 시점의 기본 광고 요청에 있는 쿼리 문자열 매개변수를 재정의합니다. 맞춤 URL 형식이 있는 일부 광고 서버의 경우 매개변수가 광고 서버 요구사항을 준수하기 위해 광고 태그의 특정 위치를 재정의할 수 있습니다. AdBreak에서 'mridx' 값을 설정하면 유효한 양의 정수인 경우 제공된 값으로 breakSequence 필드가 재정의됩니다. GAM 이외의 광고 서버도 마찬가지입니다.

이 매개변수를 설정하면 포드 제공 요청에 설정된 매개변수보다 우선 적용됩니다.

KeyValue

키-값 쌍을 나타냅니다.

JSON 표현
{ "key": string, "value": string }

필드

필드
`key`	`string` 필수 항목입니다. 이 키-값 쌍의 키입니다.
`value`	`string` 필수 항목입니다. 이 키-값 쌍의 값입니다.

key

string

필수 항목입니다. 이 키-값 쌍의 키입니다.

value

string

필수 항목입니다. 이 키-값 쌍의 값입니다.

MatchParams

감지된 병합 DAI 광고 시점과 일치하는 매개변수입니다.

JSON 표현
{ "scte35Binary": string, "scte35Upid": string, "scte35EventId": integer, "breakDuration": boolean }

필드
`scte35Binary`	`string` 선택사항입니다. SCTE-35 바이너리입니다. 이 필드를 일치시키려면 매니페스트 내 광고 시점에 동일한 SCTE-35 바이너리 문자열 (base64로 인코딩됨)이 있어야 합니다. 비어 있으면 건너뜁니다.
`scte35Upid`	`string` 선택사항입니다. SCTE-35 UPID (고유 프로그램 식별자) 이 필드와 일치하려면 매니페스트 내 광고 시점에 동일한 SCTE-35 UPID가 있어야 합니다. UPID는 SCTE-35 바이너리에서 파싱된 값입니다. 비어 있으면 건너뜁니다.
`scte35EventId`	`integer (uint32 format)` 선택사항입니다. SCTE-35 이벤트 ID입니다. 이 필드를 일치시키려면 매니페스트 내 광고 시점에 이벤트 ID (스플라이스 이벤트 ID/세분화 이벤트 ID)가 동일해야 합니다. 이벤트 ID는 SCTE-35 바이너리에서 파싱된 값입니다. 비어 있으면 건너뜁니다.
`breakDuration`	`boolean` 선택사항입니다. 휴식 시간입니다. 이 필드와 일치하려면 매니페스트 내 광고 시점의 시점 지속 시간이 광고 시점의 expectedDuration과 동일해야 하며 허용 오차는 1ms입니다. false인 경우 건너뜁니다.

ServedBreak

게재된 광고 시점의 실제 정보를 나타냅니다.

JSON 표현
{ "breakDetectTime": string, "detectedDuration": string, "scte35CueOut": string }

필드

필드
`breakDetectTime`	`string (Timestamp format)` 출력 전용입니다. 일치하는 광고 시점이 감지된 시간입니다. 포드 게재의 경우 광고 포드의 첫 번째 세그먼트/매니페스트가 요청되는 시간입니다. 스티치 DAI의 경우 광고 시점이 매니페스트에서 처음 감지된 시간입니다. 생성된 출력은 항상 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"`입니다.
`detectedDuration`	`string (Duration format)` 출력 전용입니다. 일치하는 광고 시점에 전달된 감지된 지속 시간입니다. 소수점 아래가 최대 9자리까지이고 '`s`'로 끝나는 초 단위 기간입니다. 예를 들면 `"3.5s"`입니다.
`scte35CueOut`	`string` 출력 전용입니다. 일치하는 광고 시점에서 전달된 감지된 base64로 인코딩된 SCTE-35 메시지입니다.

breakDetectTime

string (Timestamp format)

출력 전용입니다. 일치하는 광고 시점이 감지된 시간입니다. 포드 게재의 경우 광고 포드의 첫 번째 세그먼트/매니페스트가 요청되는 시간입니다. 스티치 DAI의 경우 광고 시점이 매니페스트에서 처음 감지된 시간입니다.

생성된 출력은 항상 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"입니다.

detectedDuration

string (Duration format)

출력 전용입니다. 일치하는 광고 시점에 전달된 감지된 지속 시간입니다.

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

scte35CueOut

string

출력 전용입니다. 일치하는 광고 시점에서 전달된 감지된 base64로 인코딩된 SCTE-35 메시지입니다.

메서드
`create`	라이브 스트림 내에 광고 시점을 만드는 API
`delete`	라이브 스트림 내 광고 시점을 삭제하는 API
`get`	라이브 스트림 내에서 광고 시점을 가져오는 API입니다.
`list`	라이브 스트림 내 광고 시점을 나열하는 API입니다.
`patch`	실시간 스트림 내 광고 시점을 업데이트하는 API입니다.

REST Resource: adBreak.networks.assets.adBreaks

리소스: AdBreak

BreakState

BreakParams

KeyValue

MatchParams

ServedBreak

메서드

`create`

`delete`

`get`

`list`

`patch`

REST Resource: adBreak.networks.assets.adBreaks 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

리소스: AdBreak

BreakState

BreakParams

KeyValue

MatchParams

ServedBreak

메서드

create

delete

get

list

patch

REST Resource: adBreak.networks.assets.adBreaks

`create`

`delete`

`get`

`list`

`patch`