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)

網址詳細資料。當 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)

已啟用 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

 列出指派給廣告訂單的指定目標選項。