Method: videoAdvertisingOptions.getEnabledAds

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

HTTP 요청

GET https://youtubepartner.googleapis.com/youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
videoId

string

videoId 매개변수는 광고 옵션을 검색할 동영상의 YouTube 동영상 ID를 지정합니다.

쿼리 매개변수

매개변수
onBehalfOfContentOwner

string

onBehalfOfContentOwner 매개변수는 사용자가 대리하는 콘텐츠 소유자를 식별합니다. 이 매개변수는 계정이 여러 콘텐츠 소유자와 연결된 사용자를 지원합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

이 리소스는 소유권 주장이 제기된 YouTube 동영상의 광고 설정을 식별합니다. 동영상, 동영상 재생 중에 광고를 게재할 수 있는 시간, 광고를 게재할 수 있는 국가, 해당 국가에서 허용되는 광고 유형을 식별합니다. 또한 동영상이 내장 플레이어에서 재생되는 경우 광고를 실행할 수 있는지 여부를 나타냅니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "kind": string,
  "countriesRestriction": [
    {
      object (CountriesRestriction)
    }
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "adsOnEmbeds": boolean,
  "id": string
}
필드
kind

string

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

object (CountriesRestriction)

광고를 게재할 수 있는 국가와 해당 국가에서 허용되는 광고 유형을 나타내는 목록입니다.
adBreaks[]

object (AdBreak)

소유권 주장이 제기된 YouTube 동영상에서 게재되는 광고 시점의 목록입니다.
adsOnEmbeds

boolean

이 필드는 동영상이 내장 플레이어에서 재생될 때 YouTube가 광고를 표시할 수 있는지 여부를 나타냅니다.
id

string

YouTube가 소유권 주장이 제기된 동영상을 고유하게 식별하는 데 사용하는 ID입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/youtubepartner

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

CountriesRestriction

적용된 정책을 기반으로 특정 국가에서 사용 설정된 형식입니다.

JSON 표현 
{
  "adFormats": [
    string
  ],
  "territories": [
    string
  ]
}
필드
adFormats[]

string

지정된 국가에서 사용할 수 있는 광고 형식의 목록입니다.
territories[]

string

광고가 사용 설정된 국가를 식별하는 ISO 3166-1 alpha-2 국가 코드 목록입니다.