REST Resource: targetingTypes.targetingOptions

資源： TargetingOption

代表單一指定目標選項，這是 DV360 中的可指定概念。

JSON 表示法 
{
  "name": string,
  "targetingOptionId": string,
  "targetingType": enum (TargetingType),

  // Union field details can be only one of the following:
  "digitalContentLabelDetails": {
    object (DigitalContentLabelTargetingOptionDetails)
  },
  "sensitiveCategoryDetails": {
    object (SensitiveCategoryTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
欄位
name

string

僅供輸出。這個指定目標選項的資源名稱。
targetingOptionId

string

僅供輸出。這個指定目標選項的專屬 ID。元組 {targetingType, targetingOptionId} 不會重複。
targetingType

enum (TargetingType)

僅供輸出。這個指定目標選項的類型。
聯集欄位 details。指定目標選項的詳細資訊。詳細資料中只能填寫一個欄位，且必須與 targeting_type 對應；details 只能設為下列其中一個欄位：
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

數位內容標籤詳細資料。
sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

敏感類別詳細資料。
appCategoryDetails

object (AppCategoryTargetingOptionDetails)

應用程式類別詳細資料。
onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

螢幕位置詳細資料。
contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

內容串流外位置詳細資料。
contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

內容串流內位置詳細資料。
videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

影片播放器大小詳細資料。
ageRangeDetails

object (AgeRangeTargetingOptionDetails)

年齡層詳細資料。
parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

家長狀態詳細資料。
userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

使用者獎勵內容詳細資料。
householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

家庭收入詳細資料。
genderDetails

object (GenderTargetingOptionDetails)

性別詳細資料。
deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

裝置類型詳細資料。
browserDetails

object (BrowserTargetingOptionDetails)

瀏覽器詳細資料。
carrierAndIspDetails

object (CarrierAndIspTargetingOptionDetails)

電信業者和網際網路服務供應商 (ISP) 的詳細資料。
environmentDetails

object (EnvironmentTargetingOptionDetails)

環境詳細資料。
operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

作業系統資源詳細資料。
deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

裝置廠牌和型號資源詳細資料。
viewabilityDetails

object (ViewabilityTargetingOptionDetails)

可視度資源詳細資料。
categoryDetails

object (CategoryTargetingOptionDetails)

類別資源詳細資料。
languageDetails

object (LanguageTargetingOptionDetails)

語言資源詳細資料。
authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

授權賣方狀態資源詳細資料。
geoRegionDetails

object (GeoRegionTargetingOptionDetails)

地理區域資源詳細資料。
exchangeDetails

object (ExchangeTargetingOptionDetails)

廣告交易平台詳細資料。
subExchangeDetails

object (SubExchangeTargetingOptionDetails)

子廣告交易平台詳細資料。
poiDetails

object (PoiTargetingOptionDetails)

搜尋點資源詳細資料。
businessChainDetails

object (BusinessChainTargetingOptionDetails)

商家鏈資源詳細資料。
contentDurationDetails

object (ContentDurationTargetingOptionDetails)

內容時間長度資源詳細資料。
contentStreamTypeDetails

object (ContentStreamTypeTargetingOptionDetails)

內容串流類型資源詳細資料。
nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

原生內容位置詳細資料。
omidDetails

object (OmidTargetingOptionDetails)

已啟用 Open Measurement 的廣告空間詳細資料。
audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

音訊內容類型詳細資料。
contentGenreDetails

object (ContentGenreTargetingOptionDetails)

內容類型資源詳細資料。

DigitalContentLabelTargetingOptionDetails

代表可指定的數位內容標籤分級等級。當 targetingType 為 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 時，這個值會在 TargetingOption 的 digitalContentLabelDetails 欄位中填入。

JSON 表示法 
{
  "contentRatingTier": enum (ContentRatingTier)
}
欄位
contentRatingTier

enum (ContentRatingTier)

僅供輸出。內容標籤品牌安全等級列舉。

SensitiveCategoryTargetingOptionDetails

代表可指定的敏感類別。當 targetingType 為 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 時，這個值會在 TargetingOption 的 sensitiveCategoryDetails 欄位中填入。

JSON 表示法 
{
  "sensitiveCategory": enum (SensitiveCategory)
}
欄位
sensitiveCategory

enum (SensitiveCategory)

僅供輸出。DV360 敏感類別內容分類器的列舉。

AppCategoryTargetingOptionDetails

代表可指定的一組應用程式。集合可讓您指定由平台維護的相關應用程式動態群組，例如 All Apps/Google Play/Games。當 targetingType 為 TARGETING_TYPE_APP_CATEGORY 時，系統會在 appCategoryDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。應用程式集合的名稱。

OnScreenPositionTargetingOptionDetails

代表可指定的螢幕位置，可用於多媒體廣告和影片廣告。當 targetingType 為 TARGETING_TYPE_ON_SCREEN_POSITION 時，系統會在 onScreenPositionDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "onScreenPosition": enum (OnScreenPosition)
}
欄位
onScreenPosition

enum (OnScreenPosition)

僅供輸出。螢幕的位置。

ContentOutstreamPositionTargetingOptionDetails

代表可指定的內容串流外位置，可用於多媒體廣告和影片廣告。當 targetingType 為 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 時，系統會在 contentOutstreamPositionDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
欄位
contentOutstreamPosition

enum (ContentOutstreamPosition)

僅供輸出。內容串流外位置。

ContentInstreamPositionTargetingOptionDetails

代表可指定的內容串流內位置，可用於影片和音訊廣告。當 targetingType 為 TARGETING_TYPE_CONTENT_INSTREAM_POSITION 時，系統會在 contentInstreamPositionDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
欄位
contentInstreamPosition

enum (ContentInstreamPosition)

僅供輸出。內容串流內位置。

VideoPlayerSizeTargetingOptionDetails

代表可指定的影片播放器大小。當 targetingType 為 TARGETING_TYPE_VIDEO_PLAYER_SIZE 時，系統會在 videoPlayerSizeDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
欄位
videoPlayerSize

enum (VideoPlayerSize)

僅供輸出。影片播放器大小。

AgeRangeTargetingOptionDetails

代表可指定的年齡層。當 targetingType 為 TARGETING_TYPE_AGE_RANGE 時，系統會在 ageRangeDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "ageRange": enum (AgeRange)
}
欄位
ageRange

enum (AgeRange)

僅供輸出。目標對象的年齡層。

ParentalStatusTargetingOptionDetails

代表可指定的家長狀態。當 targetingType 為 TARGETING_TYPE_PARENTAL_STATUS 時，這個值會在 TargetingOption 的 parentalStatusDetails 欄位中填入。

JSON 表示法 
{
  "parentalStatus": enum (ParentalStatus)
}
欄位
parentalStatus

enum (ParentalStatus)

僅供輸出。目標對象的家長狀態。

UserRewardedContentTargetingOptionDetails

代表影片廣告的可指定使用者獎勵內容狀態。當 targetingType 為 TARGETING_TYPE_USER_REWARDED_CONTENT 時，系統會在 userRewardedContentDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "userRewardedContent": enum (UserRewardedContent)
}
欄位
userRewardedContent

enum (UserRewardedContent)

僅供輸出。影片廣告的使用者獎勵內容狀態。

HouseholdIncomeTargetingOptionDetails

代表可指定的家庭收入。當 targetingType 為 TARGETING_TYPE_HOUSEHOLD_INCOME 時，這個值會在 TargetingOption 的 householdIncomeDetails 欄位中填入。

JSON 表示法 
{
  "householdIncome": enum (HouseholdIncome)
}
欄位
householdIncome

enum (HouseholdIncome)

僅供輸出。目標對象的家庭收入。

GenderTargetingOptionDetails

代表可指定的性別。當 targetingType 為 TARGETING_TYPE_GENDER 時，這個值會在 TargetingOption 的 genderDetails 欄位中填入。

JSON 表示法 
{
  "gender": enum (Gender)
}
欄位
gender

enum (Gender)

僅供輸出。目標對象的性別。

DeviceTypeTargetingOptionDetails

代表可指定的裝置類型。當 targetingType 為 TARGETING_TYPE_DEVICE_TYPE 時，這個值會在 TargetingOption 的 deviceTypeDetails 欄位中填入。

JSON 表示法 
{
  "deviceType": enum (DeviceType)
}
欄位
deviceType

enum (DeviceType)

僅供輸出。要指定的裝置類型。

BrowserTargetingOptionDetails

代表可指定的瀏覽器。當 targetingType 為 TARGETING_TYPE_BROWSER 時，系統會在 browserDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。瀏覽器的顯示名稱。

CarrierAndIspTargetingOptionDetails

代表可指定的電信業者或網際網路服務供應商 (ISP)。當 targetingType 為 TARGETING_TYPE_CARRIER_AND_ISP 時，這個值會在 TargetingOption 的 carrierAndIspDetails 欄位中填入。

JSON 表示法 
{
  "displayName": string,
  "type": enum (CarrierAndIspType)
}
欄位
displayName

string

僅供輸出。電信業者或網際網路服務供應商 (ISP) 的顯示名稱。
type

enum (CarrierAndIspType)

僅供輸出。指出這是電信業者或網際網路服務供應商 (ISP) 的類型。

CarrierAndIspType

CarrierAndIsp 指定目標選項的類型。

列舉
CARRIER_AND_ISP_TYPE_UNSPECIFIED 未指定類型，或這個版本中不明的類型時的預設值。
CARRIER_AND_ISP_TYPE_ISP 表示這項指定資源參照了網際網路服務供應商 (ISP)。
CARRIER_AND_ISP_TYPE_CARRIER 表示這項指定資源參照行動電信業者。

EnvironmentTargetingOptionDetails

代表可指定的環境。當 targetingType 為 TARGETING_TYPE_ENVIRONMENT 時，這個值會在 TargetingOption 的 environmentDetails 欄位中填入。

JSON 表示法 
{
  "environment": enum (Environment)
}
欄位
environment

enum (Environment)

僅供輸出。放送環境。

OperatingSystemTargetingOptionDetails

代表可指定的作業系統。當 targetingType 為 TARGETING_TYPE_OPERATING_SYSTEM 時，這個值會在 TargetingOption 的 operatingSystemDetails 欄位中填入。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。作業系統的顯示名稱。

DeviceMakeModelTargetingOptionDetails

代表可指定的裝置廠牌和型號。當 targetingType 為 TARGETING_TYPE_DEVICE_MAKE_MODEL 時，這個值會在 TargetingOption 的 deviceMakeModelDetails 欄位中填入。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。裝置廠牌和型號的顯示名稱。

ViewabilityTargetingOptionDetails

代表可指定的可視度。當 targetingType 為 TARGETING_TYPE_VIEWABILITY 時，這個值會在 TargetingOption 的 viewabilityDetails 欄位中填入。

JSON 表示法 
{
  "viewability": enum (Viewability)
}
欄位
viewability

enum (Viewability)

僅供輸出。預測可視度百分比。

CategoryTargetingOptionDetails

代表可指定的類別。當 targetingType 為 TARGETING_TYPE_CATEGORY 時，這個值會在 TargetingOption 的 categoryDetails 欄位中填入。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。類別的顯示名稱。

LanguageTargetingOptionDetails

代表可指定的語言。當 targetingType 為 TARGETING_TYPE_LANGUAGE 時，系統會在 languageDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。語言的顯示名稱 (例如「法文」)。

AuthorizedSellerStatusTargetingOptionDetails

代表可指定的授權賣方狀態。當 targetingType 為 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 時，系統會在 authorizedSellerStatusDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
欄位
authorizedSellerStatus

enum (AuthorizedSellerStatus)

僅供輸出。授權賣方狀態。

GeoRegionTargetingOptionDetails

代表可指定的地理區域。當 targetingType 為 TARGETING_TYPE_GEO_REGION 時，系統會在 geoRegionDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "displayName": string,
  "geoRegionType": enum (GeoRegionType)
}
欄位
displayName

string

僅供輸出。地理區域的顯示名稱 (例如「加拿大安大略省」)。
geoRegionType

enum (GeoRegionType)

僅供輸出。指定地理區域的類型。

ExchangeTargetingOptionDetails

代表可指定的廣告交易平台。當 targetingType 為 TARGETING_TYPE_EXCHANGE 時，這個值會在 TargetingOption 的 exchangeDetails 欄位中填入。

JSON 表示法 
{
  "exchange": enum (Exchange)
}
欄位
exchange

enum (Exchange)

僅供輸出。廣告交易平台的類型。

SubExchangeTargetingOptionDetails

代表可指定的子廣告交易平台。當 targetingType 為 TARGETING_TYPE_SUB_EXCHANGE 時，這個值會在 TargetingOption 的 subExchangeDetails 欄位中填入。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。子廣告交易平台的顯示名稱。

PoiTargetingOptionDetails

代表可指定的搜尋點。當 targetingType 為 TARGETING_TYPE_POI 時，系統會在 poiDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
欄位
latitude

number

僅供輸出。搜尋點的緯度會四捨五入到第 6 位數。
longitude

number

僅供輸出。搜尋點的經度，會四捨五入到第 6 位小數。
displayName

string

僅供輸出。搜尋點的顯示名稱 (例如「時代廣場」、「太空針」)，後面加上完整地址 (如果有的話)。

BusinessChainTargetingOptionDetails

代表某地理區域中的可指定連鎖店。當 targetingType 為 TARGETING_TYPE_BUSINESS_CHAIN 時，系統會在 businessChainDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
欄位
businessChain

string

僅供輸出。連鎖店的顯示名稱，例如「肯德基」(KFC)、「Chase Bank」。
geoRegion

string

僅供輸出。地理區域的顯示名稱，例如「加拿大安大略省」。
geoRegionType

enum (GeoRegionType)

僅供輸出。地理區域的類型。

ContentDurationTargetingOptionDetails

代表可指定的內容時間長度。當 targetingType 為 TARGETING_TYPE_CONTENT_DURATION 時，系統會在 contentDurationDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "contentDuration": enum (ContentDuration)
}
欄位
contentDuration

enum (ContentDuration)

僅供輸出。內容時間長度。

ContentStreamTypeTargetingOptionDetails

代表可進行的內容串流類型。當 targetingType 為 TARGETING_TYPE_CONTENT_STREAM_TYPE 時，系統會在 contentStreamTypeDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "contentStreamType": enum (ContentStreamType)
}
欄位
contentStreamType

enum (ContentStreamType)

僅供輸出。內容串流類型。

NativeContentPositionTargetingOptionDetails

代表可指定的原生內容位置。當 targetingType 為 TARGETING_TYPE_NATIVE_CONTENT_POSITION 時，系統會在 nativeContentPositionDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "contentPosition": enum (NativeContentPosition)
}
欄位
contentPosition

enum (NativeContentPosition)

僅供輸出。內容位置。

OmidTargetingOptionDetails

代表已啟用 Open Measurement 的廣告空間類型。當 targetingType 為 TARGETING_TYPE_OMID 時，系統會在 omidDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "omid": enum (Omid)
}
欄位
omid

enum (Omid)

僅供輸出。已啟用 Open Measurement 的廣告空間類型。

AudioContentTypeTargetingOptionDetails

代表可指定的音訊內容類型。當 targetingType 為 TARGETING_TYPE_AUDIO_CONTENT_TYPE 時，系統會在 audioContentTypeDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "audioContentType": enum (AudioContentType)
}
欄位
audioContentType

enum (AudioContentType)

僅供輸出。音訊內容類型。

ContentGenreTargetingOptionDetails

代表可指定的內容類型。當 targetingType 為 TARGETING_TYPE_CONTENT_GENRE 時，系統會在 contentGenreDetails 欄位中填入這項資訊。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

僅供輸出。內容類型的顯示名稱

方法

get

 取得單一指定目標選項。

list

 列出指定類型的指定目標選項。
根據特定搜尋字詞，搜尋特定類型的指定選項。