REST Resource: advertisers.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. 할당되는 타겟팅 옵션에 대한 세부정보입니다. 세부정보의 필드 하나만 작성할 수 있으며 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 파일에 직접 또는 리셀러로 표시된 모든 승인된 판매자가 기본적으로 타겟팅됩니다.
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일 때 채워집니다.

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

object (ExchangeAssignedTargetingOptionDetails)

Exchange 세부정보 이 필드는 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)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

네이티브 콘텐츠 게재순위 세부정보 이 필드는 targetingType가 TARGETING_TYPE_NATIVE_CONTENT_POSITION일 때 채워집니다.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Open Measurement가 사용 설정된 인벤토리 세부정보 이 필드는 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

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