Method: advertisers.reachForecast.retrievePlannableProducts

위치에 대해 계획할 수 있는 제품 목록을 가져옵니다.

HTTP 요청

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableProducts

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

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. 계획 가능한 제품을 나열할 광고주의 ID입니다.

쿼리 매개변수

매개변수
plannableLocationId

string

필수 항목입니다. 계획 가능한 위치의 ID입니다.

요청 본문

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

응답 본문

reachForecast.retrievePlannableProducts의 응답

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
필드
productMetadata[]

object (ProductMetadata)

출력 전용입니다. 타겟팅 가능성을 보여주는 제품 메타데이터 목록입니다.

승인 범위

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

  • https://www.googleapis.com/auth/display-video

자세한 내용은 OAuth 2.0 Overview를 참조하세요.

ProductMetadata

계획 가능한 제품의 메타데이터입니다.

JSON 표현 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
필드
plannableProductDescription

string

출력 전용입니다. 광고 제품의 일반 텍스트 설명입니다.
plannableProductCode

string

출력 전용입니다. 계획 가능한 제품 코드입니다 (예: 'YOUTUBE_REACH_MIX').
plannableTargeting

object (PlannableTargeting)

출력 전용입니다. 이 제품에 사용할 수 있는 타겟팅 기능입니다.
displayName

string

출력 전용입니다. 광고 제품과 연결된 이름입니다. 예: '동영상 조회수 확보 캠페인'
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

출력 전용입니다. 이 제품의 핵심 속성입니다.

PlannableTargeting

특정 제품의 타겟팅 기능입니다.

JSON 표현 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
필드
ageRanges[]

enum (PlannableAgeRange)

출력 전용입니다. 제품에 허용되는 계획 가능한 연령대입니다. 실제 타겟팅은 이 연령 범위를 표준 Google 연령 타겟팅에 매핑하여 계산됩니다.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

출력 전용입니다. 광고 제품의 타겟팅 가능한 표시 경로 조합입니다.
genders[]

enum (Gender)

출력 전용입니다. 광고 제품의 타겟팅 가능한 성별입니다.
networks[]

enum (PlannableNetwork)

출력 전용입니다. 광고 제품의 타겟팅 가능한 네트워크입니다.
devices[]

enum (DeviceType)

출력 전용입니다. 광고 제품의 타겟팅 가능한 기기입니다.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

출력 전용입니다. 광고 제품의 타겟팅 가능한 YouTube Select 라인업입니다.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

출력 전용입니다. 이 제품의 기본 YouTube Select 라인업입니다(해당하는 경우).

SurfaceTargetingCombinations

표면 타겟팅 규칙입니다.

JSON 표현 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
필드
availableSurfaceTypes[]

enum (PlannableSurface)

출력 전용입니다. 사용 가능한 표시 영역 유형입니다.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

출력 전용입니다. 함께 선택할 수 있는 유효한 표시 경로 조합입니다.
defaultSurfaceTypes[]

enum (PlannableSurface)

출력 전용입니다. 이 제품의 기본 표시 영역 유형입니다.

SurfaceTargetingCombination

유효한 표시 경로 조합입니다.

JSON 표현 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
필드
choices[]

enum (PlannableSurface)

출력 전용입니다. 표면의 조합입니다.

YouTubeSelectLineUp

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

JSON 표현 
{
  "lineupId": string,
  "displayName": string
}
필드
lineupId

string (int64 format)

출력 전용입니다. YouTube Select 라인업의 ID입니다.
displayName

string

출력 전용입니다. YouTube Select 라인업의 표시 이름입니다.

PlannableProductCoreAttributes

계획 가능한 제품의 핵심 속성입니다.

JSON 표현 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
필드
productCategory

enum (PlannableProductCategory)

출력 전용입니다. 제품 카테고리입니다.
buyingMethod

enum (PlannableBuyingMethod)

출력 전용입니다. 구매 방법입니다.
costModel

enum (PlannableCostModel)

출력 전용입니다. 비용 모델입니다.

PlannableBuyingMethod

계획 가능한 제품의 구매 방법입니다.

열거형
PLANNABLE_BUYING_METHOD_UNSPECIFIED 지정되지 않음
PLANNABLE_BUYING_METHOD_AUCTION 옥션
PLANNABLE_BUYING_METHOD_RESERVATION 예약

PlannableCostModel

계획 가능한 제품의 비용 모델입니다.

열거형
PLANNABLE_COST_MODEL_UNSPECIFIED 지정되지 않음
PLANNABLE_COST_MODEL_CPM CPM이 계속 사용됩니다.
PLANNABLE_COST_MODEL_CPV CPV
PLANNABLE_COST_MODEL_CPC CPC
PLANNABLE_COST_MODEL_CPA 절감).