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만 사용 설정/사용 중지할 수 있습니다. 자세한 내용은 지원 도움말을 참조하세요. 다음 광고 형식 관리 기능은 더 이상 사용할 수 없으며 API 요청에 포함해서는 안 됩니다. instream_standard, display, preroll, postroll

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

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