Package google.ads.drx.video.v1

색인

VideoContentIngestionService

Google Ad Manager에서 동영상 콘텐츠 및 관련 메타데이터를 만들거나 업데이트할 수 있는 콘텐츠 처리 API 서비스입니다.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

새 콘텐츠를 만들거나 콘텐츠가 Ad Manager에 이미 있는 경우 메타데이터를 업데이트하는 API 성공 시 콘텐츠를 반환하고 실패 시 google.rpc.Code를 반환합니다.

요청 예시는 다음과 같습니다.

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ClosedCaptionFormat

자막 파일의 형식입니다.

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

ClosedCaptionUrlInfo

하나의 자막 파일의 메타데이터입니다.

필드
language_code

string

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

ClosedCaptionFormat

자막 파일의 형식입니다.
url

string

자막 파일의 URL입니다.

DynamicAdInsertionInfo

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

필드
video_ingest_url_info

VideoIngestUrlInfo

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

Timestamp

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

ClosedCaptionUrlInfo

자막 파일의 URL입니다.
fw_caid

string

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

GracenoteMetadata

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

필드
gracenote_id

string

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

string

선택사항입니다. 이 필드는 Gracenote 시리즈 ID를 참조합니다. 'SH'로 시작해야 합니다.

메타데이터

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

필드
key_values

map<string, Value>

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

SyndicatedVideoContentNames

모든 신디케이트 콘텐츠의 이름 목록입니다.

필드
syndicated_video_content[]

string

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

UpdateVideoContentRequest

[VideoContentIngestionService.UpdateVideoContentRequest][] 요청입니다.

필드
video_content

VideoContent

필수 항목입니다. 콘텐츠의 메타데이터입니다.

동영상 콘텐츠

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

필드
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는 Google Ad Manager의 CMS 콘텐츠 ID이며, Ad Manager에서 해당 동영상에 대해 어떤 광고를 게재할 수 있는지 파악하기 위해 광고 요청의 일부로 생성됩니다. 이 값은 숫자 또는 영숫자일 수 있습니다.
status

VideoContentStatus

콘텐츠의 상태입니다. 생략하면 기본값은 활성입니다.
title

string

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

Timestamp

필수 항목입니다. 콘텐츠의 마지막 수정 시간입니다.
publish_time

Timestamp

콘텐츠의 게시 시간입니다. 동영상이 시작 시간과 종료 시간을 지정하는 광고 규칙에 포함되도록 설계된 경우 이 필드는 필수입니다.
duration

Duration

콘텐츠의 재생 시간입니다. 기간은 밀리초 수준까지 지원됩니다.
cue_points[]

Duration

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

string

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

Metadata

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

GracenoteMetadata

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

VideoContentSyndicationInfo

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

DynamicAdInsertionInfo

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

VideoContentStatus

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

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

VideoContentSyndicationInfo

표준 콘텐츠와 신디케이트 콘텐츠 간의 관계를 지정하는 메타데이터입니다.

필드
통합 필드 syndication. VideoContentSyndicationMetadata에는 다음 중 하나만 포함될 수 있습니다. syndication은 다음 중 하나여야 합니다.
canonical_video_content

string

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

SyndicatedVideoContentNames

신디케이션 콘텐츠 모음

VideoFormat

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

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

VideoIngestUrlInfo

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

필드
video_format

VideoFormat

동영상의 형식입니다.
video_preconditioned

VideoPreconditioned

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

string

m3u8 파일 링크입니다.

VideoPreconditioned

동영상 콘텐츠의 컨디셔닝 상태입니다.

열거형
NO 아직 컨디셔닝되지 않았습니다.
YES 동영상이 컨디셔닝/분할되었습니다.