REST Resource: advertisers.lineItems.targetingTypes.assignedTargetingOptions

리소스: AssignedtargetingOption

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

JSON 표현
{
  "name": string,
  "assignedTargetingOptionId": 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)
  }
  // End of list of possible types for union field details.
}
필드
name

string

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

assignedTargetingOptionId

string

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

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이면 채워집니다.

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

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)

Open Measurement가 사용 설정된 인벤토리 세부정보 이 필드는 targetingTypeTARGETING_TYPE_OMID이면 채워집니다.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

방법

create

광고 항목에 타겟팅 옵션을 할당합니다.

delete

광고 항목에서 할당된 타겟팅 옵션을 삭제합니다.

get

광고 항목에 할당된 단일 타겟팅 옵션을 가져옵니다.

list

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