REST Resource: videoContent.networks.sources.content

리소스: VideoContent

콘텐츠의 메타데이터입니다.

JSON 표현
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
필드
name

string

출력 전용입니다. 동영상 콘텐츠의 리소스 이름입니다. 이 필드의 형식은 '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

enum (VideoContentStatus)

콘텐츠의 상태입니다. 생략할 경우 기본값이 활성화됩니다.

title

string

필수 항목입니다. 콘텐츠의 제목입니다.

updateTime

string (Timestamp format)

필수 항목입니다. 콘텐츠가 마지막으로 수정된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

publishTime

string (Timestamp format)

콘텐츠의 게시 시간입니다. 시작 및 종료 시간을 지정하는 광고 규칙에 동영상이 포함되도록 하려는 경우 필수 입력란입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

duration

string (Duration format)

콘텐츠의 길이입니다. 기간은 밀리초 단위까지 지원됩니다.

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

cuePoints[]

string (Duration format)

큐 포인트를 식별합니다. 큐 포인트는 동영상에 광고를 삽입할 수 있는 시간상의 위치입니다. 큐 포인트는 밀리초 수준까지 지원됩니다. 동영상에 미드롤 광고 시점이 포함된 경우 필수 입력란입니다.

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

thumbnailUrl

string

콘텐츠의 썸네일 URL입니다.

metadata

object (Metadata)

콘텐츠의 맞춤 메타데이터를 식별합니다.

gracenoteMetadata

object (GracenoteMetadata)

콘텐츠의 Gracenote 관련 메타데이터입니다.

syndicationMetadata

object (VideoContentSyndicationInfo)

콘텐츠의 신디케이션 관련 메타데이터입니다.

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

콘텐츠의 동적 광고 삽입 관련 메타데이터입니다.

VideoContentStatus

콘텐츠에 타겟팅된 광고를 게재하거나 게재하지 않을 상태 옵션입니다.

열거형
ACTIVE 콘텐츠 타겟팅 광고가 게재됩니다.
BLOCKED 상태가 차단됨인 경우 콘텐츠에 광고가 게재되지 않습니다.
DELETED 콘텐츠는 Ad Manager에 보관처리됩니다. Ad Manager가 삭제됨으로 표시된 콘텐츠에 대한 광고 요청을 받는 경우, 하우스 광고, 또는 인벤토리 단위나 기타 타겟팅 기준에 타겟팅된 광고는 여전히 해당 콘텐츠에 대해 게재될 수 있습니다. 광고를 차단하려면 상태를 차단됨으로 설정하세요.

메타데이터

콘텐츠의 맞춤 메타데이터입니다.

JSON 표현
{
  "keyValues": {
    string: value,
    ...
  }
}
필드
keyValues

map (key: string, value: value (Value format))

콘텐츠의 맞춤 메타데이터를 키-값 쌍으로 식별합니다. 문자열 또는 문자열 목록만 값에 허용됩니다.

GracenoteMetadata

콘텐츠의 Gracenote 메타데이터입니다.

JSON 표현
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
필드
gracenoteId

string

필수 항목입니다. 콘텐츠의 Gracenote ID를 나타냅니다. 유효한 프리픽스 중 하나가 있어야 합니다. 1. 'EP' - 시리즈 2의 에피소드 'MV' - 영화 3. 'SP' - 스포츠 이벤트

gracenoteSeriesId

string

선택사항입니다. 이 필드는 Gracenote 시리즈 ID를 나타냅니다. 프리픽스는 'SH'여야 합니다.

VideoContentSyndicationInfo

표준 콘텐츠와 배급 콘텐츠 간의 관계를 지정하기 위한 메타데이터입니다.

JSON 표현
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
필드
통합 필드 syndication. VideoContentSyndiationMetadata는 다음 중 하나만 포함할 수 있습니다. syndication은 다음 중 하나여야 합니다.
canonicalVideoContent

string

표준 콘텐츠의 이름입니다. 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' 형식이어야 합니다. 이 필드가 포함된 콘텐츠와 동일한 네트워크에 속해야 합니다.

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

신디케이션 콘텐츠 모음

SyndicatedVideoContentNames

모든 배급 콘텐츠의 이름 목록입니다.

JSON 표현
{
  "syndicatedVideoContent": [
    string
  ]
}
필드
syndicatedVideoContent[]

string

신디케이션 콘텐츠 이름의 반복되는 입력란입니다. 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' 형식이어야 합니다. 이 필드가 포함된 콘텐츠와 동일한 네트워크에 속해야 합니다.

DynamicAdInsertionInfo

동적 광고 삽입과 관련된 정보입니다.

JSON 표현
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
필드
videoIngestUrlInfo

object (VideoIngestUrlInfo)

컨디셔닝 및 재생목록 생성에 사용되는 마스터 m3u8 파일의 링크입니다.

mediaUpdateTime

string (Timestamp format)

videoCollectUrlInfo에서 참조된 동영상 파일이 마지막으로 수정된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

자막 파일의 URL입니다.

fwCaid

string

광고 타겟팅에 사용되는 Freewheel 맞춤 애셋 ID입니다.

VideoIngestUrlInfo

컨디셔닝 및 재생목록 생성에 사용되는 m3u8 파일의 링크를 지정하는 메타데이터입니다.

JSON 표현
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
필드
videoFormat

enum (VideoFormat)

동영상의 형식입니다.

videoPreconditioned

enum (VideoPreconditioned)

콘텐츠가 이미 미드롤 광고용으로 컨디셔닝되었는지 여부를 나타냅니다. 즉, 광고 시점에 세그먼트가 이미 분할되어 있습니다.

url

string

m3u8 파일 링크

VideoFormat

동영상 콘텐츠를 인코딩할 수 있는 형식입니다.

열거형
VIDEO_FORMAT_UNSPECIFIED 동영상 형식이 지정되지 않았습니다.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

동영상 콘텐츠의 조건 지정 상태입니다.

열거형
NO 아직 조건이 지정되지 않았습니다.
YES 동영상이 컨디셔닝/스플리팅되었습니다.

ClosedCaptionUrlInfo

자막 파일 1개에 대한 메타데이터입니다.

JSON 표현
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
필드
languageCode

string

자막 파일의 언어를 나타내는 IETF BCP-47 언어 코드입니다.

closedCaptionFormat

enum (ClosedCaptionFormat)

자막 파일의 형식입니다.

url

string

자막 파일의 URL입니다.

ClosedCaptionFormat

자막 파일의 형식입니다.

열거형
CLOSED_CAPTION_FORMAT_UNSPECIFIED 자막 형식이 지정되지 않았습니다.
TTML application/ttaf+xml
WEB_VTT text/vtt

메서드

update

API를 사용하여 새 콘텐츠를 생성하거나 해당 콘텐츠가 이미 Ad Manager에 있는 경우 메타데이터를 업데이트할 수 있습니다.