本頁面提供 Display & Video 360 API 的版本資訊記錄。
最新 API 版本：v3
2024 年 10 月 22 日
新功能
新增對單次收視出價成效目標的支援。
新增可設定及擷取已連結裝置指定目標的功能。
在「第三方驗證機構指定目標」下方新增 Adloox 品牌安全設定。
新增支援下載 v8 結構化資料檔案 (目前為封閉 Beta 版)。
v3
新增下列欄位：
物件 欄位 AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContent新增了下列列舉值：
列舉 值 DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
已淘汰的值
由於 SDF 已於 2024 年 10 月 3 日停用，因此已移除對 SDF 5.5 版的支援。
v3
下列列舉值已淘汰：
列舉 值 SdfVersionSDF_VERSION_5_5
2024 年 8 月 15 日
新功能
新增 Netflix Exchange 類型的支援。
v3
新增了下列列舉值：
列舉 值 廣告交易平台 EXCHANGE_NETFLIX
v2
新增了下列列舉值：
列舉 值 廣告交易平台 EXCHANGE_NETFLIX
2024 年 7 月 15 日
新功能
在第 3 版中新增支援以QA 格式下載委刊項和廣告群組結構化資料檔案。
v3
2024 年 6 月 17 日
新功能
新增支援廣告客戶層級指定關鍵字的管理功能。
在廣告訂單資源中新增 optimizationObjective 欄位。optimizationObjective 僅供許可清單中的客戶使用。
v3
新增下列欄位：
資源 欄位 InsertionOrder 下列方法現在支援下列指定目標類型：
v2
下列方法現在支援下列指定目標類型：
2024 年 5 月 30 日
新功能
新增結構化資料檔案 (SDF) 7.1 版支援。
v3
新增了下列列舉值：
列舉 值 SdfVersion SDF_VERSION_7_1
v2
新增了下列列舉值：
列舉 值 SdfVersion SDF_VERSION_7_1
2024 年 4 月 23 日
新功能
新增支援新的 KPI 類型、廣告交易平台和應用程式平台。
v3
新增下列欄位：
資源 欄位 關鍵績效指標 新增了下列列舉值：
列舉 值 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 新增下列欄位：
資源 欄位 使用者 YoutubeAndPartnersInventorySourceConfig
v2
新增了下列方法：
服務 方法 floodlightGroups.floodlightActivities 新增下列欄位：
資源 欄位 使用者 YoutubeAndPartnersInventorySourceConfig
2023 年 11 月 14 日
新功能
在所有實際版本中上傳客戶比對目標對象成員時，新增了支援傳遞使用者同意聲明的功能。
v3
新增下列欄位：
資源 欄位 ContactInfoList MobileDeviceIdList
v2
新增下列欄位：
資源 欄位 ContactInfoList MobileDeviceIdList
2023 年 10 月 31 日
新功能
將 v3 從公開測試版移至正式版。
在 v3 中重新命名 AdGroupFormat 列舉值，以更準確地反映相關格式。
新增支援結構化資料檔案 v7，並在 v2 和 v3 中新增 SDF_VERSION_7 列舉值。
v3
以下列舉值已遭移除：
列舉 值 AdGroupFormat AD_GROUP_FORMAT_ACTION
新增了下列列舉值：
列舉 值 AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
新增了下列列舉值：
列舉 值 SdfVersion SDF_VERSION_7
2023 年 10 月 2 日
新功能
在公開測試版中發布 v3，其中包含下列變更：
- 能夠完整管理鄰近位置清單，使用
advertisers.locationLists.assignedLocations服務建立及刪除指派給TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源的位置。 - 新的布林
enableOptimizedTargeting欄位，可取代TargetingExpansionConfig物件中的targetingExpansionLevel欄位。 Advertiser資源中billingConfig欄位的規定，必須在提出advertisers.create要求時納入，以及Partner資源中的新billingConfig欄位。- 新的
AdGroup和AdGroupAd資源，用於取代 v2 中的YoutubeAdGroup和YoutubeAdGroupAd資源。
請按照遷移指南中的步驟，從第 2 版遷移至第 3 版。
在 v2 和 v3 中新增支援 3 個 LineItemType 值、一個新的 YoutubeAndPartnersBiddingStrategyType 和一個新的 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_PROXIMITYLocationList資源。advertisers.locationLists.patch 現在支援更新 TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源。advertisers.locationLists.assignedLocations.bulkEdit 現在支援大量編輯 TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源中的AssignedLocation資源。advertisers.locationLists.assignedLocations.create 現在支援在 TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源中建立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 日
新功能
為 v1 和 v2 的結構化資料檔案 (SDF) v6 新增 SdfVersion 值。
v2
新增了下列列舉值：
列舉 值 SdfVersion SDF_VERSION_6
v1
新增了下列列舉值：
列舉 值 SdfVersion SDF_VERSION_6
2023 年 3 月 9 日
新功能
新增了 LineItemWarningMessage 值，如果委刊項的 warningMessages 欄位設為已淘汰的 excludeFirstPartyAudience 欄位，則會指派給該欄位。trueexcludeFirstPartyAudience 欄位將於 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 與合作夥伴資源。
在 v1 和 v2 中新增支援四個額外的交換機。
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 日
新功能
將 v2 從公開測試版移至正式版。
在 AssignedTargetingOption 資源中新增 assignedTargetingOptionIdAlias 欄位，可在擷取及刪除指定目標時取代 assignedTargetingOptionId。這個欄位只會設定指定類型指派的指定目標選項，這些選項是透過枚舉值指派。別名值是相關的列舉值，以字串形式表示。
在 Advertiser 資源中新增 billingConfig 欄位。
新增支援擷取 YouTube 與合作夥伴 OTT 委刊項，可透過三個新的 LineItemType 值識別。
針對第 1 版和第 2 版中的許多 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
下列清單方法的頁面大小上限已提高：
已知問題
這項更新修正了 v2 中的下列已知問題：
- 使用 v2 中的列舉值指派的指定目標類型指派指定目標選項無法使用其
assignedTargetingOptionId移除或擷取，而是預期使用者使用列舉值。在本次更新後，您可以使用assignedTargetingOptionId或assignedTargetingOptionIdAlias欄位 (由AssignedTargetingOption資源中的新欄位標示) 來移除或擷取這些指定的指定目標選項。 - 委刊項
bulkUpdate要求未正確使用advertisersId要求參數，因此傳回錯誤。透過這次更新，我們已修正該方法，並將要求參數從advertisersId重新命名為advertiserId。
2022 年 10 月 27 日
新增了在父項 InsertionOrder 中複製現有委刊項的功能。
針對部分指定類型推出部分廣告訂單指定寫入支援功能，方法是將 create 和 delete 方法新增至 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服務。
新功能
v2
新增了下列方法：
服務 方法 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
我們並未在 v1 中新增任何功能。
2022 年 9 月 20 日
在公開測試版中發布 v2，其中包含下列變更：
- 在
advertisers.lineItems和advertisers.lineItems.targetingTypes.assignedTargetingOptions服務中，使用get和list方法擷取 YouTube 與合作夥伴委刊項及其指定目標設定。 advertisers.lineItems服務中的兩種全新大量指定目標方法，可透過單一要求，在多個委刊項中編輯及擷取 已指派的指定目標。- 新的
bulkUpdate方法，可讓使用者在單一要求中更新多個委刊項的entityStatus。 - 新的指定目標邏輯，需要使用枚舉值指派及擷取
AssignedTargetingOption資源的指定目標類型子集，而非使用targetingTypes.targetingOptions服務擷取的指定目標選項 ID。
請按照遷移指南中的步驟，將遊戲從第 1 版遷移至第 2 版。
在 v1 中新增了三個交換機。
新功能
v2
以下是 v1 和 v2 之間的變更清單：
以下方法已在 v2 中新增：
服務 方法 advertisers.lineItems bulkEditAssignedTargetingOptions
下列方法已在 v2 中移除：
服務 方法 advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
下列方法已在 v2 中重新命名：
服務 舊版方法名稱 新方法名稱 廣告主 bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions 合作夥伴 bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 下列指定類型的
AssignedTargetingOption資源，會在 v2 中使用列舉來指定指定目標。這些指定目標類型的AssignedTargetingOption資源assignedTargetingOptionId欄位也已在 v2 中更新，以便使用列舉值的字串版本：指定類型 列舉類型 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 可視度 以下欄位已新增至 v2：
下列欄位已在 v2 中移除：
下列欄位已在 v2 中設為必填：
以下列舉值已在 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 日
新增建立 InventorySource 資源的功能，並透過新的 inventorySources 服務寫入方法和新的 guaranteedOrders 服務管理 GuaranteedOrder 資源。
在 CustomBiddingAlgorithm 資源中導入 modelReadiness 欄位。這個欄位會列出每位可存取演算法模型的廣告主，以及該模型的完備性。
為 advertisers.creatives.list 方法啟用新的 filter 查詢參數功能，讓使用者只擷取在指定時間戳記之前或之後含有 updateTime 的廣告素材。
新增 SdfVersion 列舉值，支援最新的 SDF 版本 v5.5。
新功能
新增了下列方法：
服務 方法 guaranteedOrders inventorySources 新增下列欄位：
資源 欄位 CustomBiddingAlgorithm InventorySource 新增了下列列舉值：
列舉 值 SdfVersion 下列清單方法現在可透過下列屬性篩選：
方法 欄位 advertisers.creatives.list
2022 年 3 月 31 日
新增支援功能，可針對內容時間長度、串流類型和類型擷取及設定指定目標。
將 billableOutcome 欄位新增至 InsertionOrder 物件。
將 raiseBidForDeals 欄位導入 MaximizeSpendBidStrategy 物件，讓使用者設定出價策略是否會針對指定交易套用廣告主底價。
新功能
新增下列欄位：
資源 欄位 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 日
新增完整的管理自訂出價演算法及其指令碼支援功能。包括：
- 用於create新
customBiddingAlgorithms和更新現有customBiddingAlgorithms的函式。 - 能夠透過擷取可用資源位置，然後將檔案上傳至該位置的過程，上傳指令碼。
- 新的
customBiddingAlgorithms.scripts服務，用於擷取和createcustomBiddingScripts。
我們已在管理委刊項指南中新增「導入自訂出價」頁面，說明建立自訂出價演算法、上傳指令碼，以及將自訂出價演算法指派為委刊項出價策略的程序。
新增 SdfVersion 列舉值，以支援最新的 v5.4 版 SDF。
新功能
新增了下列方法：
服務 方法 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 TargetingOptions.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 廣告交易平台 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 日
透過引入新的 InsertionOrderType 欄位和新的 LineItemType 列舉值，啟用電視廣告訂單和 over-the-top 委刊項的擷取和管理功能。透過 mobileApp 委刊項欄位，新增行動應用程式委刊項的支援功能。透過額外的列舉值，支援擴充的 exchange、google audience 和 SDF。推出可依上次更新時間篩選及排序 advertisers.list 值的功能。
新功能
新增下列欄位：
資源 欄位 InsertionOrder LineItem 新增了下列列舉值：
列舉 值 廣告交易平台 GoogleAudienceType LineItemType SdfVersion 下列清單方法現在可依據下列欄位排序及篩選：
方法 欄位 廣告主
2020 年 12 月 4 日
新增搜尋地理區域指定選項的功能，並依據上次更新時間篩選多個資源清單方法結果。推出新的 LineItemWarningMessage，可通知使用者委刊項使用已淘汰的指定地理區域功能。
新功能
新增了下列方法：
服務 方法 targetingTypes.targetingOptions 新增了下列列舉值：
列舉 值 廣告交易平台 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 日
在廣告主稽核方法的回應中新增欄位，並在各種列表方法中新增可篩選的欄位。
新功能
新增下列欄位：
資源 欄位 Advertisers.Audit Response Body 下列清單方法現在可依下列欄位篩選：
方法 欄位 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 欄位，以及其他exchange 列舉值。
新功能
新增了下列服務：
服務 方法 advertisers.channels partners.channels 新增了下列欄位：
資源 欄位 FirstAndThirdPartyAudience 新增了下列列舉值：
列舉 值 廣告交易平台 下列清單方法現在可依下列欄位篩選：
方法 欄位 advertisers.creatives.list
2020 年 6 月 2 日
推出建立、修補及填入可指定實體子集的功能，並新增修改廣告客戶層級指定目標的功能，適用於三種指定目標類型：管道、數位內容標籤排除條件和敏感類別排除條件。
新功能
新增了下列服務：
新增了下列方法：
服務 方法 廣告主 advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels 新增下列欄位：
資源 欄位 廣告主 廣告素材 insertionOrder.insertionOrderBudgetSegment
2020 年 4 月 27 日
推出大型功能集，將 API 的範圍擴大到 SDF 以外。新增核心資源管理功能，可讓您建立、擷取、更新及刪除實體，例如廣告主、廣告活動、廣告訂單、委刊項和廣告素材。新的功能還可讓您在委刊項層級編輯指定目標。
新功能
新增了下列服務：
2020 年 3 月 9 日
推出 Display & Video 360 API 1.0 版。這是 API 的初始版本。
已知問題
無。