Method: listPlannableProducts

허용된 타겟팅이 있는 위치별로 계획 가능한 YouTube 광고 형식의 목록을 반환합니다.

발생한 오류 목록: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 요청

POST https://googleads.googleapis.com/v16:listPlannableProducts

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

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "plannableLocationId": string
}
입력란
plannableLocationId

string

필수 항목입니다. 계획을 위해 선택한 위치의 ID입니다. 사용 가능한 계획 가능 위치 ID를 나열하려면 ReachPlanService.ListPlannableLocations를 사용하세요.

응답 본문

사용 가능한 모든 제품이 포함된 응답입니다.

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

JSON 표현 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
입력란
productMetadata[]

object (ProductMetadata)

계획 및 관련 타겟팅 메타데이터에 사용할 수 있는 제품의 목록입니다.

승인 범위

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

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

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

ProductMetadata

사용 가능한 계획 가능 제품과 연결된 메타데이터입니다.

JSON 표현 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
입력란
plannableProductName

string

광고상품과 연결된 이름입니다.
plannableTargeting

object (PlannableTargeting)

이 제품에 허용된 계획 가능한 타겟팅입니다.
plannableProductCode

string

광고상품과 연결된 코드입니다 (예: BUMPER, TRUEVIEW_IN_STREAM). 사용 가능한 계획 가능 제품 코드를 나열하려면 ReachPlanService.ListPlannableProducts를 사용합니다.

PlannableTargeting

트래픽 측정항목이 보고되는 타겟팅입니다.

JSON 표현 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
입력란
ageRanges[]

enum (ReachPlanAgeRange)

측정항목이 보고되는 제품에 허용되는 계획 가능한 연령대입니다. 실제 타겟팅은 이 연령대를 표준 Google common.AgeRangeInfo 값에 매핑하여 계산됩니다.
genders[]

object (GenderInfo)

광고 상품에 대해 타겟팅 가능한 성별입니다.
devices[]

object (DeviceInfo)

광고 상품에 대해 타겟팅 가능한 기기입니다. CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER, GOOGLE_PREFERRED_SHORT 제품에 대해 모바일 타겟팅이 선택된 경우 태블릿 기기 타겟팅이 보고된 측정항목에 자동으로 적용됩니다.
networks[]

enum (ReachPlanNetwork)

광고 상품에 대해 타겟팅 가능한 네트워크입니다.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

광고 제품에 대해 타겟팅 가능한 YouTube Select 라인업입니다.
surfaceTargeting

object (SurfaceTargetingCombinations)

광고 제품에 대해 타겟팅 가능한 노출 영역 조합입니다.

YouTubeSelectLineUp

제품 타겟팅을 위한 계획 가능한 YouTube Select 라인업

JSON 표현 
{
  "lineupId": string,
  "lineupName": string
}
입력란
lineupId

string (int64 format)

YouTube Select 라인업의 ID입니다.
lineupName

string

YouTube Select 라인업의 고유한 이름입니다.

SurfaceTargetingCombinations

광고 제품에 사용할 수 있는 노출 영역 타겟팅 조합입니다.

JSON 표현 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
입력란
defaultTargeting

object (SurfaceTargeting)

광고 제품에 기본 노출 영역 타겟팅이 적용되었습니다.
availableTargetingCombinations[]

object (SurfaceTargeting)

광고 제품에 사용할 수 있는 노출 영역 타겟 조합입니다.