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 時，系統就會在 TargetOption 的 digitalContentLabelDetails 欄位中填入這項資料。

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

enum (ContentRatingTier)

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

SensitiveCategoryTargetingOptionDetails

代表可指定的敏感類別。當 targetingType 為 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 時，系統就會在 TargetOption 的 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 時，系統就會在 TargetOption 的 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 時，系統就會在 TargetOption 的 householdIncomeDetails 欄位中填入這項資料。

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

enum (HouseholdIncome)

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

GenderTargetingOptionDetails

代表可指定的性別。當 targetingType 為 TARGETING_TYPE_GENDER 時，系統就會在 TargetOption 的 genderDetails 欄位中填入這項資料。

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

enum (Gender)

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

DeviceTypeTargetingOptionDetails

代表可指定的裝置類型。當 targetingType 為 TARGETING_TYPE_DEVICE_TYPE 時，系統就會在 TargetOption 的 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 時，系統就會在 TargetOption 的 carrierAndIspDetails 欄位中填入這項資料。

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

string

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

enum (CarrierAndIspType)

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

CarrierAndIspType

CarrierAndIsp TargetingOption 的類型。

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

EnvironmentTargetingOptionDetails

代表可指定的環境。當 targetingType 為 TARGETING_TYPE_ENVIRONMENT 時，系統就會在 TargetOption 的 environmentDetails 欄位中填入這項資料。

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

enum (Environment)

僅供輸出。放送環境。

OperatingSystemTargetingOptionDetails

代表可指定的作業系統。當 targetingType 為 TARGETING_TYPE_OPERATING_SYSTEM 時，系統就會在 TargetOption 的 operatingSystemDetails 欄位中填入這項資料。

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

string

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

DeviceMakeModelTargetingOptionDetails

代表可指定的裝置製造商和型號。當 targetingType 為 TARGETING_TYPE_DEVICE_MAKE_MODEL 時，系統就會在 TargetOption 的 deviceMakeModelDetails 欄位中填入這項資料。

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

string

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

ViewabilityTargetingOptionDetails

代表可指定的可視度。當 targetingType 為 TARGETING_TYPE_VIEWABILITY 時，系統就會在 TargetOption 的 viewabilityDetails 欄位中填入這項資料。

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

enum (Viewability)

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

CategoryTargetingOptionDetails

代表可指定的類別。當 targetingType 為 TARGETING_TYPE_CATEGORY 時，系統就會在 TargetOption 的 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 時，系統就會在 TargetOption 的 exchangeDetails 欄位中填入這項資料。

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

enum (Exchange)

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

SubExchangeTargetingOptionDetails

代表可指定的子廣告交易平台。當 targetingType 為 TARGETING_TYPE_SUB_EXCHANGE 時，系統就會在 TargetOption 的 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

僅供輸出。連鎖商店的顯示名稱，例如「肯德基」、「中國銀行」。
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

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