REST Resource: advertisers.campaigns.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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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. 할당되는 타겟팅 옵션에 관한 자세한 정보입니다. 세부정보의 필드는 하나만 입력할 수 있으며 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인 경우 이 필드가 채워집니다.

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

contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

콘텐츠 테마 세부정보입니다. targetingTypeTARGETING_TYPE_CONTENT_THEME_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)

콘텐츠 재생 시간 세부정보입니다. 이 필드는 TargetingType이 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

캠페인에 할당된 단일 타겟팅 옵션을 가져옵니다.

list

지정된 타겟팅 유형의 캠페인에 할당된 타겟팅 옵션을 나열합니다.