本頁提供 Display & Video 360 API 的版本資訊。
最新 API 版本:v3
2024 年 4 月 23 日
新功能
新增對新的 KPI 類型、廣告交易平台和應用程式平台的支援。
v3
已新增下列欄位:
資源 欄位 KPI 已新增以下列舉值:
列舉 值 AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
廣告交易平台 EXCHANGE_DRAX
KpiType KPI_TYPE_CPCL
KPI_TYPE_CPCV
KPI_TYPE_CPV
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST
KPI_TYPE_MAXIMIZE_PACING
KPI_TYPE_TOS10
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
v2
已新增以下列舉值:
列舉 值 AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
廣告交易平台 EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
2024 年 2 月 28 日
新功能
新增從目標客戶比對目標對像中明確移除成員的功能。
新增指定新廣告交易平台的支援功能。
v3
已新增下列欄位:
資源 欄位 firstAndThirdPartyAudiences.editCustomerMatchMembers 已新增以下列舉值:
列舉 值 廣告交易平台 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
已新增下列欄位:
資源 欄位 firstAndThirdPartyAudiences.editCustomerMatchMembers 已新增以下列舉值:
列舉 值 廣告交易平台 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
2024 年 1 月 29 日
新功能
新增透過新的 floodlightGroups.floodlightActivities
服務擷取 Floodlight 活動的功能。
新增欄位,顯示 YouTube 與合作夥伴委刊項的指定目標是否包含 Google TV 廣告空間。
新增欄位,以便轉發 Display & Video 360 使用者的上次登入時間。
v3
已新增下列方法:
服務 方法 floodlightGroups.floodlightActivities 已新增下列欄位:
資源 欄位 User YoutubeAndPartnersInventorySourceConfig
v2
已新增下列方法:
服務 方法 floodlightGroups.floodlightActivities 已新增下列欄位:
資源 欄位 User YoutubeAndPartnersInventorySourceConfig
2023 年 11 月 14 日
新功能
開始支援在所有上線版本中上傳目標客戶比對目標對象成員時,傳送使用者同意聲明。
v3
已新增下列欄位:
資源 欄位 ContactInfoList MobileDeviceIdList
v2
已新增下列欄位:
資源 欄位 ContactInfoList MobileDeviceIdList
2023 年 10 月 31 日
新功能
第 3 版已進入公開測試版,並全面開放使用。
在 v3 中重新命名 AdGroupFormat
列舉值,以更準確反映相關格式。
在第 2 版和第 3 版中加入 SDF_VERSION_7
列舉值,開始支援結構化資料檔案 v7。
v3
下列列舉值已移除:
列舉 值 AdGroupFormat AD_GROUP_FORMAT_ACTION
已新增以下列舉值:
列舉 值 AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
已新增以下列舉值:
列舉 值 SdfVersion SDF_VERSION_7
2023 年 10 月 2 日
新功能
推出公開測試版的第 3 版,其中包括下列變更:
- 完全管理鄰近地點清單,可以使用
advertisers.locationLists.assignedLocations
服務建立及刪除指派給TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
資源的地點。 - 新的布林值
enableOptimizedTargeting
欄位,用於取代TargetingExpansionConfig
物件中的targetingExpansionLevel
欄位。 Advertiser
資源中billingConfig
欄位的必要項目;提出advertisers.create
要求時必須加入此欄位,並在Partner
資源中新增billingConfig
欄位。- 新增
AdGroup
和AdGroupAd
資源,用於取代 v2 中的YoutubeAdGroup
和YoutubeAdGroupAd
資源。
請按照遷移指南中的步驟,從第 2 版遷移至第 3 版。
新增支援 3 個新的 LineItemType
值、一個新的 YoutubeAndPartnersBiddingStrategyType
值,以及 2 版和 3 版中的一個新 PartnerCostType
。
v3
已新增下列方法:
服務 方法 advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 下列方法已經移除:
服務 方法 advertisers.manualTriggers 啟用
create
停用。
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
下列方法行為已變更:
方法 變更 advertisers.locationLists.create 現已支援建立 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
資源。advertisers.locationLists.patch 現在支援更新 TARGETING_LOCATION_TYPE_PROXIMITY
項LocationList
資源。advertisers.locationLists.assignedLocations.bulkEdit 現可支援大量編輯 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
資源中的AssignedLocation
資源。advertisers.locationLists.assignedLocations.create 現已支援在 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
資源中建立AssignedLocation
資源。已新增下列查詢參數:
方法 參數 inventorySources.get 以下為必填欄位:
資源 欄位 廣告客戶 已新增下列欄位:
資源 欄位 BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig 下列欄位已遭移除:
資源 欄位 InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
已新增以下列舉值:
列舉 值 CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
下列列舉值已移除:
列舉 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
已新增以下列舉值:
列舉 值 LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
2023 年 8 月 25 日
新功能
新增兩種廣告交易平台支援,以及兩種新的 YouTube 與合作夥伴出價策略類型。
在 YouTube 與合作夥伴委刊項中新增 effectiveContentCategory
欄位,以便在考慮在廣告客戶和委刊項層級指派的值時,顯示委刊項使用的 YoutubeAndPartnersContentCategory
。
v2
已新增下列欄位:
資源 欄位 YoutubeAndPartnersSettings 下列欄位已遭移除:
資源 欄位 InventorySource subSitePropertyId
已新增以下列舉值:
列舉 值 廣告交易平台 EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
2023 年 6 月 5 日
新功能
為第 1 版和第 2 版中的結構化資料檔案 (SDF) v6 新增 SdfVersion
值。
v2
已新增以下列舉值:
列舉 值 SdfVersion SDF_VERSION_6
v1
已新增以下列舉值:
列舉 值 SdfVersion SDF_VERSION_6
2023 年 3 月 9 日
新功能
新增 LineItemWarningMessage
值;如果這個欄位的已淘汰 excludeFirstPartyAudience
欄位設為 true
,則會指派給委刊項的 warningMessages
欄位。excludeFirstPartyAudience
欄位將於 2023 年 3 月 25 日後停用,並設為 false
。
v2
已新增以下列舉值:
列舉 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
已新增以下列舉值:
列舉 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
2023 年 2 月 8 日
新功能
新增擷取 YouTubeAdGroup
和 YouTubeAdGroupAd
資源的功能,以及 YouTube 廣告群組資源指定功能。此外,我們還加入了可在 YouTube 廣告群組層級使用的可擷取指定類型。詳情請參閱新的 YouTube 與合作夥伴擷取資源指南。
第 1 版和第 2 版新增了四種廣告交易平台支援。
v2
已新增下列方法:
服務 方法 advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions 已新增下列欄位:
服務 方法 AssignedTargetingOption YoutubeAndPartnersSettings 已新增以下列舉值:
列舉 值 廣告交易平台 EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
已新增以下列舉值:
列舉 值 廣告交易平台 EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
2022 年 12 月 6 日
新功能
第 2 版已從公開測試版移至一般發布版本。
在 AssignedTargetingOption
資源中新增 assignedTargetingOptionIdAlias
欄位,可用於在擷取及刪除指定目標時取代 assignedTargetingOptionId
。這個欄位只適用於透過列舉指定的指定類型指定目標選項。別名值是字串的相關列舉值。
在 Advertiser
資源中新增 billingConfig
欄位。
新增透過三個新的 LineItemType
值識別 YouTube 與合作夥伴 over-the-top 委刊項的支援功能。
在 v1 和 v2 中,將多種 list
方法的網頁大小上限提高到 200 個。預設頁面大小維持不變。
v2
已新增下列欄位:
資源 欄位 廣告客戶 AssignedTargetingOption 已新增以下列舉值:
列舉 值 LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
下列清單方法的網頁大小上限已提高:
v1
下列清單方法的網頁大小上限已提高:
已知問題
本次更新修正了第 2 版的下列已知問題:
- 針對在 v2 中使用列舉值指派的指定類型,無法透過
assignedTargetingOptionId
移除或擷取,而是預期使用者會使用列舉值。透過本次更新,您可以使用assignedTargetingOptionId
或列舉值 (由AssignedTargetingOption
資源中的新assignedTargetingOptionIdAlias
欄位識別),移除或擷取這些指派的指定目標選項。 - 委刊項
bulkUpdate
要求未正確使用advertisersId
要求參數,因此傳回錯誤。本次更新後,這個方法已修正,並將要求參數從advertisersId
重新命名為advertiserId
。
2022 年 10 月 27 日
新增在父項 InsertionOrder
中複製現有委刊項的功能。
為 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
服務新增 create
和 delete
方法,我們已針對部分指定類型推出部分廣告訂單指定目標寫入支援。
新功能
v2
已新增下列方法:
服務 方法 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
第 1 版並未新增任何功能。
2022 年 9 月 20 日
推出公開測試版的第 2 版,其中包含下列變更:
- 能夠使用
advertisers.lineItems
和advertisers.lineItems.targetingTypes.assignedTargetingOptions
服務中的get
和list
方法,擷取 YouTube 與合作夥伴委刊項及其指定目標設定。 advertisers.lineItems
服務包含兩種新的大量指定方式,可透過單一要求來編輯及擷取 指派給多個委刊項的指定目標。- 新的
bulkUpdate
方法,可讓使用者在單一要求中更新多個委刊項的entityStatus
。 - 新的指定目標邏輯需要使用列舉值指派及擷取指定類型子集的
AssignedTargetingOption
資源,而不是使用targetingTypes.targetingOptions
服務擷取的指定目標選項 ID。
請按照遷移指南中的步驟,從 v1 遷移至 v2。
v1 中新增對三個新廣告交易平台的支援。
新功能
v2
以下是 v1 和 v2 之間的變更清單:
第 2 版新增了下列方法:
服務 方法 advertisers.lineItems bulkEditAssignedTargetingOptions
以下是第 2 版已移除的方法:
服務 方法 advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
下列方法已在 v2 中重新命名:
服務 舊方法名稱 新方法名稱 廣告客戶 bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 下列指定類型的
AssignedTargetingOption
資源會使用列舉,在第 2 版中指定目標指派作業。這些指定類型的AssignedTargetingOption
資源的assignedTargetingOptionId
欄位也已在第 2 版中更新為使用字串版本的列舉值:指定類型 列舉類型 TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT 環境 TARGETING_TYPE_EXCHANGE 廣告交易平台 TARGETING_TYPE_GENDER 性別 TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY 可視度 第 2 版新增了下列欄位:
已在第 2 版中移除下列欄位:
第 2 版提供了下列欄位:
v2 中新增了下列列舉值:
列舉 值 AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
廣告交易平台 EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
v2 已移除下列列舉值:
列舉 值 LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
v1 新增了下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
2022 年 5 月 26 日
新增透過新的 inventorySources
服務寫入方法和新的 guaranteedOrders
服務,建立 InventorySource
資源及管理 GuaranteedOrder
資源。
在 CustomBiddingAlgorithm
資源中引入 modelReadiness
欄位。這個欄位會列出每個可存取演算法的
廣告主,是否已經準備好使用演算法。
為 advertisers.creatives.list
方法啟用新的 filter
查詢參數功能,讓使用者只能擷取指定時間戳記前後 updateTime
的廣告素材。
新增對最新的 SDF 版本 v5.5 版的支援功能,新增 SdfVersion
列舉值。
新功能
已新增下列方法:
服務 方法 guaranteedOrders inventorySources 已新增下列欄位:
資源 欄位 CustomBiddingAlgorithm InventorySource 已新增以下列舉值:
列舉 值 SdfVersion 下列清單方法現在可依下列屬性篩選:
方法 欄位 advertisers.creatives.list
2022 年 3 月 31 日
新增擷取及設定內容時間長度、串流類型和類型指定目標的支援功能。
已將 billableOutcome
欄位新增至 InsertionOrder
物件。
已在 MaximizeSpendBidStrategy
物件中加入 raiseBidForDeals
欄位,讓使用者設定出價策略是否對指定交易套用廣告主底價。
新功能
已新增下列欄位:
資源 欄位 AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption 已新增以下列舉值:
列舉 值 TargetingType
2022 年 2 月 2 日
開始支援建立、更新及編輯特定目標客戶比對 FirstAndThirdPartyAudience
資源的成員。新版「使用目標對象」指南中的「上傳目標客戶比對目標對象」頁面,將會詳細說明這些新功能的使用方式。
在 InsertionOrder
和 LineItem
資源中加入新的 reservationType
欄位,可識別資源是屬於代碼保證、程式輔助保證,還是無保證。
新增擷取及設定委刊項是否透過新的 excludeNewExchanges
欄位自動指定新的廣告交易平台的功能。
除了新功能以外,預設配額限制也已增加一倍。
新功能
已新增下列方法:
服務 方法 firstAndThirdPartyAudiences 已新增下列欄位:
資源 欄位 FirstAndThirdPartyAudience InsertionOrder LineItem
2021 年 12 月 8 日
新增對指定類型 TARGETING_TYPE_AUDIO_CONTENT_TYPE
下的音訊內容類型指定支援。
新功能
已新增下列欄位:
資源 欄位 AssignedTargetingOption TargetingOption 已新增以下列舉值:
列舉 值 TargetingType
2021 年 11 月 8 日
新增自訂出價演算法及其指令碼的完整支援。包括:
- 用於「建立」全新及更新現有
customBiddingAlgorithms
的函式。 - 透過擷取可用資源位置,然後將檔案上傳到該位置的程序上傳指令碼。
- 全新的
customBiddingAlgorithms.scripts
服務,用於擷取及建立customBiddingScripts
。
「管理委刊項」指南中新增了「導入自訂出價」頁面,當中說明如何建立自訂出價演算法、上傳指令碼,以及指派自訂出價演算法做為委刊項的出價策略。
新增對最新的 SDF 版本 v5.4 版的支援功能,新增 SdfVersion
列舉值。
新功能
已新增下列方法:
服務 方法 customBiddingAlgorithms customBiddingAlgorithms.scripts media 已新增以下列舉值:
列舉 值 SdfVersion
2021 年 9 月 14 日
新增對指定類型 (TARGETING_TYPE_BUSINESS_CHAIN
和 TARGETING_TYPE_POI
) 下鄰近目標的支援。
新增使用 targetingTypes.targetingOptions.search
搜尋可用的 TARGETING_TYPE_BUSINESS_CHAIN
和 TARGETING_TYPE_POI
指定目標選項,因為無法透過 targetingTypes.targetingOptions.get
或 targetingTypes.targetingOptions.list
方法擷取。
自訂出價演算法資源推出新的 sharedAdvertiserIds
和 customBiddingAlgorithmState
欄位,並新增對 GOAL_BUILDER_BASED
自訂出價演算法類型的支援。
已將兩個新值新增至 Exchange
列舉。
新功能
已新增下列欄位:
資源 欄位 AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetOptions.search 請求主體 已新增以下列舉值:
列舉 值 CustomBiddingAlgorithmType 廣告交易平台 TargetingType 下列清單方法現在可依下列屬性篩選:
方法 欄位 customBiddingAlgorithms.list
2021 年 8 月 4 日
在指定類型 TARGETING_TYPE_OMID
下方,新增對已啟用 Open Measurement 的廣告空間指定功能的支援。
針對使用 pageSize
方法參數,在各種廣告主、廣告活動、廣告訂單和委刊項指派的指定目標選項清單方法中,單一頁面傳回的指派指定目標選項數量上限提高。
新功能
已新增下列欄位:
資源 欄位 AssignedTargetingOption TargetingOption 已新增以下列舉值:
列舉 值 TargetingType 下列清單方法的網頁大小上限已提高:
2021 年 5 月 26 日
推出 advertisers.invoices
服務,讓使用者可以:
- 擷取每月核發給廣告客戶的月結單。
- 查詢廣告客戶在指定月份使用的貨幣代碼。
在廣告活動資源中加入 campaignBudgets
欄位。廣告訂單預算區隔可與廣告活動預算連結,將相關區隔的預算總和設為廣告活動預算總金額。
在新的指定類型 TARGETING_TYPE_NATIVE_CONTENT_POSITION
中新增原生內容位置指定功能。
在廣告客戶資源中加入新的 prismaEnabled
欄位,讓使用者能與 Mediaocean 的 Prisma 工具整合。
開始支援對廣告主 entityStatus
欄位的 ENTITY_STATUS_PAUSED
列舉值支援。
新功能
已新增下列方法:
服務 方法 advertisers.invoices 已新增下列欄位:
資源 欄位 廣告客戶 AssignedTargetingOption TargetingOption 已新增以下列舉值:
列舉 值 AssignedTargetingOption.Recency Exchange TargetingType 以下列舉值現在已適用於下列欄位:
資源 欄位 值 廣告客戶 entityStatus ENTITY_STATUS_PAUSED
2021 年 4 月 29 日
在頻道和排除關鍵字清單資源中新增欄位,用於傳回使用資源做為指定目標的項目數量。為委刊項清單方法啟用新的 filter
屬性,讓使用者只能擷取指定目標中使用特定管道或排除關鍵字清單的委刊項。
新功能
已新增下列欄位:
資源 欄位 水道 下列清單方法現在可依下列屬性篩選:
方法 欄位 advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
2021 年 3 月 30 日
為委刊項服務新增方法,使用預設設定產生委刊項。這些預設值取決於指定的委刊項類型,以及上層廣告訂單的設定和指定指定目標。
透過新的廣告活動指定目標服務和其他大量名單方法,擷取廣告活動指定目標。
對 advertisers.channels.sites
、partners.channels.sites
和 advertisers.negativeKeywordLists.negativeKeywords
服務進行多項變更,可簡化頻道管理和排除關鍵字清單內容。這類異動包括:
- 新增
replace
方法,可讓使用者完全覆寫頻道或排除關鍵字清單的現有內容。 - 從大量編輯要求的
createdSites
或createdNegativeKeywords
欄位中,移除沒有任何現有項目的規定。 - 在清單網站或列出排除關鍵字回應中,單一頁面可傳回的項目數量上限。
新功能
已新增下列方法:
已新增下列欄位:
資源 欄位 AssignedTargetingOption.AppAssignedTargetingOptionDetails 下列清單方法的網頁大小上限已提高:
方法 舊頁面大小上限 新的最大頁面大小 advertisers.channels.sites.list 多達 100 個 10000 advertisers.negativeKeywordLists.negativeKeywords.list 多達 100 個 1000 partners.channels.sites.list 多達 100 個 10000
淘汰項目
無法再將下列列舉值指派給新資源或現有資源:
列舉 值 PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
2021 年 2 月 24 日
推出新的廣告訂單指定目標服務和其他大量清單方法,以便擷取指派給廣告訂單的指定目標。擴充廣告素材資源,新增僅限輸出的廣告素材欄位,以供第三方音訊廣告素材使用。新增新的成效目標類型,供廣告訂單和廣告活動資源使用。
新功能
已新增下列方法:
服務 方法 advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 已新增下列欄位:
資源 欄位 廣告素材 已新增以下列舉值:
列舉 值 ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
2021 年 1 月 27 日
導入新的插入訂單類型欄位和新的 LineItemType 列舉值,可擷取及管理電視廣告訂單和 over-the-top 委刊項。透過 mobileApp
委刊項欄位新增對行動應用程式委刊項的支援。透過其他列舉值,擴大 Exchange、Google 目標對象和 SDF 的支援。推出可依上次更新時間篩選及排序 advertisers.list
值的功能。
新功能
已新增下列欄位:
資源 欄位 InsertionOrder LineItem 已新增以下列舉值:
列舉 值 Exchange GoogleAudienceType LineItemType SdfVersion 下列清單方法現在可以按照下列欄位排序和篩選:
方法 欄位 廣告客戶
2020 年 12 月 4 日
新增地理區域指定目標選項的搜尋功能,並依據上次更新時間篩選多個資源清單方法結果。推出全新 LineItemWarningMessage,說明委刊項何時使用已淘汰的指定地理區域。
新功能
已新增下列方法:
服務 方法 targetingTypes.targetingOptions 已新增以下列舉值:
列舉 值 Exchange LineItemWarningMessage 下列清單方法現在可以按照下列欄位排序和篩選:
方法 欄位 advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
2020 年 11 月 5 日
新增建立、指派及啟用手動觸發條件的功能,可啟動相關委刊項的預算。推出擴展指定目標選項,設定完成後,即可擴大委刊項的指定目標,納入與指定目標對象相似的使用者。將自訂區隔 ID 欄位附加到第三方驗證指定功能中使用的 DoubleVerify 和 Integral Ad Science 物件。
新功能
已新增下列服務:
服務 方法 advertisers.manualTriggers 已新增下列欄位:
資源 欄位 AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight 已新增以下列舉值:
列舉 值 LineItemFlightDateType 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.lineItems.list
2020 年 10 月 12 日
向委刊項資源和點閱率 (CTR) 成效目標類型推出可擷取的警告訊息。新增 warningMessages
做為列出委刊項時可篩選的欄位。
除了新功能以外,新配額限制現已生效,我們也提供有關運用批次要求的新說明文件。
新功能
已新增下列欄位:
資源 欄位 LineItem 已新增以下列舉值:
列舉 值 PerformanceGoalType 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.lineItems.list
2020 年 8 月 28 日
為廣告客戶稽核方法的回應新增欄位,並在各種清單方法中新增可篩選欄位。
新功能
已新增下列欄位:
資源 欄位 Advertiser.稽核回應內文 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
2020 年 8 月 4 日
推出新的使用者管理、合作夥伴和合作夥伴指定服務。推出全新工具,協助使用者主動避免達到帳戶實體限制。新增對音訊委刊項的支援,以及在委刊項和廣告訂單出價策略中使用自訂出價演算法。
新功能
已新增下列服務:
服務 方法 customBiddingAlgorithms 合作夥伴 partners.targetingTypes.assignedTargetingOptions 使用者 已新增下列方法:
服務 方法 廣告客戶 已新增下列欄位:
資源 欄位 MaximizeSpendBidStrategy PerformanceGoalBidStrategy 已新增以下列舉值:
列舉 值 BiddingStrategyPerformanceGoalType LineItemType 下列清單方法現在可以按照下列欄位排序和篩選:
方法 欄位 advertisers.lineItems.list 已新增下列服務適用的範圍:
內容範圍 服務 https://www.googleapis.com/auth/display-video-user-management
2020 年 6 月 24 日
推出小幅更新,新增合作夥伴和廣告客戶管道的建立方法、新增 FirstAndThirdPartyAudience 欄位,以及其他廣告交易平台列舉值。
新功能
已新增下列服務:
服務 方法 advertisers.channels partners.channels 已新增下列欄位:
資源 欄位 FirstAndThirdPartyAudience 已新增以下列舉值:
列舉 值 Exchange 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.creatives.list
2020 年 6 月 2 日
針對部分可指定的實體,新增建立、修補和填入資料的功能,並且針對三種指定類型新增修改廣告主層級指定目標的功能:管道、數位內容標籤排除和敏感類別排除。
新功能
已新增下列服務:
已新增下列方法:
服務 方法 廣告客戶 advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels 已新增下列欄位:
資源 欄位 廣告主 廣告素材 insertionOrder.insertionOrderBudgetSegment
2020 年 4 月 27 日
推出大型功能集,將 API 的範圍擴大到結構化資料檔案之外。新增核心資源管理功能,可讓您建立、擷取、更新及刪除實體 (例如廣告主、廣告活動、廣告訂單、委刊項和廣告素材)。新功能也可讓你在委刊項層級編輯指定目標。
新功能
已新增下列服務:
2020 年 3 月 9 日
推出 Display & Video 360 API 第 1 版。這是 API 的初始版本。
已知問題
無。