REST Resource: videoAdvertisingOptions

리소스: VideoAdvertisingOption

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

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만 사용 설정 또는 사용 중지할 수 있습니다. third_party를 사용 설정하려면 콘텐츠 소유자가 서드 파티 (Freewheel) 광고를 사용 설정해야 합니다. 그렇지 않으면 요청에서 FORBIDDEN 오류가 반환됩니다. 자세한 내용은 지원 도움말을 참고하세요.

다음 광고 형식 컨트롤은 더 이상 사용할 수 없으며 API 요청에 포함해서는 안 됩니다. instream_standard, display, preroll, postroll
breakPosition[]

string

동영상 재생 중에 광고가 삽입되는 시점입니다.

사용 가능한 값:

  • midroll: 동영상 재생 중에 광고가 게재됩니다. midrollSeconds 속성은 시간을 지정합니다.
  • postroll: 동영상이 끝난 후 광고가 게재됩니다.
  • preroll: 동영상이 시작되기 전에 광고가 게재됩니다.
adBreaks[]

object (AdBreak)

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

boolean

이 동영상에 자동 생성 미드롤 광고 시점을 사용 설정합니다. adBreaks가 정의된 동영상에서 autoGeneratedBreaks가 true로 설정되면 수동으로 배치한 광고 슬롯 외에 광고를 게재할 위치가 시스템에 의해 식별됩니다.
id

string

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

string

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

string

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

string

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

AdBreak

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

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

string

동영상 재생 중에 광고가 삽입되는 시점입니다.

사용 가능한 값:

  • midroll: 동영상 재생 중에 광고가 게재됩니다. midrollSeconds 속성은 시간을 지정합니다.
  • postroll: 동영상이 끝난 후 광고가 게재됩니다.
  • preroll: 동영상이 시작되기 전에 광고가 게재됩니다.
midrollSeconds

integer

광고가 나올 때 동영상 시작 후 흐른 시간(단위: 초)으로 지정된 광고 시간입니다.

메서드

get

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

getEnabledAds

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

patch

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

update

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