REST Resource: advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions

리소스: AssignedTargetingOption

할당된 단일 타겟팅 옵션으로, 타겟팅 설정이 있는 항목의 타겟팅 옵션 상태를 정의합니다.

JSON 표현
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
필드
name

string

출력 전용입니다. 이 할당된 타겟팅 옵션의 리소스 이름입니다.

assignedTargetingOptionId

string

출력 전용입니다. 할당된 타겟팅 옵션의 고유 ID입니다. ID는 특정 리소스 및 타겟팅 유형 내에서만 고유합니다. 다른 컨텍스트에서 다시 사용할 수 있습니다.

assignedTargetingOptionIdAlias

string

출력 전용입니다. assignedTargetingOptionId의 별칭입니다. 기존 타겟팅을 검색하거나 삭제할 때 이 값을 assignedTargetingOptionId 대신 사용할 수 있습니다.

이 필드는 다음 타겟팅 유형의 할당된 모든 타겟팅 옵션에만 지원됩니다.

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

이 필드는 다음 타겟팅 유형의 광고 항목에 할당된 타겟팅 옵션에도 지원됩니다.

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

출력 전용입니다. 할당된 타겟팅 옵션의 유형을 식별합니다.

inheritance

enum (Inheritance)

출력 전용입니다. 할당된 타겟팅 옵션의 상속 상태입니다.

통합 필드 details. 할당되는 타겟팅 옵션에 대한 세부정보입니다. 세부정보의 필드 1개만 작성할 수 있으며 targeting_type와 일치해야 합니다. details는 다음 중 하나여야 합니다.
channelDetails

object (ChannelAssignedTargetingOptionDetails)

채널 세부정보 이 필드는 targetingTypeTARGETING_TYPE_CHANNEL일 때 채워집니다.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

앱 카테고리 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_APP_CATEGORY일 때 채워집니다.

appDetails

object (AppAssignedTargetingOptionDetails)

앱 세부정보 이 필드는 targetingTypeTARGETING_TYPE_APP일 때 채워집니다.

urlDetails

object (UrlAssignedTargetingOptionDetails)

URL 세부정보 이 필드는 targetingTypeTARGETING_TYPE_URL일 때 채워집니다.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

날짜 및 시간 세부정보 이 필드는 targetingTypeTARGETING_TYPE_DAY_AND_TIME일 때 채워집니다.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

연령대 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_AGE_RANGE일 때 채워집니다.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

리전 위치 목록 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST일 때 채워집니다.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

인접 위치 목록 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST일 때 채워집니다.

genderDetails

object (GenderAssignedTargetingOptionDetails)

성별 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_GENDER일 때 채워집니다.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

동영상 플레이어 크기 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE일 때 채워집니다.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

사용자 리워드 콘텐츠 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT일 때 채워집니다.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

자녀 유무 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_PARENTAL_STATUS일 때 채워집니다.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

콘텐츠 인스트림 위치 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION일 때 채워집니다.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

콘텐츠 아웃스트림 위치 세부정보. 이 필드는 targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION일 때 채워집니다.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

기기 유형 세부정보 이 필드는 targetingTypeTARGETING_TYPE_DEVICE_TYPE일 때 채워집니다.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

잠재고객 타겟팅 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_AUDIENCE_GROUP일 때 채워집니다. 리소스당 하나의 잠재고객 그룹 옵션만 타겟팅할 수 있습니다.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

브라우저 세부정보 이 필드는 targetingTypeTARGETING_TYPE_BROWSER일 때 채워집니다.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

가구 소득 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME일 때 채워집니다.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

화면 위치 세부정보 이 필드는 targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION일 때 채워집니다.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

이동통신사 및 ISP 세부정보 이 필드는 targetingTypeTARGETING_TYPE_CARRIER_AND_ISP일 때 채워집니다.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

키워드 세부정보. 이 필드는 targetingTypeTARGETING_TYPE_KEYWORD일 때 채워집니다.

리소스에 최대 5,000개의 직접 제외 키워드를 할당할 수 있습니다. 할당할 수 있는 일반 키워드 수에는 제한이 없습니다.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

키워드 세부정보. 이 필드는 targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST일 때 채워집니다.

리소스에 최대 4개의 제외 키워드 목록을 할당할 수 있습니다.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

운영체제 세부정보 이 필드는 targetingTypeTARGETING_TYPE_OPERATING_SYSTEM일 때 채워집니다.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

기기 제조업체 및 모델 세부정보 이 필드는 targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL일 때 채워집니다.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

환경 세부정보 이 필드는 targetingTypeTARGETING_TYPE_ENVIRONMENT일 때 채워집니다.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

인벤토리 소스 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE일 때 채워집니다.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

카테고리 세부정보 이 필드는 targetingTypeTARGETING_TYPE_CATEGORY일 때 채워집니다.

카테고리를 타겟팅하면 그 하위 카테고리도 타겟팅됩니다. 카테고리가 타겟팅에서 제외되고 하위 카테고리가 포함된 경우 제외가 우선 적용됩니다.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

조회가능성 세부정보 이 필드는 targetingTypeTARGETING_TYPE_VIEWABILITY일 때 채워집니다.

리소스당 하나의 조회가능성 옵션만 타겟팅할 수 있습니다.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

승인된 판매자 상태 세부정보 이 필드는 targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS일 때 채워집니다.

리소스당 승인된 판매자 상태 옵션 하나만 타겟팅할 수 있습니다.

리소스에 승인된 판매자 상태 옵션이 없는 경우 ads.txt 파일에 DIRECT 또는 RESELLER로 표시된 모든 승인된 판매자가 기본적으로 타겟팅됩니다.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

언어 세부정보 이 필드는 targetingTypeTARGETING_TYPE_LANGUAGE일 때 채워집니다.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

지리적 리전 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_GEO_REGION일 때 채워집니다.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

인벤토리 소스 그룹 세부정보 이 필드는 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP일 때 채워집니다.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

디지털 콘텐츠 라벨 세부정보 이 필드는 targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION일 때 채워집니다.

디지털 콘텐츠 라벨은 제외를 타겟팅합니다. 광고주 수준의 디지털 콘텐츠 라벨 제외가 설정된 경우 리소스 설정에 표시되지 않더라도 항상 게재 시 적용됩니다. 리소스 설정은 광고주 제외 외에 콘텐츠 라벨을 제외할 수 있지만 재정의할 수는 없습니다. 모든 디지털 콘텐츠 라벨이 제외되면 광고 항목이 게재되지 않습니다.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

민감한 카테고리 세부정보 이 필드는 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION일 때 채워집니다.

민감한 카테고리는 제외를 타겟팅합니다. 광고주 수준의 민감한 카테고리 제외가 설정되면 리소스 설정에 표시되지 않더라도 항상 게재 시 적용됩니다. 리소스 설정은 광고주 제외 외에 민감한 카테고리를 제외할 수 있지만 재정의할 수는 없습니다.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

거래소 세부정보 이 필드는 targetingTypeTARGETING_TYPE_EXCHANGE일 때 채워집니다.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

하위 거래소 세부정보 이 필드는 targetingTypeTARGETING_TYPE_SUB_EXCHANGE일 때 채워집니다.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

서드 파티 인증 세부정보 이 필드는 targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER일 때 채워집니다.

poiDetails

object (PoiAssignedTargetingOptionDetails)

관심 장소 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_POI일 때 채워집니다.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

비즈니스 체인 세부정보 이 필드는 targetingTypeTARGETING_TYPE_BUSINESS_CHAIN일 때 채워집니다.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

콘텐츠 길이 세부정보 이 필드는 targetingTypeTARGETING_TYPE_CONTENT_DURATION일 때 채워집니다.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

콘텐츠 길이 세부정보 이 필드는 타겟팅 유형이 TARGETING_TYPE_CONTENT_STREAM_TYPE인 경우 채워집니다.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

네이티브 콘텐츠 위치 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION일 때 채워집니다.

omidDetails

object (OmidAssignedTargetingOptionDetails)

측정이 사용 설정된 인벤토리 세부정보를 엽니다. 이 필드는 targetingTypeTARGETING_TYPE_OMID일 때 채워집니다.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

오디오 콘텐츠 유형 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE일 때 채워집니다.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

콘텐츠 장르 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_CONTENT_GENRE일 때 채워집니다.

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 동영상 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO일 때 채워집니다.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube 채널 세부정보 이 필드는 targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL일 때 채워집니다.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

세션 위치 세부정보입니다. 이 필드는 targetingTypeTARGETING_TYPE_SESSION_POSITION일 때 채워집니다.

메서드

get

YouTube 광고그룹에 할당된 단일 타겟팅 옵션을 가져옵니다.

list

YouTube 광고 그룹에 할당된 타겟팅 옵션을 나열합니다.