REST Resource: advertisers.insertionOrders.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)

채널 세부정보입니다. targetingType가 TARGETING_TYPE_CHANNEL인 경우 이 필드가 채워집니다.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

앱 카테고리 세부정보입니다. targetingType가 TARGETING_TYPE_APP_CATEGORY인 경우 이 필드가 채워집니다.
appDetails

object (AppAssignedTargetingOptionDetails)

앱 세부정보입니다. targetingType가 TARGETING_TYPE_APP인 경우 이 필드가 채워집니다.
urlDetails

object (UrlAssignedTargetingOptionDetails)

URL 세부정보입니다. targetingType가 TARGETING_TYPE_URL인 경우 이 필드가 채워집니다.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

요일 및 시간 세부정보입니다. targetingType가 TARGETING_TYPE_DAY_AND_TIME인 경우 이 필드가 채워집니다.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

연령대 세부정보입니다. targetingType가 TARGETING_TYPE_AGE_RANGE인 경우 이 필드가 채워집니다.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

지역 위치 목록 세부정보입니다. targetingType가 TARGETING_TYPE_REGIONAL_LOCATION_LIST인 경우 이 필드가 채워집니다.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

인접 위치 목록 세부정보입니다. targetingType가 TARGETING_TYPE_PROXIMITY_LOCATION_LIST인 경우 이 필드가 채워집니다.
genderDetails

object (GenderAssignedTargetingOptionDetails)

성별 세부정보 targetingType가 TARGETING_TYPE_GENDER인 경우 이 필드가 채워집니다.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

동영상 플레이어 크기 세부정보입니다. targetingType가 TARGETING_TYPE_VIDEO_PLAYER_SIZE인 경우 이 필드가 채워집니다.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

사용자 보상형 콘텐츠 세부정보입니다. targetingType가 TARGETING_TYPE_USER_REWARDED_CONTENT인 경우 이 필드가 채워집니다.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

자녀 유무 세부정보입니다. targetingType가 TARGETING_TYPE_PARENTAL_STATUS인 경우 이 필드가 채워집니다.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

콘텐츠 인스트림 위치 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_INSTREAM_POSITION인 경우 이 필드가 채워집니다.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

콘텐츠 아웃스트림 위치 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION인 경우 이 필드가 채워집니다.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

기기 유형 세부정보입니다. targetingType가 TARGETING_TYPE_DEVICE_TYPE인 경우 이 필드가 채워집니다.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

잠재고객 타겟팅 세부정보입니다. targetingType가 TARGETING_TYPE_AUDIENCE_GROUP인 경우 이 필드가 채워집니다. 리소스당 하나의 잠재고객 그룹 옵션만 타겟팅할 수 있습니다.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

브라우저 세부정보입니다. targetingType가 TARGETING_TYPE_BROWSER인 경우 이 필드가 채워집니다.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

가계 소득 세부정보입니다. targetingType가 TARGETING_TYPE_HOUSEHOLD_INCOME인 경우 이 필드가 채워집니다.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

화면 위치 세부정보 targetingType가 TARGETING_TYPE_ON_SCREEN_POSITION인 경우 이 필드가 채워집니다.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

이동통신사 및 ISP 세부정보입니다. targetingType가 TARGETING_TYPE_CARRIER_AND_ISP인 경우 이 필드가 채워집니다.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

키워드 세부정보입니다. targetingType가 TARGETING_TYPE_KEYWORD인 경우 이 필드가 채워집니다.

리소스에 할당할 수 있는 직접 제외 키워드는 최대 5,000개입니다. 할당할 수 있는 긍정 키워드 수에 제한이 없습니다.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

키워드 세부정보입니다. targetingType가 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST인 경우 이 필드가 채워집니다.

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

object (OperatingSystemAssignedTargetingOptionDetails)

운영체제 세부정보입니다. targetingType가 TARGETING_TYPE_OPERATING_SYSTEM인 경우 이 필드가 채워집니다.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

기기 제조업체 및 모델 세부정보 targetingType가 TARGETING_TYPE_DEVICE_MAKE_MODEL인 경우 이 필드가 채워집니다.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

환경 세부정보입니다. targetingType가 TARGETING_TYPE_ENVIRONMENT인 경우 이 필드가 채워집니다.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

인벤토리 소스 세부정보입니다. targetingType가 TARGETING_TYPE_INVENTORY_SOURCE인 경우 이 필드가 채워집니다.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

카테고리 세부정보 targetingType가 TARGETING_TYPE_CATEGORY인 경우 이 필드가 채워집니다.

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

object (ViewabilityAssignedTargetingOptionDetails)

조회가능성 세부정보입니다. targetingType가 TARGETING_TYPE_VIEWABILITY인 경우 이 필드가 채워집니다.

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

승인된 판매자 상태 세부정보입니다. targetingType가 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS인 경우 이 필드가 채워집니다.

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

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

object (LanguageAssignedTargetingOptionDetails)

언어 세부정보입니다. targetingType가 TARGETING_TYPE_LANGUAGE인 경우 이 필드가 채워집니다.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

지리적 지역 세부정보입니다. targetingType가 TARGETING_TYPE_GEO_REGION인 경우 이 필드가 채워집니다.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

인벤토리 소스 그룹 세부정보입니다. targetingType가 TARGETING_TYPE_INVENTORY_SOURCE_GROUP인 경우 이 필드가 채워집니다.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

디지털 콘텐츠 라벨 세부정보입니다. targetingType가 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION인 경우 이 필드가 채워집니다.

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

민감한 카테고리 세부정보입니다. targetingType가 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION인 경우 이 필드가 채워집니다.

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

object (ContentThemeAssignedTargetingOptionDetails)

콘텐츠 테마 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_THEME_EXCLUSION인 경우 이 필드가 채워집니다.

콘텐츠 테마는 타겟팅 제외입니다. 광고주 수준 콘텐츠 테마 제외는 설정된 경우 리소스 설정에 표시되지 않더라도 항상 게재에 적용됩니다. 리소스 설정은 광고주 제외 외에도 콘텐츠 테마를 제외할 수 있습니다.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

교환 세부정보입니다. targetingType가 TARGETING_TYPE_EXCHANGE인 경우 이 필드가 채워집니다.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

하위 거래소 세부정보입니다. targetingType가 TARGETING_TYPE_SUB_EXCHANGE인 경우 이 필드가 채워집니다.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

서드 파티 인증 세부정보입니다. targetingType가 TARGETING_TYPE_THIRD_PARTY_VERIFIER인 경우 이 필드가 채워집니다.
poiDetails

object (PoiAssignedTargetingOptionDetails)

관심 장소 세부정보입니다. targetingType가 TARGETING_TYPE_POI인 경우 이 필드가 채워집니다.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

비즈니스 체인 세부정보입니다. targetingType가 TARGETING_TYPE_BUSINESS_CHAIN인 경우 이 필드가 채워집니다.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

콘텐츠 재생 시간 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_DURATION인 경우 이 필드가 채워집니다.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

콘텐츠 재생 시간 세부정보입니다. 이 필드는 TargetingType이 TARGETING_TYPE_CONTENT_STREAM_TYPE인 경우 채워집니다.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

네이티브 콘텐츠 위치 세부정보입니다. targetingType가 TARGETING_TYPE_NATIVE_CONTENT_POSITION인 경우 이 필드가 채워집니다.
omidDetails

object (OmidAssignedTargetingOptionDetails)

공개 측정이 사용 설정된 인벤토리 세부정보입니다. targetingType가 TARGETING_TYPE_OMID인 경우 이 필드가 채워집니다.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

오디오 콘텐츠 유형 세부정보입니다. targetingType가 TARGETING_TYPE_AUDIO_CONTENT_TYPE인 경우 이 필드가 채워집니다.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

콘텐츠 장르 세부정보입니다. targetingType가 TARGETING_TYPE_CONTENT_GENRE인 경우 이 필드가 채워집니다.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 동영상 세부정보입니다. targetingType가 TARGETING_TYPE_YOUTUBE_VIDEO인 경우 이 필드가 채워집니다.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube 채널 세부정보입니다. targetingType가 TARGETING_TYPE_YOUTUBE_CHANNEL인 경우 이 필드가 채워집니다.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

세션 위치 세부정보입니다. targetingType가 TARGETING_TYPE_SESSION_POSITION인 경우 이 필드가 채워집니다.

메서드

create

 게재 신청서에 타겟팅 옵션을 할당합니다.

delete

 게재 신청서에서 할당된 타겟팅 옵션을 삭제합니다.

get

 게재 신청서에 할당된 단일 타겟팅 옵션을 가져옵니다.

list

 게재 신청서에 할당된 타겟팅 옵션을 나열합니다.