- 리소스: VideoContent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VideoContentStatus
- 메타데이터
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- GracenoteMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VideoContentSyndicationInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SyndicatedVideoContentNames
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- DynamicAdInsertionInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VideoIngestUrlInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VideoFormat
- VideoPreconditioned
- ClosedCaptionUrlInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ClosedCaptionFormat
- 메서드
리소스: VideoContent
콘텐츠의 메타데이터입니다.
JSON 표현 |
---|
{ "name": string, "status": enum ( |
필드 | |
---|---|
name |
출력 전용입니다. 동영상 콘텐츠의 리소스 이름입니다. 이 필드의 형식은 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'입니다. network_code는 콘텐츠가 속한 Google Ad Manager의 네트워크 코드입니다. content_source_id는 이 콘텐츠가 속해야 하는 Google Ad Manager의 콘텐츠 소스 ID입니다. cms_content_id는 Ad Manager의 CMS 콘텐츠 ID로, Ad Manager에서 해당 동영상에 대해 어떤 광고를 게재할 수 있는지 식별하기 위해 광고 요청의 일부로 생성됩니다. 이 값은 숫자 또는 영숫자일 수 있습니다. |
status |
콘텐츠의 상태입니다. 생략할 경우 기본값이 활성화됩니다. |
title |
필수 항목입니다. 콘텐츠의 제목입니다. |
updateTime |
필수 항목입니다. 콘텐츠가 마지막으로 수정된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
publishTime |
콘텐츠의 게시 시간입니다. 시작 및 종료 시간을 지정하는 광고 규칙에 동영상이 포함되도록 하려는 경우 필수 입력란입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
duration |
콘텐츠의 길이입니다. 기간은 밀리초 단위까지 지원됩니다. 소수점 아래가 최대 9자리까지이고 ' |
cuePoints[] |
큐 포인트를 식별합니다. 큐 포인트는 동영상에 광고를 삽입할 수 있는 시간상의 위치입니다. 큐 포인트는 밀리초 수준까지 지원됩니다. 동영상에 미드롤 광고 시점이 포함된 경우 필수 입력란입니다. 소수점 아래가 최대 9자리까지이고 ' |
thumbnailUrl |
콘텐츠의 썸네일 URL입니다. |
metadata |
콘텐츠의 맞춤 메타데이터를 식별합니다. |
gracenoteMetadata |
콘텐츠의 Gracenote 관련 메타데이터입니다. |
syndicationMetadata |
콘텐츠의 신디케이션 관련 메타데이터입니다. |
dynamicAdInsertionMetadata |
콘텐츠의 동적 광고 삽입 관련 메타데이터입니다. |
VideoContentStatus
콘텐츠에 타겟팅된 광고를 게재하거나 게재하지 않을 상태 옵션입니다.
열거형 | |
---|---|
ACTIVE |
콘텐츠 타겟팅 광고가 게재됩니다. |
BLOCKED |
상태가 차단됨인 경우 콘텐츠에 광고가 게재되지 않습니다. |
DELETED |
콘텐츠는 Ad Manager에 보관처리됩니다. Ad Manager가 삭제됨으로 표시된 콘텐츠에 대한 광고 요청을 받는 경우, 하우스 광고, 또는 인벤토리 단위나 기타 타겟팅 기준에 타겟팅된 광고는 여전히 해당 콘텐츠에 대해 게재될 수 있습니다. 광고를 차단하려면 상태를 차단됨으로 설정하세요. |
메타데이터
콘텐츠의 맞춤 메타데이터입니다.
JSON 표현 |
---|
{ "keyValues": { string: value, ... } } |
필드 | |
---|---|
keyValues |
콘텐츠의 맞춤 메타데이터를 키-값 쌍으로 식별합니다. 문자열 또는 문자열 목록만 값에 허용됩니다. |
GracenoteMetadata
콘텐츠의 Gracenote 메타데이터입니다.
JSON 표현 |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
필드 | |
---|---|
gracenoteId |
필수 항목입니다. 콘텐츠의 Gracenote ID를 나타냅니다. 유효한 프리픽스 중 하나가 있어야 합니다. 1. 'EP' - 시리즈 2의 에피소드 'MV' - 영화 3. 'SP' - 스포츠 이벤트 |
gracenoteSeriesId |
선택사항입니다. 이 필드는 Gracenote 시리즈 ID를 나타냅니다. 프리픽스는 'SH'여야 합니다. |
VideoContentSyndicationInfo
표준 콘텐츠와 배급 콘텐츠 간의 관계를 지정하기 위한 메타데이터입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 syndication . VideoContentSyndiationMetadata는 다음 중 하나만 포함할 수 있습니다. syndication 은 다음 중 하나여야 합니다. |
|
canonicalVideoContent |
표준 콘텐츠의 이름입니다. 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' 형식이어야 합니다. 이 필드가 포함된 콘텐츠와 동일한 네트워크에 속해야 합니다. |
syndicatedVideoContentNames |
신디케이션 콘텐츠 모음 |
SyndicatedVideoContentNames
모든 배급 콘텐츠의 이름 목록입니다.
JSON 표현 |
---|
{ "syndicatedVideoContent": [ string ] } |
필드 | |
---|---|
syndicatedVideoContent[] |
신디케이션 콘텐츠 이름의 반복되는 입력란입니다. 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' 형식이어야 합니다. 이 필드가 포함된 콘텐츠와 동일한 네트워크에 속해야 합니다. |
DynamicAdInsertionInfo
동적 광고 삽입과 관련된 정보입니다.
JSON 표현 |
---|
{ "videoIngestUrlInfo": { object ( |
필드 | |
---|---|
videoIngestUrlInfo |
컨디셔닝 및 재생목록 생성에 사용되는 마스터 m3u8 파일의 링크입니다. |
mediaUpdateTime |
videoCollectUrlInfo에서 참조된 동영상 파일이 마지막으로 수정된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
closedCaptionUrlInfo[] |
자막 파일의 URL입니다. |
fwCaid |
광고 타겟팅에 사용되는 Freewheel 맞춤 애셋 ID입니다. |
VideoIngestUrlInfo
컨디셔닝 및 재생목록 생성에 사용되는 m3u8 파일의 링크를 지정하는 메타데이터입니다.
JSON 표현 |
---|
{ "videoFormat": enum ( |
필드 | |
---|---|
videoFormat |
동영상의 형식입니다. |
videoPreconditioned |
콘텐츠가 이미 미드롤 광고용으로 컨디셔닝되었는지 여부를 나타냅니다. 즉, 광고 시점에 세그먼트가 이미 분할되어 있습니다. |
url |
m3u8 파일 링크 |
VideoFormat
동영상 콘텐츠를 인코딩할 수 있는 형식입니다.
열거형 | |
---|---|
VIDEO_FORMAT_UNSPECIFIED |
동영상 형식이 지정되지 않았습니다. |
HLS |
application/x-mpegURL |
DASH |
application/dash+xml |
VideoPreconditioned
동영상 콘텐츠의 조건 지정 상태입니다.
열거형 | |
---|---|
NO |
아직 조건이 지정되지 않았습니다. |
YES |
동영상이 컨디셔닝/스플리팅되었습니다. |
ClosedCaptionUrlInfo
자막 파일 1개에 대한 메타데이터입니다.
JSON 표현 |
---|
{
"languageCode": string,
"closedCaptionFormat": enum ( |
필드 | |
---|---|
languageCode |
자막 파일의 언어를 나타내는 IETF BCP-47 언어 코드입니다. |
closedCaptionFormat |
자막 파일의 형식입니다. |
url |
자막 파일의 URL입니다. |
ClosedCaptionFormat
자막 파일의 형식입니다.
열거형 | |
---|---|
CLOSED_CAPTION_FORMAT_UNSPECIFIED |
자막 형식이 지정되지 않았습니다. |
TTML |
application/ttaf+xml |
WEB_VTT |
text/vtt |
메서드 |
|
---|---|
|
API를 사용하여 새 콘텐츠를 생성하거나 해당 콘텐츠가 이미 Ad Manager에 있는 경우 메타데이터를 업데이트할 수 있습니다. |