이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Package google.ads.drx.video.v1

색인

AdBreakNotificationService(인터페이스)
VideoContentIngestionService(인터페이스)
AdBreak(메시지)
AdBreak.BreakState(열거형)
ClosedCaptionFormat(열거형)
ClosedCaptionUrlInfo(메시지)
CreateAdBreakRequest(메시지)
DynamicAdInsertionInfo(메시지)
GracenoteMetadata(메시지)
ListAdBreaksRequest(메시지)
ListAdBreaksResponse(메시지)
Metadata(메시지)
SyndicatedVideoContentNames(메시지)
UpdateVideoContentRequest(메시지)
VideoContent(메시지)
VideoContentStatus(열거형)
VideoContentSyndicationInfo(메시지)
VideoFormat(열거형)
VideoIngestUrlInfo(메시지)
VideoPreconditioned(열거형)

AdBreakNotificationService

게시자가 라이브 스트림 내에서 광고 시점을 만들 수 있는 API 서비스입니다.

CreateAdBreak

CreateAdBreak
`rpc CreateAdBreak(CreateAdBreakRequest) returns (AdBreak)` 라이브 스트림 내에서 광고 시점을 만드는 API입니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. `https://www.googleapis.com/auth/contentingestion` `https://www.googleapis.com/auth/video-ads` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc CreateAdBreak(CreateAdBreakRequest) returns (AdBreak)

라이브 스트림 내에서 광고 시점을 만드는 API입니다.

승인 범위

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

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

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

ListAdBreaks

ListAdBreaks
`rpc ListAdBreaks(ListAdBreaksRequest) returns (ListAdBreaksResponse)` API를 사용하여 라이브 스트림 내의 광고 시점을 나열합니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. `https://www.googleapis.com/auth/contentingestion` `https://www.googleapis.com/auth/video-ads` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ListAdBreaks(ListAdBreaksRequest) returns (ListAdBreaksResponse)

API를 사용하여 라이브 스트림 내의 광고 시점을 나열합니다.

승인 범위

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

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

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

VideoContentIngestionService

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

UpdateVideoContent

UpdateVideoContent
`rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)` API를 사용하여 새 콘텐츠를 생성하거나 해당 콘텐츠가 이미 Ad Manager에 있는 경우 메타데이터를 업데이트할 수 있습니다. 성공 시 콘텐츠를 반환하고 실패 시 `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 개요를 참고하세요.

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API를 사용하여 새 콘텐츠를 생성하거나 해당 콘텐츠가 이미 Ad Manager에 있는 경우 메타데이터를 업데이트할 수 있습니다. 성공 시 콘텐츠를 반환하고 실패 시 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 개요를 참고하세요.

AdBreak

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

필드
`name`	`string` 출력 전용입니다. 광고 시점의 리소스 이름입니다. 이 필드의 형식은 'networks//assets//adBreaks/'입니다. network_code는 이 콘텐츠가 속한 Google Ad Manager의 네트워크 코드입니다. asset_key는 광고 시점이 생성된 Google Ad Manager의 라이브 스트림 이벤트 키입니다. ad_break_id는 광고 시점의 키입니다. 출력 전용.
`expected_duration`	`Duration` 필수 항목입니다. 예상 휴식 시간입니다.
`custom_params`	`string` Ad Manager의 맞춤 기준 타겟팅에 대한 광고 요청에 포함되는 키-값 쌍입니다. 예: 'key1=value&key2=value2,value22'
`scte_35_cue_out`	`string` scte35 큐 아웃에서 Base64로 인코딩된 데이터입니다. splice_insert() 또는 time_signal() 명령어를 포함할 수 있습니다. 예: - time_signal() 사용: “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - splice_insert() 사용: "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
`pod_template_name`	`string` Google Ad Manager 포드 템플릿 이름입니다.
`break_state`	`BreakState` 광고 시점의 현재 상태입니다.

BreakState

광고 시점의 상태입니다.

열거형
`BREAK_STATE_UNSPECIFIED`	광고 시점 상태를 알 수 없습니다.
`BREAK_STATE_DECISIONED`	광고 시점 결정이 시작되었지만 아직 사용자에게 전달되지 않았습니다.
`BREAK_STATE_COMPLETE`	광고 시점이 사용자에게 전송되었습니다.

ClosedCaptionFormat

자막 파일의 형식입니다.

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

ClosedCaptionUrlInfo

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

필드

필드
`language_code`	`string` 자막 파일의 언어를 나타내는 IETF BCP-47 언어 코드입니다.
`closed_caption_format`	`ClosedCaptionFormat` 자막 파일의 형식입니다.
`url`	`string` 자막 파일의 URL입니다.

language_code

string

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

closed_caption_format

ClosedCaptionFormat

자막 파일의 형식입니다.

url

string

자막 파일의 URL입니다.

CreateAdBreakRequest

AdBreakNotificationService.CreateAdBreak을 요청합니다.

필드
`parent`	`string` 이 필드는 이 광고 시점이 라이브 스트림 애셋 키를 사용하여 연결되어야 하는 LiveStreamEvent를 식별합니다. 'networks/{network_code}/assets/{asset_code}' 형식이어야 합니다.
`custom_parent`	`string` 이 필드는 이 광고 시점이 맞춤 애셋 키를 사용하여 연결되어야 하는 LiveStreamEvent를 식별합니다. 'networks/{network_code}/customAssets/{asset_code}' 형식이어야 합니다.
`content`	`string` 이는 LiveStreamEvent가 GAM 내의 일부 콘텐츠와 연결된 경우 이 이벤트를 식별하는 또 다른 방법입니다. 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' 형식이어야 합니다.
`ad_break`	`AdBreak` 필수 항목입니다. 실제 광고 시점입니다.
`ad_break_id`	`string` 사용자가 요청을 통해 제공할 수 있는 ad_break_id입니다.

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'여야 합니다.

ListAdBreaksRequest

AdBreakNotificationService.ListAdBreaks을 요청합니다.

필드
`parent`	`string` 선택사항입니다. 이 필드는 이 광고 시점이 라이브 스트림 애셋 키를 사용하여 연결되어야 하는 LiveStreamEvent를 식별합니다. 'networks/{network_code}/assets/{asset_code}' 형식이어야 합니다.
`custom_parent`	`string` 선택사항입니다. 이 필드는 이 광고 시점이 맞춤 애셋 키를 사용하여 연결되어야 하는 LiveStreamEvent를 식별합니다. 'networks/{network_code}/customAssets/{asset_code}' 형식이어야 합니다.
`content`	`string` 선택사항입니다. 이 방법은 LiveStreamEvent가 GAM 내의 일부 콘텐츠와 연결된 경우 LiveStreamEvent를 식별하는 또 다른 방법입니다. 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' 형식이어야 합니다.
`page_size`	`int32` 선택사항입니다. 반환할 최대 광고 시점 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 10개의 광고 시점이 반환됩니다. 최댓값은 100이며, 100을 초과하는 값은 100으로 변환됩니다.
`page_token`	`string` 선택사항입니다. 이전 `ListAdBreaks` 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 `ListAdBreaks`에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListAdBreaksResponse

AdBreakNotificationService.ListAdBreaks에 대한 응답입니다.

필드

필드
`ad_breaks[]`	`AdBreak` 출력 전용입니다. 요청된 LiveStreamEvent와 일치하는 광고 시점 목록입니다.
`next_page_token`	`string` 다음 페이지를 검색하기 위해 `page_token`으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ad_breaks[]

AdBreak

출력 전용입니다. 요청된 LiveStreamEvent와 일치하는 광고 시점 목록입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

메타데이터

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

필드

key_values

map<string, Value>

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

SyndicatedVideoContentNames

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

필드

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

syndicated_video_content[]

string

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

UpdateVideoContentRequest

[VideoContentCollectionService.UpdateVideoContentRequest][]에 대한 요청입니다.

필드

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

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가 삭제됨으로 표시된 콘텐츠에 대한 광고 요청을 받는 경우, 하우스 광고, 또는 인벤토리 단위나 기타 타겟팅 기준에 타겟팅된 광고는 여전히 해당 콘텐츠에 대해 게재될 수 있습니다. 광고를 차단하려면 상태를 차단됨으로 설정하세요.

VideoContentSyndicationInfo

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

필드

필드
통합 필드 `syndication`. VideoContentSyndiationMetadata는 다음 중 하나만 포함할 수 있습니다. `syndication`은 다음 중 하나여야 합니다.
`canonical_video_content`	`string` 표준 콘텐츠의 이름입니다. 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' 형식이어야 하며 이 필드가 포함된 콘텐츠와 동일한 네트워크에 속해야 합니다.
`syndicated_video_content_names`	`SyndicatedVideoContentNames` 배급되는 콘텐츠 모음

통합 필드 syndication. VideoContentSyndiationMetadata는 다음 중 하나만 포함할 수 있습니다. 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 파일 링크

video_format

VideoFormat

동영상의 형식입니다.

video_preconditioned

VideoPreconditioned

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

url

string

m3u8 파일 링크

VideoPreconditioned

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

열거형
`NO`	아직 조건부로 설정되지 않았습니다.
`YES`	동영상이 컨디셔닝/분할되었습니다.

Package google.ads.drx.video.v1 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

색인

AdBreakNotificationService

VideoContentIngestionService

AdBreak

BreakState

ClosedCaptionFormat

ClosedCaptionUrlInfo

CreateAdBreakRequest

DynamicAdInsertionInfo

GracenoteMetadata

ListAdBreaksRequest

ListAdBreaksResponse

메타데이터

SyndicatedVideoContentNames

UpdateVideoContentRequest

동영상 콘텐츠

VideoContentStatus

VideoContentSyndicationInfo

VideoFormat

VideoIngestUrlInfo

VideoPreconditioned

Package google.ads.drx.video.v1