REST Resource: videoAdvertisingOptions

리소스: Video AdvertisingOption

동영상에 대한 광고 설정입니다. 이 설정은 동영상 재생 중에 실행할 수 있는 광고의 유형과 동영상 재생 중에 광고가 실행될 수 있는 시점을 지정합니다.

JSON 표현 
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
필드
kind

string

API 리소스의 유형입니다. 이 리소스의 값은 youtubePartner#videoAdvertisingOption입니다.
adFormats[]

string

동영상을 표시할 수 있는 광고 형식의 목록입니다. 참고: 2023년 11월부터 이 열에서 third_party_ads만 사용 설정/중지할 수 있습니다. 자세한 내용은 지원 도움말을 참조하세요. instream_standard, display, preroll, postroll 광고 형식 관리 기능은 더 이상 사용할 수 없으며 API 요청에 포함되어서는 안 됩니다.
breakPosition[]

string

동영상 재생 중에 광고 시점이 발생하는 지점입니다.
adBreaks[]

object (AdBreak)

YouTube가 동영상 재생 중에 인스트림 광고를 표시할 수 있는 시간의 목록입니다.
autoGeneratedBreaks

boolean

자동으로 생성된 미드롤 광고 시점에 이 동영상을 사용 설정합니다.
id

string

YouTube가 광고 설정과 연결된 동영상을 고유하게 식별하는 데 사용하는 ID입니다.
tpAdServerVideoId

string

외부 광고 서버에서 동영상을 고유하게 식별하는 값입니다.
tpTargetingUrl

string

YouTube가 동영상의 인스트림 광고를 가져올 수 있는 타사 광고 서버의 기본 URL입니다.
tpUrlParameters

string

외부 광고 서버에 대한 요청 끝에 추가할 매개변수 문자열입니다.

AdBreak

adBreak 리소스에는 동영상 재생 중에 YouTube가 인스트림 광고를 표시할 수 있는 시간에 대한 정보가 포함됩니다.

JSON 표현 
{
  "position": string,
  "midrollSeconds": integer
}
필드
position

string

동영상 재생 중에 광고 시점이 발생하는 지점입니다.
midrollSeconds

integer

동영상이 시작된 후 초 단위로 지정된 광고 시점 시간입니다.

메서드

get

 지정된 동영상의 광고 설정을 검색합니다.

getEnabledAds

 지정된 파트너 또는 사용자가 업로드한 동영상에 허용되는 광고 유형의 세부정보를 검색합니다.

patch

 지정된 동영상의 광고 설정을 패치합니다.

update

 지정된 동영상의 광고 설정을 업데이트합니다.