REST Resource: advertisers.adGroups.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)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // 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)

電信業者和網際網路服務供應商詳細資料。這個欄位會在 targetingType 為 TARGETING_TYPE_CARRIER_AND_ISP 時填入資料。
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

關鍵字詳細資料。這個欄位會在 targetingType 為 TARGETING_TYPE_KEYWORD 時填入。

資源最多可指派 5000 個直接排除關鍵字。可指派的正向關鍵字數量沒有上限。
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，系統會填入這個欄位。
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

YouTube 頻道組合/方案詳細資料。如果 targetingType 為 TARGETING_TYPE_YOUTUBE_CHANNEL_PACK，系統會填入這個欄位。

繼承

指出指派的指定選項是否沿用自較高層級的實體，例如合作夥伴或廣告主。系統會優先套用繼承的指定目標選項，且一律會套用在目前層級指定的指定目標上，無法透過目前的實體服務修改。必須透過繼承這些屬性的實體服務進行修改。如果是在父項層級設定，則繼承只適用於負向指定的頻道、排除的敏感類別和排除的數位內容標籤。

列舉
INHERITANCE_UNSPECIFIED 繼承狀態不明或未指定。
NOT_INHERITED 指派的指定目標選項並非從較高層級的實體繼承而來。
INHERITED_FROM_PARTNER 指派的指定目標選項會沿用夥伴指定目標設定。
INHERITED_FROM_ADVERTISER 指派的指定目標選項沿用自廣告主指定目標設定。

ChannelAssignedTargetingOptionDetails

已指派的頻道指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_CHANNEL 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{
  "channelId": string,
  "negative": boolean
}
欄位
channelId

string (int64 format)

必填。頻道的 ID。應參閱合作夥伴擁有的頻道或廣告主擁有的頻道資源中的頻道 ID 欄位。
negative

boolean

指出這個選項是否受到負面指定目標。如果是廣告主層級的指定目標選項，這個欄位必須為 true。

AppCategoryAssignedTargetingOptionDetails

已指派應用程式類別指定目標選項的詳細資料。當 targetingType 為 TARGETING_TYPE_APP_CATEGORY 時，系統會將此值填入 AssignedTargetingOption 的 appCategoryDetails 欄位。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

僅供輸出。應用程式類別的顯示名稱。
targetingOptionId

string

必填。targetingType 為 TARGETING_TYPE_APP_CATEGORY 時的 targetingOptionId 欄位。
negative

boolean

指出這個選項是否遭到負面指定。

AppAssignedTargetingOptionDetails

已指派應用程式指定目標選項的詳細資料。當 targetingType 為 TARGETING_TYPE_APP 時，系統會填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
欄位
appId

string

必填。應用程式的 ID。

Android 的 Play 商店應用程式使用軟體包 ID，例如 com.google.android.gm。Apple 的 App Store 應用程式 ID 使用 9 位數的字串，例如 422689480。
displayName

string

僅供輸出。應用程式的顯示名稱。
negative

boolean

指出這個選項是否遭到負面指定。
appPlatform

enum (AppPlatform)

指出目標應用程式的平台。如未指定這個欄位，系統會將應用程式平台視為行動平台 (即 Android 或 iOS)，我們會根據應用程式 ID 推導出適當的行動平台。

AppPlatform

可用的應用程式平台指定目標選項。

列舉
APP_PLATFORM_UNSPECIFIED 如果這個版本未指定應用程式平台，則為預設值。這個列舉是預設值的預留位置，不代表實際的平台選項。
APP_PLATFORM_IOS 應用程式平台為 iOS。
APP_PLATFORM_ANDROID 應用程式平台為 Android。
APP_PLATFORM_ROKU 應用程式平台為 Roku。
APP_PLATFORM_AMAZON_FIRETV 應用程式平台為 Amazon Fire TV。
APP_PLATFORM_PLAYSTATION 應用程式平台為 Playstation。
APP_PLATFORM_APPLE_TV 應用程式平台為 Apple TV。
APP_PLATFORM_XBOX 應用程式平台為 Xbox。
APP_PLATFORM_SAMSUNG_TV 應用程式平台為 Samsung TV。
APP_PLATFORM_ANDROID_TV 應用程式平台為 Android TV。
APP_PLATFORM_GENERIC_CTV 應用程式平台是未在其他地方明確列出的連網電視平台。
APP_PLATFORM_LG_TV 應用程式平台是 LG TV。
APP_PLATFORM_VIZIO_TV 應用程式平台是 VIZIO TV。
APP_PLATFORM_VIDAA 應用程式平台為 Vidaa。

UrlAssignedTargetingOptionDetails

已指派網址指定目標選項的詳細資料。當 targetingType 為 TARGETING_TYPE_URL 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{
  "url": string,
  "negative": boolean
}
欄位
url

string

必填。網址，例如 example.com。

Display & Video 360 支援兩個層級的子目錄指定功能 (例如 www.example.com/one-subdirectory-level/second-level)，以及五個層級的子網域指定功能 (例如 five.four.three.two.one.example.com)。
negative

boolean

指出這個選項是否遭到負面指定。

DayAndTimeAssignedTargetingOptionDetails

代表一週特定日期的時間區段，並設有開始和結束時間。startHour 代表的時間必須早於 endHour 代表的時間。

JSON 表示法 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
欄位
dayOfWeek

enum (DayOfWeek)

必填。這個日期和時間指定目標設定的星期幾。
startHour

integer

必填。指定日期和時間的開始時數。必須介於 0 (一天開始) 和 23 (一天結束前 1 小時) 之間。
endHour

integer

必填。指定日期和時間的結束時間。必須介於 1 (一天開始後 1 小時) 和 24 (一天結束) 之間。
timeZoneResolution

enum (TimeZoneResolution)

必填。用來判斷這項日期和時間指定目標設定應使用哪個時區的機制。

對於需求開發委刊項，這個欄位一律為 TIME_ZONE_RESOLUTION_ADVERTISER。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 星期一
TUESDAY 週二
WEDNESDAY 週三
THURSDAY 週四
FRIDAY Friday (週五)
SATURDAY Saturday (週六)
SUNDAY 星期日

TimeZoneResolution

解決時區問題的可能方法。

列舉
TIME_ZONE_RESOLUTION_UNSPECIFIED 時區解析度不明或不特定。
TIME_ZONE_RESOLUTION_END_USER 時間會以看到廣告的使用者時區為準。
TIME_ZONE_RESOLUTION_ADVERTISER 系統會以放送廣告的廣告主時區為準。

AgeRangeAssignedTargetingOptionDetails

代表可指定目標的年齡範圍。如果 targetingType 為 TARGETING_TYPE_AGE_RANGE，系統會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

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

enum (AgeRange)

必填。觀眾的年齡範圍。我們僅支援指定目標對象的連續年齡範圍。因此，這個欄位代表的年齡範圍可以是 1) 唯一目標，也可以是 2) 較大連續年齡範圍的一部分。如要擴大連續年齡層指定目標的觸及範圍，請同時指定年齡不詳的目標對象。

RegionalLocationListAssignedTargetingOptionDetails

區域地點清單的指定目標詳細資料。如果 targetingType 為 TARGETING_TYPE_REGIONAL_LOCATION_LIST，系統就會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

JSON 表示法 
{
  "regionalLocationListId": string,
  "negative": boolean
}
欄位
regionalLocationListId

string (int64 format)

必填。區域地點清單的 ID。應參照類型為 TARGETING_LOCATION_TYPE_REGIONAL 的 LocationList 資源的 locationListId 欄位。
negative

boolean

指出這個選項是否遭到負面指定。

ProximityLocationListAssignedTargetingOptionDetails

鄰近地區清單的指定詳細資料。當 targetingType 為 TARGETING_TYPE_PROXIMITY_LOCATION_LIST 時，系統會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

JSON 表示法 
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
欄位
proximityLocationListId

string (int64 format)

必填。鄰近位置清單的 ID。應參照類型為 TARGETING_LOCATION_TYPE_PROXIMITY 的 LocationList 資源的 locationListId 欄位。
proximityRadius

number

必填。半徑，以 proximityRadiusUnit 中設定的距離單位表示。這代表所選位置周圍要指定目標的區域大小。半徑應介於 1 到 500 英里或 800 公里之間。
proximityRadiusUnit

enum (ProximityRadiusUnit)

必填。半徑距離單位。

ProximityRadiusUnit

ProximityRadius 的距離單位列舉。

列舉
PROXIMITY_RADIUS_UNIT_UNSPECIFIED 如果這個版本未指定距離單位，則預設值為 這個列舉是預設值的預留位置，不代表實際的距離單位。
PROXIMITY_RADIUS_UNIT_MILES 半徑距離單位 (英里)。
PROXIMITY_RADIUS_UNIT_KILOMETERS 半徑距離單位 (公里)

GenderAssignedTargetingOptionDetails

已指派的性別指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_GENDER 時，系統會填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (Gender)

必填。目標對象的性別。

VideoPlayerSizeAssignedTargetingOptionDetails

影片播放器大小指定選項詳細資料。當 targetingType 為 TARGETING_TYPE_VIDEO_PLAYER_SIZE 時，系統會填入 videoPlayerSizeDetails 欄位。系統不支援明確指定所有選項。如要達到這個效果，請移除所有影片播放器大小指定目標選項。

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

enum (VideoPlayerSize)

必填。影片播放器大小。

UserRewardedContentAssignedTargetingOptionDetails

指定使用者獎勵內容選項詳細資料。當 targetingType 為 TARGETING_TYPE_USER_REWARDED_CONTENT 時，系統會填入 userRewardedContentDetails 欄位。

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

string

必填。targetingType 為 TARGETING_TYPE_USER_REWARDED_CONTENT 時的 targetingOptionId 欄位。
userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

已指派家長狀態指定目標選項的詳細資料。當 targetingType 為 TARGETING_TYPE_PARENTAL_STATUS 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (ParentalStatus)

必填。目標對象的家長狀態。

ContentInstreamPositionAssignedTargetingOptionDetails

已指派的內容串流內位置指定選項詳細資料。當 targetingType 為 TARGETING_TYPE_CONTENT_INSTREAM_POSITION 時，系統會填入 contentInstreamPositionDetails 欄位。

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

enum (ContentInstreamPosition)

必填。影片或音訊廣告在內容中的串流內位置。
adType

enum (AdType)

僅供輸出。要指定的廣告類型。這項設定僅適用於廣告訂單指定目標，且支援指定廣告類型的新委刊項預設會沿用這項指定目標選項。可能的值為：

  • ，新委刊項會在 lineItemType 為 LINE_ITEM_TYPE_VIDEO_DEFAULT 時沿用這項設定。AD_TYPE_VIDEO
  • ，新委刊項會在 lineItemType 為 LINE_ITEM_TYPE_AUDIO_DEFAULT 時沿用這項設定。AD_TYPE_AUDIO

AdType

代表與廣告相關聯的廣告素材類型。

列舉
AD_TYPE_UNSPECIFIED 這個版本未指定廣告類型或廣告類型不明。
AD_TYPE_DISPLAY 多媒體廣告素材，例如圖片和 HTML5。
AD_TYPE_VIDEO 影片廣告素材，例如在影片播放器中串流內容期間播放的影片廣告。
AD_TYPE_AUDIO 音訊廣告素材，例如在音訊內容期間播放的音訊廣告。

ContentOutstreamPositionAssignedTargetingOptionDetails

已指派的內容外串流位置指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 時，系統會填入 contentOutstreamPositionDetails 欄位。

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

enum (ContentOutstreamPosition)

必填。內容外串流位置。
adType

enum (AdType)

僅供輸出。要指定的廣告類型。這項設定僅適用於廣告訂單指定目標，且支援指定廣告類型的新委刊項預設會沿用這項指定目標選項。可能的值為：

  • ，新委刊項會在 lineItemType 為 LINE_ITEM_TYPE_DISPLAY_DEFAULT 時沿用這項設定。AD_TYPE_DISPLAY
  • ，新委刊項會在 lineItemType 為 LINE_ITEM_TYPE_VIDEO_DEFAULT 時沿用這項設定。AD_TYPE_VIDEO

DeviceTypeAssignedTargetingOptionDetails

裝置類型的指定詳細資料。當 targetingType 為 TARGETING_TYPE_DEVICE_TYPE 時，這項資料會填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (DeviceType)

必填。裝置類型的顯示名稱。
youtubeAndPartnersBidMultiplier

number

僅供輸出。出價調節係數可讓您依據裝置類型，調整廣告的放送頻率。系統會將原始出價乘以調節係數。如果這個欄位的值為 0，表示這個欄位不適用，而不是將原始出價乘以 0。

舉例來說，如果沒有調節係數的出價為 $10.0 美元，而平板電腦的調節係數為 1.5，則平板電腦的出價會是 $15.0 美元。

僅適用於 YouTube 和合作夥伴委刊項。

AudienceGroupAssignedTargetingOptionDetails

已指派的目標對象群組指定選項詳細資料。當 targetingType 為 TARGETING_TYPE_AUDIENCE_GROUP 時，這項資料會填入 AssignedTargetingOption 的詳細資料欄位。每個群組之間的關係為 UNION，但 excludedFirstAndThirdPartyAudienceGroup 和 excludedGoogleAudienceGroup 除外，這兩個群組會使用 COMPLEMENT 做為與其他群組的 INTERSECTION。

JSON 表示法 
{
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedFirstPartyAndPartnerAudienceGroups": [
    {
      object (FirstPartyAndPartnerAudienceGroup)
    }
  ],
  "excludedFirstPartyAndPartnerAudienceGroup": {
    object (FirstPartyAndPartnerAudienceGroup)
  }
}
欄位
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

(選用步驟) 納入的 Google 目標對象群組的 Google 目標對象 ID。僅包含 Google 目標對象 ID。
includedCustomListGroup

object (CustomListGroup)

(選用步驟) 內含自訂名單群組的自訂名單 ID。只包含自訂清單 ID。
includedCombinedAudienceGroup

object (CombinedAudienceGroup)

(選用步驟) 納入的合併目標對象群組的合併目標對象 ID。僅包含合併目標對象 ID。
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

(選用步驟) 已排除的 Google 目標對象群組的 Google 目標對象 ID。用於排除指定目標。這個群組和其他排除目標對象群組的聯集補集，會做為任何正向目標對象指定的交集。只包含興趣相似、潛在目標消費者和已安裝應用程式類型的 Google 目標對象。所有項目在邏輯上會以「OR」連結。
includedFirstPartyAndPartnerAudienceGroups[]

object (FirstPartyAndPartnerAudienceGroup)

(選用步驟) 所含第一方和夥伴目標對象群組的第一方和夥伴目標對象 ID，以及近期活動。每個第一方和夥伴目標對象群組只包含第一方和夥伴目標對象 ID。每個第一方和合作夥伴目標對象群組之間的關係為「交集」，結果會與其他目標對象群組「聯集」。系統會忽略設定相同的重複群組。
excludedFirstPartyAndPartnerAudienceGroup

object (FirstPartyAndPartnerAudienceGroup)

(選用步驟) 排除的第一方和夥伴目標對象群組的第一方和夥伴目標對象 ID 和近期性。用於排除指定目標。這個群組和其他排除目標對象群組的聯集補集，會做為任何正向目標對象指定的交集。所有項目在邏輯上會以「OR」連結。

GoogleAudienceGroup

Google 目標對象群組的詳細資料。所有 Google 目標對象指定目標設定在邏輯上都是「或」關係。

JSON 表示法 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
欄位
settings[]

object (GoogleAudienceTargetingSetting)

必填。Google 目標對象群組中的所有 Google 目標對象指定目標設定。系統會忽略 ID 相同的重複設定。

GoogleAudienceTargetingSetting

Google 目標對象指定設定的詳細資料。

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

string (int64 format)

必填。Google 指定目標對象設定的 Google 目標對象 ID。這個 ID 是 googleAudienceId。

CustomListGroup

自訂清單群組的詳細資料。所有自訂名單指定目標設定在邏輯上都是「OR」關係。

JSON 表示法 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
欄位
settings[]

object (CustomListTargetingSetting)

必填。自訂名單群組中的所有自訂名單指定目標設定。系統會忽略 ID 相同的重複設定。

CustomListTargetingSetting

自訂名單指定目標設定的詳細資料。

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

string (int64 format)

必填。自訂名單指定目標設定的自訂 ID。這個 ID 是 customListId。

CombinedAudienceGroup

合併目標對象群組的詳細資料。所有合併目標對象指定目標設定，在邏輯上都是彼此「OR」的關係。

JSON 表示法 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
欄位
settings[]

object (CombinedAudienceTargetingSetting)

必填。合併目標對象群組中的所有合併目標對象指定目標設定。如果設定重複且 ID 相同，系統會予以忽略。合併目標對象設定數量不得超過五個，否則系統會擲回錯誤。

CombinedAudienceTargetingSetting

合併目標對象指定目標設定的詳細資料。

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

string (int64 format)

必填。合併目標對象指定目標設定的合併目標對象 ID。這個 ID 是 combinedAudienceId。

FirstPartyAndPartnerAudienceGroup

第一方和夥伴目標對象群組的詳細資料。所有第一方和夥伴指定目標設定在邏輯上都是「OR」。

JSON 表示法 
{
  "settings": [
    {
      object (FirstPartyAndPartnerAudienceTargetingSetting)
    }
  ]
}
欄位
settings[]

object (FirstPartyAndPartnerAudienceTargetingSetting)

必填。第一方和夥伴目標對象群組中的所有第一方和夥伴目標對象指定目標設定。不得重複設定相同 ID。

FirstPartyAndPartnerAudienceTargetingSetting

第一方和夥伴目標對象指定設定的詳細資料。

JSON 表示法 
{
  "firstPartyAndPartnerAudienceId": string,
  "recency": enum (Recency)
}
欄位
firstPartyAndPartnerAudienceId

string (int64 format)

必填。第一方和夥伴目標對象指定目標設定的第一方和夥伴目標對象 ID。這個 ID 是 firstPartyAndPartnerAudienceId。
recency

enum (Recency)

必填。第一方和合作夥伴目標對象指定設定的回訪率。僅適用於第一方目標對象，否則系統會忽略。詳情請參閱 https://support.google.com/displayvideo/answer/2949947#recency。如果未指定，系統就不會使用近期限制。

由新到舊

所有支援的第一方和合作夥伴目標對象回訪率值。

列舉
RECENCY_NO_LIMIT 沒有時間限制。
RECENCY_1_MINUTE 最新資料為 1 分鐘前。
RECENCY_5_MINUTES 最新資訊為 5 分鐘前。
RECENCY_10_MINUTES 最近一次更新時間為 10 分鐘前。
RECENCY_15_MINUTES 最近一次的資料為 15 分鐘前。
RECENCY_30_MINUTES 最近一次更新時間為 30 分鐘前。
RECENCY_1_HOUR 最近 1 小時內。
RECENCY_2_HOURS 回訪率為 2 小時。
RECENCY_3_HOURS 最近一次為 3 小時前。
RECENCY_6_HOURS 最近一次為 6 小時。
RECENCY_12_HOURS 回訪率為 12 小時。
RECENCY_1_DAY 回訪率為 1 天。
RECENCY_2_DAYS 回訪率為 2 天。
RECENCY_3_DAYS 回訪率為 3 天。
RECENCY_5_DAYS 回訪率為 5 天。
RECENCY_7_DAYS 回訪率為 7 天。
RECENCY_10_DAYS 回訪率為 10 天。
RECENCY_14_DAYS 回訪率為 14 天。
RECENCY_15_DAYS 回訪率為 15 天。
RECENCY_21_DAYS 回訪率為 21 天。
RECENCY_28_DAYS 回訪率為 28 天。
RECENCY_30_DAYS 回訪率為 30 天。
RECENCY_40_DAYS 回訪率為 40 天。
RECENCY_45_DAYS 回訪率為 45 天。
RECENCY_60_DAYS 回訪率為 60 天。
RECENCY_90_DAYS 回訪率為 90 天。
RECENCY_120_DAYS 回訪率為 120 天。
RECENCY_180_DAYS 回訪率為 180 天。
RECENCY_270_DAYS 回訪率為 270 天。
RECENCY_365_DAYS 回訪率為 365 天。

BrowserAssignedTargetingOptionDetails

指派的瀏覽器指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_BROWSER 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_BROWSER。
negative

boolean

指出這個選項是否為負面指定目標。同一資源上所有已指派的瀏覽器指定目標選項，這個欄位的值都必須相同。

HouseholdIncomeAssignedTargetingOptionDetails

已指派的家庭收入指定選項詳細資料。當 targetingType 為 TARGETING_TYPE_HOUSEHOLD_INCOME 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (HouseholdIncome)

必填。目標對象的家庭收入。

OnScreenPositionAssignedTargetingOptionDetails

畫面上的位置指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_ON_SCREEN_POSITION 時，系統會填入 onScreenPositionDetails 欄位。

JSON 表示法 
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
欄位
targetingOptionId

string

必填。targetingType 為 TARGETING_TYPE_ON_SCREEN_POSITION 時的 targetingOptionId 欄位。
onScreenPosition

enum (OnScreenPosition)

僅供輸出。畫面上的位置。
adType

enum (AdType)

僅供輸出。要指定的廣告類型。這項設定僅適用於廣告訂單指定目標，且支援指定廣告類型的新委刊項預設會沿用這項指定目標選項。可能的值為：

  • ，新委刊項會在 lineItemType 為 LINE_ITEM_TYPE_DISPLAY_DEFAULT 時沿用這項設定。AD_TYPE_DISPLAY
  • ，新委刊項會在 lineItemType 為 LINE_ITEM_TYPE_VIDEO_DEFAULT 時沿用這項設定。AD_TYPE_VIDEO

CarrierAndIspAssignedTargetingOptionDetails

已指派的電信業者和網際網路服務供應商 (ISP) 指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_CARRIER_AND_ISP 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_CARRIER_AND_ISP。
negative

boolean

指出這個選項是否受到負面指定目標。同一資源中所有已指派的電信業者和 ISP 指定目標選項，這個欄位的值都必須相同。

KeywordAssignedTargetingOptionDetails

已指派指定關鍵字選項的詳細資料。當 targetingType 為 TARGETING_TYPE_KEYWORD 時，系統會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

JSON 表示法 
{
  "keyword": string,
  "negative": boolean,
  "exemptedPolicyNames": [
    string
  ]
}
欄位
keyword

string

必填。關鍵字，例如 car insurance。

正面關鍵字不得為令人反感的字詞。必須採用 UTF-8 編碼，大小上限為 255 個位元組。最多 80 個半形字元。最多 10 個字。
negative

boolean

指出這個選項是否遭到負面指定。
exemptedPolicyNames[]

string

(選用步驟) 要排除關鍵字的政策名稱。

嘗試指定違反政策的關鍵字時，系統傳回的錯誤會包含相關政策的名稱。請在這個欄位中使用該名稱，將指定關鍵字排除在政策之外。

這個欄位僅適用於指派給需求開發資源的正面指定關鍵字。

NegativeKeywordListAssignedTargetingOptionDetails

排除關鍵字清單的指定目標詳細資料。當 targetingType 為 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST 時，系統會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

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

string (int64 format)

必填。排除關鍵字清單的 ID。應參照 NegativeKeywordList 資源的 negativeKeywordListId 欄位。

OperatingSystemAssignedTargetingOptionDetails

已指派的作業系統指定選項詳細資料。當 targetingType 為 TARGETING_TYPE_OPERATING_SYSTEM 時，系統會在此 operatingSystemDetails 欄位中填入資料。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

string

必填。targetingType 為 TARGETING_TYPE_OPERATING_SYSTEM 時，系統會在 targetingOptionId 欄位中填入指定目標選項 ID。
negative

boolean

指出這個選項是否遭到負面指定。

DeviceMakeModelAssignedTargetingOptionDetails

已指派的裝置廠牌和型號指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_DEVICE_MAKE_MODEL 時，系統會填入 deviceMakeModelDetails 欄位。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

string

必填。targetingType 為 TARGETING_TYPE_DEVICE_MAKE_MODEL 時的 targetingOptionId 欄位。
negative

boolean

指出這個選項是否遭到負面指定。

EnvironmentAssignedTargetingOptionDetails

已指派的環境指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_ENVIRONMENT 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (Environment)

必填。放送環境。

InventorySourceAssignedTargetingOptionDetails

指定廣告空間來源的指定目標詳細資料。如果 targetingType 為 TARGETING_TYPE_INVENTORY_SOURCE，系統就會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

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

string (int64 format)

必填。廣告空間來源的 ID。應參照 InventorySource 資源的 inventorySourceId 欄位。

CategoryAssignedTargetingOptionDetails

已指派的類別指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_CATEGORY 時，系統會填入 categoryDetails 欄位。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

string

必填。targetingType 為 TARGETING_TYPE_CATEGORY 時的 targetingOptionId 欄位。
negative

boolean

指出這個選項是否遭到負面指定。

ViewabilityAssignedTargetingOptionDetails

已指派的可視度指定選項詳細資料。當 targetingType 為 TARGETING_TYPE_VIEWABILITY 時，系統會將此值填入 AssignedTargetingOption 的 viewabilityDetails 欄位。

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

enum (Viewability)

必填。預測可視度百分比。

AuthorizedSellerStatusAssignedTargetingOptionDetails

代表已指派的授權賣方狀態。如果 targetingType 為 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS，系統就會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

如果資源沒有指派的指定目標選項，則會使用「授權直接賣方和經銷商」選項。TARGETING_TYPE_AUTHORIZED_SELLER_STATUS

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

enum (AuthorizedSellerStatus)

僅供輸出。要指定的授權賣家狀態。
targetingOptionId

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS。

LanguageAssignedTargetingOptionDetails

已指派語言指定目標選項的詳細資料。當 targetingType 為 TARGETING_TYPE_LANGUAGE 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_LANGUAGE。
negative

boolean

指出這個選項是否受到負面指定目標。同一資源的所有指派語言指定目標選項，這個欄位的值都必須相同。

GeoRegionAssignedTargetingOptionDetails

已指派的指定區域選項詳細資料。如果 targetingType 為 TARGETING_TYPE_GEO_REGION，系統就會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

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

string

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

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_GEO_REGION。
geoRegionType

enum (GeoRegionType)

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

boolean

指出這個選項是否遭到負面指定。

InventorySourceGroupAssignedTargetingOptionDetails

廣告空間來源群組的指定詳細資料。當 targetingType 為 TARGETING_TYPE_INVENTORY_SOURCE_GROUP 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

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

string (int64 format)

必填。廣告空間來源群組的 ID。應參照 InventorySourceGroup 資源的 inventorySourceGroupId 欄位。

DigitalContentLabelAssignedTargetingOptionDetails

數位內容標籤的指定詳細資料。如果 targetingType 為 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION，系統就會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

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

enum (ContentRatingTier)

必填。要排除的數位內容標籤分級顯示名稱。

SensitiveCategoryAssignedTargetingOptionDetails

敏感類別的指定詳細資料。當 targetingType 為 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 時，這項資料會填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (SensitiveCategory)

必填。這個列舉用於分類要排除的 DV360 敏感類別內容。

ContentThemeAssignedTargetingOptionDetails

內容主題的指定詳細資料。如果 targetingType 為 TARGETING_TYPE_CONTENT_THEME_EXCLUSION，系統就會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

JSON 表示法 
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
欄位
excludedTargetingOptionId

string

必填。要排除的內容主題 ID。
contentTheme

enum (ContentTheme)

僅供輸出。DV360 內容主題分類器的列舉。
excludedContentTheme

enum (ContentTheme)

必填。已分類為「排除」的 DV360 內容主題列舉。

ExchangeAssignedTargetingOptionDetails

指派的交易平台指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_EXCHANGE 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (Exchange)

必填。交易所的列舉值。

SubExchangeAssignedTargetingOptionDetails

已指派的子廣告交易平台指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_SUB_EXCHANGE 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

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

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_SUB_EXCHANGE。

ThirdPartyVerifierAssignedTargetingOptionDetails

已指派的第三方驗證者指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_THIRD_PARTY_VERIFIER 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
欄位
聯集欄位 verifier。可指定第三方驗證服務供應商，為曝光強制套用品牌安全門檻。verifier 只能是下列其中一項：
adloox

object (Adloox)

第三方品牌驗證服務供應商：Scope3 (舊稱 Adloox)。
doubleVerify

object (DoubleVerify)

第三方品牌驗證服務供應商 - DoubleVerify。
integralAdScience

object (IntegralAdScience)

第三方品牌驗證服務供應商：Integral Ad Science。

Adloox

Scope3 (舊稱 Adloox) 品牌安全設定的詳細資料。

JSON 表示法 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
欄位
excludedAdlooxCategories[]

enum (AdlooxCategory)

要排除的 Scope3 類別。
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

(選用步驟) 要排除的 Scope3 詐欺 IVT MFA 類別。
adultExplicitSexualContent

enum (GarmRiskExclusion)

(選用步驟) 排除成人與情色露骨色情內容 GARM 風險範圍。
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

(選用步驟) 犯罪與有害行為內容 GARM 風險範圍 (排除)。
armsAmmunitionContent

enum (GarmRiskExclusion)

(選用步驟) 武器與彈藥內容 GARM 風險範圍 (應排除)。
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

(選用步驟) 死亡、受傷或軍事衝突內容 GARM 風險範圍 (排除)。
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

(選用步驟) 爭議性的敏感社會議題內容 GARM 風險範圍 (排除)。
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

(選用步驟) 要排除的禁藥/酒精內容 GARM 風險範圍。
onlinePiracyContent

enum (GarmRiskExclusion)

(選用步驟) 網路盜版內容 GARM 風險範圍 (排除)。
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

(選用步驟) 排除仇恨言論與攻擊行為內容 GARM 風險範圍。
obscenityProfanityContent

enum (GarmRiskExclusion)

(選用步驟) 排除 GARM 風險範圍內的猥褻與不雅用語內容。
spamHarmfulContent

enum (GarmRiskExclusion)

(選用步驟) 排除垃圾內容或有害內容 GARM 風險範圍。
terrorismContent

enum (GarmRiskExclusion)

(選用步驟) 要排除的恐怖主義內容 GARM 風險範圍。
misinformationContent

enum (GarmRiskExclusion)

(選用步驟) 要排除的錯誤資訊內容 GARM 風險範圍。
displayIabViewability

enum (DisplayIabViewability)

(選用步驟) 多媒體廣告的 IAB 可視度門檻。
videoIabViewability

enum (VideoIabViewability)

(選用步驟) 影片廣告的 IAB 可視度門檻。

AdlooxCategory

可用的 Scope3 (舊稱 Adloox) 類別。

列舉
ADLOOX_UNSPECIFIED 如果未指定 Scope3 類別，或這個版本中沒有該類別，則會使用預設值。
ADULT_CONTENT_HARD 成人內容 (限制級)。
ADULT_CONTENT_SOFT 成人內容 (軟性)。
ILLEGAL_CONTENT 非法內容。
BORDERLINE_CONTENT 瀕臨違規內容。
DISCRIMINATORY_CONTENT 歧視性內容。
VIOLENT_CONTENT_WEAPONS 暴力內容和武器。
LOW_VIEWABILITY_DOMAINS 低可視度網域。
FRAUD 詐欺。

FraudIvtMfaCategory

提供 Scope3 (舊稱 Adloox) 詐欺、無效流量、MFA 類別。

列舉
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED 如果未指定或無法判斷這個版本的 Scope3 詐欺、無效流量、MFA 類別，則會使用預設值。
FRAUD_IVT_MFA 詐欺、無效流量、MFA。

GarmRiskExclusion

提供 GARM 風險等級排除選項。

列舉
GARM_RISK_EXCLUSION_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何 GARM 風險排除選項。
GARM_RISK_EXCLUSION_FLOOR 排除最低風險。
GARM_RISK_EXCLUSION_HIGH 排除高風險和最低風險。
GARM_RISK_EXCLUSION_MEDIUM 排除中、高和最低風險。
GARM_RISK_EXCLUSION_LOW 排除所有風險等級 (低、中、高和最低)。

DisplayIabViewability

提供 Scope3 (舊稱 Adloox) IAB 多媒體廣告可視度門檻。

列舉
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED 如果未指定或此版本中未知，則為預設值。
DISPLAY_IAB_VIEWABILITY_10 觀看率 10%以上 (依 IAB 螢幕可視度標準定義)。
DISPLAY_IAB_VIEWABILITY_20 觀看率 20%以上 (依 IAB 多媒體可視度標準定義)。
DISPLAY_IAB_VIEWABILITY_35 觀看率 35%以上 (依 IAB 多媒體廣告可視度標準定義)。
DISPLAY_IAB_VIEWABILITY_50 觀看率 50%以上 (依 IAB 多媒體可視度標準定義)。
DISPLAY_IAB_VIEWABILITY_75 觀看率 75%以上 (依 IAB 多媒體廣告可視度標準定義)。

VideoIabViewability

可用的 Scope3 (舊稱 Adloox) IAB 影片可視度門檻。

列舉
VIDEO_IAB_VIEWABILITY_UNSPECIFIED 如果未指定或此版本中未知，則為預設值。
VIDEO_IAB_VIEWABILITY_10 觀看率 10%以上 (依 IAB 影片可視度標準定義)。
VIDEO_IAB_VIEWABILITY_20 觀看率 20%以上 (依 IAB 影片可視度標準定義)。
VIDEO_IAB_VIEWABILITY_35 觀看率 35%以上 (依 IAB 影片可視度標準定義)。
VIDEO_IAB_VIEWABILITY_50 觀看率 50%以上 (依 IAB 影片可視度標準定義)。
VIDEO_IAB_VIEWABILITY_75 觀看率 75%以上 (依 IAB 影片可視度標準定義)。

DoubleVerify

DoubleVerify 設定的詳細資料。

JSON 表示法 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
欄位
brandSafetyCategories

object (BrandSafetyCategories)

DV 品牌安全控管。
avoidedAgeRatings[]

enum (AgeRating)

避免對該年齡分級的應用程式出價。
appStarRating

object (AppStarRating)

避免對有星級評等的應用程式出價。
displayViewability

object (DisplayViewability)

多媒體可視度設定 (僅適用於多媒體委刊項)。
videoViewability

object (VideoViewability)

影片可視度設定 (僅適用於影片委刊項)。
fraudInvalidTraffic

object (FraudInvalidTraffic)

避免指定有詐欺和無效流量率記錄的網站和應用程式。
customSegmentId

string (int64 format)

DoubleVerify 提供的自訂區隔 ID。ID 開頭必須是「51」，且由八位數組成。自訂區隔 ID 無法與下列任一欄位一併指定：

BrandSafetyCategories

品牌安全控制選項的設定。

JSON 表示法 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
欄位
avoidUnknownBrandSafetyCategory

boolean

不明或無法評估。
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

品牌安全高嚴重程度排除類別。
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

品牌安全中等嚴重程度排除類別。

HighSeverityCategory

高嚴重性類別的可能選項。

列舉
HIGHER_SEVERITY_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何嚴重程度高的類別。
ADULT_CONTENT_PORNOGRAPHY 成人內容：色情、限制級主題與裸露內容。
COPYRIGHT_INFRINGEMENT 著作權侵害。
SUBSTANCE_ABUSE 藥物/酒精飲料/管制藥品：藥物濫用。
GRAPHIC_VIOLENCE_WEAPONS 極度血腥/露骨暴力/武器。
HATE_PROFANITY 仇恨/不雅用語。
CRIMINAL_SKILLS 非法活動：犯罪手法。
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER 獎勵的流量/惡意軟體/間諜軟體。

MediumSeverityCategory

中等嚴重程度類別的可能選項。

列舉
MEDIUM_SEVERITY_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何中等嚴重程度類別。
AD_SERVERS 廣告伺服器。
ADULT_CONTENT_SWIMSUIT 成人內容：泳裝。
ALTERNATIVE_LIFESTYLES 爭議性主題：另類生活型態。
CELEBRITY_GOSSIP 爭議性主題：名人八卦。
GAMBLING 爭議性主題：賭博。
OCCULT 爭議性主題：神祕現象。
SEX_EDUCATION 爭議性主題：性教育。
DISASTER_AVIATION 災害：空難。
DISASTER_MAN_MADE 災害：人為災害。
DISASTER_NATURAL 災害：天災。
DISASTER_TERRORIST_EVENTS 災害：恐怖攻擊。
DISASTER_VEHICLE 災害：車輛。
ALCOHOL 藥物/酒精飲料/管制藥品：酒精飲料。
SMOKING 藥物/酒精飲料/管制藥品：吸菸。
NEGATIVE_NEWS_FINANCIAL 負面新聞：財經。
NON_ENGLISH 非標準內容：非英文。
PARKING_PAGE 非標準內容：停放網頁。
UNMODERATED_UGC 不受管理的使用者原創內容：論壇、圖片與影片。
INFLAMMATORY_POLITICS_AND_NEWS 爭議性主題：煽動性政治議題和新聞。
NEGATIVE_NEWS_PHARMACEUTICAL 負面新聞：藥物。

AgeRating

可能的年齡分級選項。

列舉
AGE_RATING_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何年齡分級選項。
APP_AGE_RATE_UNKNOWN 年齡分級不明的應用程式。
APP_AGE_RATE_4_PLUS 年齡分級為適合所有人 (4 歲以上) 的應用程式。
APP_AGE_RATE_9_PLUS 年齡分級為適合所有人 (9 歲以上) 的應用程式。
APP_AGE_RATE_12_PLUS 年齡分級為適合青少年 (12 歲以上) 的應用程式。
APP_AGE_RATE_17_PLUS 年齡分級為適合成年人 (17 歲以上) 的應用程式。
APP_AGE_RATE_18_PLUS 年齡分級為「僅限成人」(18 歲以上) 的應用程式。

AppStarRating

DoubleVerify 星級評等設定的詳細資料。

JSON 表示法 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
欄位
avoidedStarRating

enum (StarRating)

避免對有星級評等的應用程式出價。
avoidInsufficientStarRating

boolean

避免對星級評等不足的應用程式出價。

StarRating

星級評等可能選項。

列舉
APP_STAR_RATE_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何應用程式星級評分選項。
APP_STAR_RATE_1_POINT_5_LESS 星級評等少於 1.5 顆星的官方應用程式。
APP_STAR_RATE_2_LESS 星級評等少於 2 顆星的官方應用程式。
APP_STAR_RATE_2_POINT_5_LESS 星級評等少於 2.5 顆星的官方應用程式。
APP_STAR_RATE_3_LESS 星級評等少於 3 顆星的官方應用程式。
APP_STAR_RATE_3_POINT_5_LESS 星級評等少於 3.5 顆星的官方應用程式。
APP_STAR_RATE_4_LESS 星級評等少於 4 顆星的官方應用程式。
APP_STAR_RATE_4_POINT_5_LESS 星級評等少於 4.5 顆星的官方應用程式。

DisplayViewability

DoubleVerify 顯示廣告可視度設定的詳細資料。

JSON 表示法 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
欄位
iab

enum (IAB)

指定可最大化 IAB 可視率的網站和應用程式廣告空間。
viewableDuring

enum (ViewableDuring)

指定可最大化 100% 可視時間長度的網站和應用程式廣告空間。

IAB

IAB 可視率的可能選項。

列舉
IAB_VIEWED_RATE_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何 IAB 觀看率選項。
IAB_VIEWED_RATE_80_PERCENT_HIGHER 指定可最大化 IAB 可視率 (80% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_75_PERCENT_HIGHER 指定可最大化 IAB 可視率 (75% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_70_PERCENT_HIGHER 指定可最大化 IAB 可視率 (70% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_65_PERCENT_HIGHER 指定可最大化 IAB 可視率 (65% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_60_PERCENT_HIGHER 指定可最大化 IAB 可視率 (60% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_55_PERCENT_HIGHER 指定可最大化 IAB 可視率 (55% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_50_PERCENT_HIGHER 指定可最大化 IAB 可視率 (50% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_40_PERCENT_HIGHER 指定可最大化 IAB 可視率 (40% 以上) 的網站和應用程式廣告空間。
IAB_VIEWED_RATE_30_PERCENT_HIGHER 指定可最大化 IAB 可視率 (30% 以上) 的網站和應用程式廣告空間。

ViewableDuring

可觀看時間長度的可能選項。

列舉
AVERAGE_VIEW_DURATION_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何平均觀看時間選項。
AVERAGE_VIEW_DURATION_5_SEC 指定可最大化 100% 可視時間長度 (5 秒以上) 的網站和應用程式廣告空間。
AVERAGE_VIEW_DURATION_10_SEC 指定可最大化 100% 可視時間長度 (10 秒以上) 的網站和應用程式廣告空間。
AVERAGE_VIEW_DURATION_15_SEC 指定可最大化 100% 可視時間長度 (至少 15 秒) 的網站和應用程式廣告空間。

VideoViewability

DoubleVerify 影片可視度設定的詳細資料。

JSON 表示法 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
欄位
videoIab

enum (VideoIAB)

指定可最大化 IAB 可視率的網站廣告空間。
videoViewableRate

enum (VideoViewableRate)

指定可最大化完整可視率的網站廣告空間。
playerImpressionRate

enum (PlayerImpressionRate)

指定廣告空間，盡量爭取 400x300 像素以上播放器尺寸的曝光次數。

VideoIAB

IAB 可視率的可能選項。

列舉
VIDEO_IAB_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何影片 IAB 可視率選項。
IAB_VIEWABILITY_80_PERCENT_HIGHER 指定可最大化 IAB 可視率 (80% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_75_PERCENT_HIGHER 指定可最大化 IAB 可視率 (75% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_70_PERCENT_HIGHER 指定可最大化 IAB 可視率 (70% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_65_PERCENT_HIHGER 指定可最大化 IAB 可視率 (65% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_60_PERCENT_HIGHER 指定可最大化 IAB 可視率 (60% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_55_PERCENT_HIHGER 指定可最大化 IAB 可視率 (55% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_50_PERCENT_HIGHER 指定可最大化 IAB 可視率 (50% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_40_PERCENT_HIHGER 指定可最大化 IAB 可視率 (40% 以上) 的網站和應用程式廣告空間。
IAB_VIEWABILITY_30_PERCENT_HIHGER 指定可最大化 IAB 可視率 (30% 以上) 的網站和應用程式廣告空間。

VideoViewableRate

可視率的可能選項。

列舉
VIDEO_VIEWABLE_RATE_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何影片可觀看率選項。
VIEWED_PERFORMANCE_40_PERCENT_HIGHER 指定可最大化完整可視率 (40% 以上) 的網站廣告空間。
VIEWED_PERFORMANCE_35_PERCENT_HIGHER 指定可最大化完整可視率 (35% 以上) 的網站廣告空間。
VIEWED_PERFORMANCE_30_PERCENT_HIGHER 指定可最大化完整可視率 (30% 以上) 的網站廣告空間。
VIEWED_PERFORMANCE_25_PERCENT_HIGHER 指定可最大化完整可視率 (25% 以上) 的網站廣告空間。
VIEWED_PERFORMANCE_20_PERCENT_HIGHER 指定可最大化完整可視率 (20% 以上) 的網站廣告空間。
VIEWED_PERFORMANCE_10_PERCENT_HIGHER 指定可最大化完整可視率 (10% 以上) 的網站廣告空間。

PlayerImpressionRate

可能的曝光次數選項。

列舉
PLAYER_SIZE_400X300_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何曝光選項。
PLAYER_SIZE_400X300_95 曝光次數占 95%以上的網站。
PLAYER_SIZE_400X300_70 曝光次數占 70%以上的網站。
PLAYER_SIZE_400X300_25 曝光次數占比達 25%以上的網站。
PLAYER_SIZE_400X300_5 曝光次數占 5%以上的網站。

FraudInvalidTraffic

DoubleVerify 詐欺和無效流量設定。

JSON 表示法 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
欄位
avoidedFraudOption

enum (FraudOption)

避免指定有詐欺和無效流量記錄的網站和應用程式。
avoidInsufficientOption

boolean

詐欺和無效流量統計資料記錄不足。

FraudOption

詐欺和無效流量率記錄的可能選項。

列舉
FRAUD_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何詐欺和無效流量選項。
AD_IMPRESSION_FRAUD_100 詐欺和無效流量率達 100%。
AD_IMPRESSION_FRAUD_50 詐欺和 IVT 率達 50% 以上。
AD_IMPRESSION_FRAUD_25 詐欺和 IVT 率達 25% 以上。
AD_IMPRESSION_FRAUD_10 詐欺和 IVT 率達 10% 以上。
AD_IMPRESSION_FRAUD_8 詐欺和 IVT 率達 8% 以上。
AD_IMPRESSION_FRAUD_6 詐欺和 IVT 率達 6% 以上。
AD_IMPRESSION_FRAUD_4 詐欺和 IVT 率達 4% 以上。
AD_IMPRESSION_FRAUD_2 詐欺和 IVT 率達 2% 以上。

IntegralAdScience

Integral Ad Science 設定的詳細資料。

JSON 表示法 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
欄位
traqScoreOption

enum (TRAQScore)

真實廣告品質 (僅適用於多媒體廣告委刊項)。
excludeUnrateable

boolean

品牌安全 - 無法評分。
excludedAdultRisk

enum (Adult)

品牌安全 - 成人內容。
excludedAlcoholRisk

enum (Alcohol)

品牌安全 - 酒精飲料。
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

品牌安全 - 非法下載。
excludedDrugsRisk

enum (Drugs)

品牌安全 - 藥物。
excludedHateSpeechRisk

enum (HateSpeech)

品牌安全 - 仇恨言論。
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

品牌安全 - 用字令人反感。
excludedViolenceRisk

enum (Violence)

品牌安全 - 暴力內容。
excludedGamblingRisk

enum (Gambling)

品牌安全 - 賭博。
excludedAdFraudRisk

enum (AdFraudPrevention)

廣告詐欺設定。
displayViewability

enum (DisplayViewability)

「多媒體廣告可視度」部分 (僅適用於多媒體委刊項)。
videoViewability

enum (VideoViewability)

影片可視度部分 (僅適用於影片委刊項)。
customSegmentId[]

string (int64 format)

Integral Ad Science 提供的自訂區隔 ID。ID 必須介於 1000001 至 1999999 或 3000001 至 3999999 之間 (含首尾)。
qualitySyncCustomSegmentId[]

string (int64 format)

(選用步驟) Integral Ad Science 提供的品質同步自訂區隔 ID。ID 必須介於 3000000 和 4999999 之間 (含首尾)。

TRAQScore

Integral Ad Science TRAQ (真實廣告品質) 分數範圍。

列舉
TRAQ_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何實際的廣告品質分數。
TRAQ_250 TRAQ 分數介於 250 到 1000 分。
TRAQ_500 TRAQ 分數介於 500 到 1000 分。
TRAQ_600 TRAQ 分數為 600 到 1000 分。
TRAQ_700 TRAQ 分數介於 700 到 1000 分。
TRAQ_750 TRAQ 分數介於 750 到 1000 分。
TRAQ_875 TRAQ 分數為 875 至 1000 分。
TRAQ_1000 TRAQ 分數為 1000 分。

成人

Integral Ad Science 可能的成人選項。

列舉
ADULT_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何成人選項。
ADULT_HR 成人 - 排除高風險。
ADULT_HMR 成人 - 排除高與中風險。

酒精飲料

可能的 Integral Ad Science 酒精飲料選項。

列舉
ALCOHOL_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何酒精飲料選項。
ALCOHOL_HR 酒精飲料 - 排除高風險。
ALCOHOL_HMR 酒精飲料 - 排除高與中風險。

IllegalDownloads

Integral Ad Science 可能的非法下載選項。

列舉
ILLEGAL_DOWNLOADS_UNSPECIFIED 這個列舉只是一個預留位置，並未指定任何非法下載選項。
ILLEGAL_DOWNLOADS_HR 非法下載 - 排除高風險。
ILLEGAL_DOWNLOADS_HMR 非法下載 - 排除高與中風險。

藥物

可能的 Integral Ad Science Drugs 選項。

列舉
DRUGS_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何藥物選項。
DRUGS_HR 毒品 - 排除高風險。
DRUGS_HMR 毒品 - 排除高與中風險。

HateSpeech

可能的 Integral Ad Science 仇恨言論選項。

列舉
HATE_SPEECH_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何仇恨言論選項。
HATE_SPEECH_HR 仇恨言論 - 排除高風險。
HATE_SPEECH_HMR 仇恨言論 - 排除高與中風險。

OffensiveLanguage

Integral Ad Science 可能提供的冒犯性語言選項。

列舉
OFFENSIVE_LANGUAGE_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何語言選項。
OFFENSIVE_LANGUAGE_HR 令人反感的用語 - 排除高風險。
OFFENSIVE_LANGUAGE_HMR 令人反感的用語 - 排除高與中風險。

暴力

Integral Ad Science 暴力選項。

列舉
VIOLENCE_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何暴力選項。
VIOLENCE_HR 暴力 - 排除高風險。
VIOLENCE_HMR 暴力 - 排除高與中風險。

賭博

Integral Ad Science 可能的賭博選項。

列舉
GAMBLING_UNSPECIFIED 這個列舉僅為預留位置，並未指定任何賭博選項。
GAMBLING_HR 賭博 - 排除高風險。
GAMBLING_HMR 賭博 - 排除高與中風險。

AdFraudPrevention

Integral Ad Science 廣告詐騙防護選項。

列舉
SUSPICIOUS_ACTIVITY_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何廣告詐欺防範選項。
SUSPICIOUS_ACTIVITY_HR 廣告詐欺 - 排除高風險。
SUSPICIOUS_ACTIVITY_HMR 廣告詐欺 - 排除高與中風險。
SUSPICIOUS_ACTIVITY_FD 廣告詐欺 - 排除詐欺裝置。

DisplayViewability

Integral Ad Science 多媒體廣告可視度選項。

列舉
PERFORMANCE_VIEWABILITY_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何顯示可視度選項。
PERFORMANCE_VIEWABILITY_40 指定 40% 以上的可視度。
PERFORMANCE_VIEWABILITY_50 指定 50% 以上的可視度。
PERFORMANCE_VIEWABILITY_60 指定 60% 以上的可視度。
PERFORMANCE_VIEWABILITY_70 指定 70% 以上的可視度。

VideoViewability

Integral Ad Science 影片可視度選項。

列舉
VIDEO_VIEWABILITY_UNSPECIFIED 這個列舉僅為預留位置，不會指定任何影片可視度選項。
VIDEO_VIEWABILITY_40 觀看率 40%以上 (依 IAB 影片可視度標準定義)。
VIDEO_VIEWABILITY_50 觀看率 50%以上 (依 IAB 影片可視度標準定義)。
VIDEO_VIEWABILITY_60 觀看率 60%以上 (依 IAB 影片可視度標準定義)。
VIDEO_VIEWABILITY_70 觀看率 70%以上 (依 IAB 影片可視度標準定義)。

PoiAssignedTargetingOptionDetails

已指派的搜尋點指定目標選項詳細資料。如果 targetingType 為 TARGETING_TYPE_POI，系統就會在 AssignedTargetingOption 的詳細資料欄位中填入這項資訊。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
欄位
displayName

string

僅供輸出。地標的顯示名稱，例如「時代廣場」、「西雅圖太空針塔」，後面接著完整地址 (如有)。
targetingOptionId

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_POI。

您可以使用 targetingTypes.targetingOptions.search 擷取可接受的搜尋點指定選項 ID。

如要指定從地址或搜尋點名稱中移除的特定經緯度座標，請將所需座標值四捨五入至小數點後第 6 位，移除小數點，並以半形分號分隔串連字串值，即可產生必要的指定目標選項 ID。舉例來說，您可以透過指定目標選項 ID「40741469;-74003387」，指定經緯度配對 40.7414691、-74.003387。建立後，如果只提供經緯度座標，這個欄位值會更新為附加半形分號和英數字元雜湊值。
latitude

number

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

number

僅供輸出。搜尋點的經度，四捨五入至小數點後第 6 位。
proximityRadiusAmount

number

必填。要指定 POI 周圍區域的半徑。半徑單位由 proximityRadiusUnit 指定。如果單位為 DISTANCE_UNIT_KILOMETERS，則必須介於 1 到 800 之間；如果單位為 DISTANCE_UNIT_MILES，則必須介於 1 到 500 之間。
proximityRadiusUnit

enum (DistanceUnit)

必填。指定半徑的距離測量單位。

DistanceUnit

可能的距離單位選項。

列舉
DISTANCE_UNIT_UNSPECIFIED 這個版本未指定或不明類型值。
DISTANCE_UNIT_MILES 英里。
DISTANCE_UNIT_KILOMETERS 。

BusinessChainAssignedTargetingOptionDetails

指派的商家連鎖店指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_BUSINESS_CHAIN 時，系統會將這項資料填入 AssignedTargetingOption 的詳細資料欄位。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
欄位
displayName

string

僅供輸出。連鎖商家的顯示名稱，例如「肯德基」、「摩根大通銀行」。
targetingOptionId

string

必填。TargetingOption 的 targetingOptionId，類型為 TARGETING_TYPE_BUSINESS_CHAIN。

您可以使用 SearchTargetingOptions 擷取可接受的連鎖商家指定選項 ID。
proximityRadiusAmount

number

必填。連鎖商家周圍的指定範圍半徑。半徑單位由 proximityRadiusUnit 指定。如果單位為 DISTANCE_UNIT_KILOMETERS，則必須介於 1 到 800 之間；如果單位為 DISTANCE_UNIT_MILES，則必須介於 1 到 500 之間。兩種情況的增量下限皆為 0.1。如果輸入值過於精細，系統會四捨五入至最接近的可接受值，例如 15.57 會變成 15.6。
proximityRadiusUnit

enum (DistanceUnit)

必填。指定半徑的距離測量單位。

ContentDurationAssignedTargetingOptionDetails

為指定內容時間長度指派的指定選項詳細資料。當 targetingType 為 TARGETING_TYPE_CONTENT_DURATION 時，系統會填入 contentDurationDetails 欄位。系統不支援明確指定所有選項。如要達到這個效果，請移除所有內容時間長度指定選項。

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

string

必填。targetingType 為 TARGETING_TYPE_CONTENT_DURATION 時的 targetingOptionId 欄位。
contentDuration

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

為指定目標選項指派內容串流類型的詳細資料。系統會在 targetingType 為 TARGETING_TYPE_CONTENT_STREAM_TYPE 時，在 contentStreamTypeDetails 欄位中填入這項資料。系統不支援明確指定所有選項。如要達到這個效果，請移除所有內容串流類型指定目標選項。

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

string

必填。targetingType 為 TARGETING_TYPE_CONTENT_STREAM_TYPE 時的 targetingOptionId 欄位。
contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

為指定目標選項指派的原生內容位置詳細資料。當 targetingType 為 TARGETING_TYPE_NATIVE_CONTENT_POSITION 時，系統會填入 nativeContentPositionDetails 欄位。系統不支援明確指定所有選項。如要達到這個效果，請移除所有原生內容位置指定目標選項。

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

enum (NativeContentPosition)

必填。內容位置。

OmidAssignedTargetingOptionDetails

代表可指定目標的啟用 Open Measurement 廣告空間類型。當 targetingType 為 TARGETING_TYPE_OMID 時，這項值會填入 AssignedTargetingOption 的詳細資料欄位。

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

enum (Omid)

必填。已啟用 Open Measurement 的廣告空間類型。

AudioContentTypeAssignedTargetingOptionDetails

指派給音訊內容類型的指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_AUDIO_CONTENT_TYPE 時，系統會填入 audioContentTypeDetails 欄位。系統不支援明確指定所有選項。如要達到這個效果，請移除所有音訊內容類型指定目標選項。

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

enum (AudioContentType)

必填。音訊內容類型。

ContentGenreAssignedTargetingOptionDetails

指派給指定目標選項的內容類型詳細資料。當 targetingType 為 TARGETING_TYPE_CONTENT_GENRE 時，系統會填入 contentGenreDetails 欄位。系統不支援明確指定所有選項。如要達到這個效果，請移除所有內容類型指定目標選項。

JSON 表示法 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
欄位
targetingOptionId

string

必填。targetingType 為 TARGETING_TYPE_CONTENT_GENRE 時的 targetingOptionId 欄位。
displayName

string

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

boolean

指出這個選項是否遭到負面指定。

YoutubeVideoAssignedTargetingOptionDetails

已指派 YouTube 影片指定目標選項的詳細資料。當 targetingType 為 TARGETING_TYPE_YOUTUBE_VIDEO 時，系統會填入 youtubeVideoDetails 欄位。

JSON 表示法 
{
  "videoId": string,
  "negative": boolean
}
欄位
videoId

string

YouTube 觀賞頁面顯示的 YouTube 影片 ID。
negative

boolean

指出這個選項是否遭到負面指定。

YoutubeChannelAssignedTargetingOptionDetails

已指派指定目標選項的 YouTube 頻道詳細資料。當 targetingType 為 TARGETING_TYPE_YOUTUBE_CHANNEL 時，系統會填入 youtubeChannelDetails 欄位。

JSON 表示法 
{
  "channelId": string,
  "negative": boolean
}
欄位
channelId

string

YouTube 上傳者頻道 ID 或 YouTube 頻道的頻道代碼。
negative

boolean

指出這個選項是否遭到負面指定。

SessionPositionAssignedTargetingOptionDetails

為工作階段位置指派的指定目標選項詳細資料。當 targetingType 為 TARGETING_TYPE_SESSION_POSITION 時，系統會填入 sessionPositionDetails 欄位。

JSON 表示法 
{
  "sessionPosition": enum (SessionPosition)
}
欄位
sessionPosition

enum (SessionPosition)

廣告在工作階段中顯示的位置。

SessionPosition

工作階段中的可能位置。

列舉
SESSION_POSITION_UNSPECIFIED 這是預留位置，不代表任何職位。
SESSION_POSITION_FIRST_IMPRESSION 工作階段的第一次曝光。

YoutubeChannelPackAssignedTargetingOptionDetails

已指派指定目標選項的 YouTube 頻道組合詳細資料。當 targetingType 為 TARGETING_TYPE_YOUTUBE_CHANNEL_PACK 時，系統會填入 youtubeChannelPackDetails 欄位。

JSON 表示法 
{
  "channelPackId": string,
  "negative": boolean
}
欄位
channelPackId

string (int64 format)

必填。YouTube 頻道組合/方案的 ID。
negative

boolean

(選用步驟) 指出這個選項是否遭到負面指定。

方法

create

 為廣告群組指派指定目標選項。

delete

 從廣告群組中刪除已指派的指定目標選項。

get

 取得指派給廣告群組的單一指定目標選項。

list

 列出指派給廣告群組的指定目標選項。