本頁提供多媒體廣告聯播網和Video 360 API。
最新 API 版本：v3
2024 年 7 月 15 日
新功能
新增支援下載委刊項和廣告群組結構化資料檔案的 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
已新增下列欄位：
資源 欄位 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 服務。
加入用來說明 YouTube 和合作夥伴委刊項 將 Google TV 廣告空間納入指定目標
新增欄位，以轉發上次登入時間的 Display & Video 360 和影片 360 使用者。
v3
已新增下列方法：
服務 方法 floodlightGroups.floodlightActivities 已新增下列欄位：
資源 欄位 使用者 YoutubeAndPartnersInventorySourceConfig
v2
已新增下列方法：
服務 方法 floodlightGroups.floodlightActivities 已新增下列欄位：
資源 欄位 使用者 YoutubeAndPartnersInventorySourceConfig
2023 年 11 月 14 日
新功能
新增在上傳目標顧客比對時傳遞使用者同意聲明的支援功能 所有直播版本中的觀眾成員
v3
已新增下列欄位：
資源 欄位 ContactInfoList MobileDeviceIdList
v2
已新增下列欄位：
資源 欄位 ContactInfoList MobileDeviceIdList
2023 年 10 月 31 日
新功能
第 3 版脫離公開 Beta 版測試，並正式發布。
已重新命名 v3 中的 AdGroupFormat 列舉值，以提供更準確的資訊
反映相關格式
新增對結構化資料檔案 7.0 版的支援，新增
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_PROXIMITY的地區LocationList資源。 - 新的布林值
enableOptimizedTargeting欄位 取代targetingExpansionLevelTargetingExpansionConfig物件。 billingConfig欄位的Advertiser資源，製作時必須包括advertisers.create要求，以及Partner中的billingConfig欄位 資源。- 新的
AdGroup和AdGroupAd資源 取代 v2 中的YoutubeAdGroup和YoutubeAdGroupAd資源。
請按照遷移指南中的步驟，從第 2 版遷移至新版 第 3 版，
已新增 3 個新的 LineItemType 值支援，一個新的值
YoutubeAndPartnersBiddingStrategyType和 1 個新項目
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 以下為必填欄位：
資源 欄位 Advertiser [廣告客戶] 已新增下列欄位：
資源 欄位 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 日
新功能
為結構化資料檔案新增 SdfVersion 值
(SDF) 第 1 版和第 2 版中的第 6 版。
v2
以下列舉值已新增：
列舉 值 SdfVersion SDF_VERSION_6
v1
以下列舉值已新增：
列舉 值 SdfVersion SDF_VERSION_6
2023 年 3 月 9 日
新功能
新增了 LineItemWarningMessage 值，將會
並指派給委刊項的「warningMessages」欄位 (如果包含
已淘汰的 excludeFirstPartyAudience 欄位設為
true。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 版脫離公開 Beta 版測試，並正式發布。
已將新的 assignedTargetingOptionIdAlias 欄位新增至
AssignedTargetingOption 資源，可用來取代
assignedTargetingOptionId。
這個欄位僅適用於所指派的指定類型
是透過列舉指派的別名值是做為字串的相關列舉值。
已將新的 billingConfig 欄位新增至
Advertiser 資源。
新增擷取 YouTube 和合作夥伴 over-the-top 委刊項
由三個新的 LineItemType 值識別。
針對 v1 和 v2 中的多種 list 方法，將頁面大小上限提高為 200 個。
預設頁面大小維持不變
v2
已新增下列欄位：
資源 欄位 Advertiser [廣告客戶] 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 中的下列已知問題：
- 由透過列舉方式指派的指定類型所指派的指定目標選項
無法移除或擷取第 2 版的值
使用
assignedTargetingOptionId，而這是正常情形 使用列舉值。這次更新後，這些指派的指定目標 您可以從任何位置移除或擷取選項assignedTargetingOptionId或列舉值 (識別出 新的assignedTargetingOptionIdAlias欄位AssignedTargetingOption資源。 - 委刊項
bulkUpdate請求未正確使用advertisersId要求參數，傳回錯誤。本次更新後 方法已經修正，而且 request 參數已從advertisersId到advertiserId。
2022 年 10 月 27 日
新增在上層發布商中複製現有委刊項的功能
InsertionOrder.
推出部分廣告訂單指定目標的寫入支援功能
指定類型，除了加入 create 和
將 delete 方法指派給
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
課程中也會快速介紹 Memorystore
這是 Google Cloud 的全代管 Redis 服務
新功能
v2
已新增下列方法：
服務 方法 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
第 1 版沒有任何新功能。
2022 年 9 月 20 日
推出第 2 版公開測試版，包含下列變更：
- 您可以擷取 YouTube 和合作夥伴委刊項及其指定目標
設定 (使用
advertisers.lineItems中的get和list方法) 和advertisers.lineItems.targetingTypes.assignedTargetingOptions服務。 advertisers.lineItems服務中全新的大量指定方式 可讓您執行編輯及擷取 對多個委刊項指派的指定目標， 單一請求。- 新的
bulkUpdate方法，可讓使用者更新 單一請求中包含多個委刊項的entityStatus。 - 需要
AssignedTargetingOption的新指定邏輯 指定類型子集的資源 使用列舉值 (而非指定目標選項 ID) 進行指派及擷取 透過targetingTypes.targetingOptions服務擷取。
請按照遷移指南中的步驟從 v1 遷移至 第 2 版。
新增對 v1 中三個新廣告交易平台的支援。
新功能
v2
以下是 v1 和 v2 的異動清單：
第 2 版新增了下列方法：
服務 方法 advertisers.lineItems bulkEditAssignedTargetingOptions
下列方法已在第 2 版中移除：
服務 方法 advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
下列方法在 v2 中已重新命名：
服務 舊方法名稱 新方法名稱 廣告客戶 bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions 合作夥伴 bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 下列指定類型的
AssignedTargetingOption資源使用列舉在 v2 中指派指定目標。這些指定類型的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 版中的必填欄位：
以下是第 2 版新增的列舉值：
列舉 值 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
下列列舉值已從第 2 版中移除：
列舉 值 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 資源的權限。
可透過新的 Google Cloud 控制台GuaranteedOrder
inventorySources 服務寫入方法和全新
guaranteedOrders服務。
引入modelReadiness
CustomBiddingAlgorithm 資源。這個欄位會列出
會為每個廣告客戶提供專屬的演算法模型
已為以下項目啟用新的 filter 查詢參數功能：
可讓使用者設定的 advertisers.creatives.list 方法
只擷取含有 updateTime 的廣告素材
顯示在指定時間戳記之前或之後
新增對最新 SDF 版本 v5.5 版的支援。透過
新增 SdfVersion 列舉值。
新功能
已新增下列方法：
服務 方法 guaranteedOrders inventorySources 已新增下列欄位：
資源 欄位 CustomBiddingAlgorithm InventorySource 以下列舉值已新增：
列舉 值 SdfVersion 下列清單方法現可透過下列屬性篩選：
方法 欄位 advertisers.creatives.list
2022 年 3 月 31 日
新增對以下項目的擷取和設定指定目標的支援功能 內容時間長度、串流類型、 和類型。
已將 billableOutcome 欄位新增至 InsertionOrder
物件。
將 raiseBidForDeals 欄位加入
MaximizeSpendBidStrategy 物件，可讓使用者設定是否要出價
策略會針對指定交易套用廣告主底價。
新功能
已新增下列欄位：
資源 欄位 AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption 以下列舉值已新增：
列舉 值 TargetingType
2022 年 2 月 2 日
開始支援建立、更新和
編輯特定「目標客戶比對」的成員
FirstAndThirdPartyAudience 資源。
上傳目標客戶比對目標對象頁面：
「使用目標對象」指南詳細說明這些新功能的使用方式。
在以下位置加入新的 reservationType 欄位：
InsertionOrder和LineItem
指出資源是代碼保證交易、程式輔助
保證或不保證。
新增擷取及設定委刊項是否自動指定的功能
透過新的 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.
新增了搜尋可用項目的功能
TARGETING_TYPE_BUSINESS_CHAIN 和
TARGETING_TYPE_POI 的指定目標選項
targetingTypes.targetingOptions.search，因為不可以
透過 targetingTypes.targetingOptions.get 或
targetingTypes.targetingOptions.list 方法。
推出新的 sharedAdvertiserIds 和
套用至自訂出價的 customBiddingAlgorithmState 欄位
演算法資源並新增支援
GOAL_BUILDER_BASED 自訂出價演算法類型。
將兩個新值新增至 Exchange 列舉。
新功能
已新增下列欄位：
資源 欄位 AssignedTargetingOption CustomBiddingAlgorithm TargetingOption 指定選項.search 要求主體 以下列舉值已新增：
列舉 值 CustomBiddingAlgorithmType 廣告交易平台 TargetingType 下列清單方法現可透過下列屬性篩選：
方法 欄位 customBiddingAlgorithms.list
2021 年 8 月 4 日
新增對已啟用 Open Measurement 的支援
指定類型底下的「廣告空間指定目標」
TARGETING_TYPE_OMID。
提高可傳回的指派指定目標選項數量上限
且在單一頁面中，廣告客戶、廣告活動、
廣告訂單和委刊項指派的指定目標
使用 pageSize 方法參數的清單列表方法。
新功能
已新增下列欄位：
資源 欄位 AssignedTargetingOption TargetingOption 以下列舉值已新增：
列舉 值 TargetingType 下列清單方法的網頁大小上限已提高：
2021 年 5 月 26 日
啟動 advertisers.invoices 服務
使用者：
- 擷取廣告客戶在指定月份核發的月結單。
- 查詢廣告客戶在指定月份使用的貨幣代碼。
在廣告活動中加入「campaignBudgets」欄位
資源。廣告訂單預算區隔可連結至
指定廣告活動預算，限制
並將區隔與廣告活動總預算金額建立關聯
新增對以下項目的支援：
指定原生內容位置
指定類型：TARGETING_TYPE_NATIVE_CONTENT_POSITION。
為廣告客戶推出新的 prismaEnabled 欄位
資源，讓使用者能與 Mediaocean 的 Prisma 工具整合。
開始支援將 ENTITY_STATUS_PAUSED 列舉值
廣告客戶的「entityStatus」欄位。
新功能
已新增下列方法：
服務 方法 advertisers.invoices 已新增下列欄位：
資源 欄位 Advertiser [廣告客戶] AssignedTargetingOption TargetingOption 以下列舉值已新增：
列舉 值 AssignedTargetingOption.Recency 廣告交易平台 TargetingType 下列列舉值現已適用於下列欄位：
資源 欄位 值 Advertiser [廣告客戶] 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 日
推出新的廣告訂單指定目標服務和 其他大量列出方法，以便擷取 將指定目標指派給廣告訂單展開廣告素材資源，在 僅限輸出的廣告素材欄位， 以及第三方音訊廣告素材新增新的成效目標類型 供廣告訂單和廣告活動使用 再複習一下，機構節點 是所有 Google Cloud Platform 資源的根節點
新功能
已新增下列方法：
服務 方法 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 日
支援擷取及管理電視廣告訂單和 over-the-top 線
向觀眾介紹
新的 [InsertOrderType] 欄位和
new LineItemType 列舉值。新增行動應用程式支援
委刊項透過 [mobileApp] 委刊項欄位投放委刊項
擴展式廣告交易平台、Google 目標對象和
SDF 可透過其他列舉值支援。導入
篩選及排序 advertisers.list 的功能
依據上次更新時間排序。
新功能
已新增下列欄位：
資源 欄位 InsertionOrder LineItem 以下列舉值已新增：
列舉 值 廣告交易平台 GoogleAudienceType LineItemType SdfVersion 下列清單方法現在可根據下列欄位排序和篩選：
方法 欄位 廣告客戶
2020 年 12 月 4 日
新增搜尋功能， 地理區域指定目標選項及篩選多項資源 依更新時間排序列出方法結果。推出 new LineItemWarningMessage，通知使用者 委刊項使用已淘汰的指定地理區域功能。
新功能
已新增下列方法：
服務 方法 targetingTypes.targetingOptions 以下列舉值已新增：
列舉 值 廣告交易平台 LineItemWarningMessage 下列清單方法現在可根據下列欄位排序和篩選：
方法 欄位 advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
2020 年 11 月 5 日
新增了建立、指派及啟用的功能 手動觸發條件：用於啟動相關委刊項的 支出。推出擴展指定目標選項， 設定時，可以擴大委刊項的指定目標，納入類似以下使用者的使用者： 鎖定目標對象的使用者已將自訂區隔 ID 欄位附加至 DoubleVerify 和 Integral Ad Science Kubernetes 物件 指定第三方驗證。
新功能
已新增下列服務：
服務 方法 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 回應內文 下列清單方法現可依下列欄位篩選：
方法 欄位 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 以下列舉值已新增：
列舉 值 廣告交易平台 下列清單方法現可依下列欄位篩選：
方法 欄位 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 日
已推出螢幕和Video 360 API 第 1 版。這是 API 的初始版本。
已知問題
無。