版本資訊

本頁提供多媒體廣告聯播網和Video 360 API。

最新 API 版本:v3

2024 年 8 月 15 日

新功能

新增對 Netflix Exchange 類型的支援。

v3

v2

2024 年 7 月 15 日

新功能

新增支援下載委刊項和廣告群組結構化資料檔案的 QA 格式

v3

2024 年 6 月 17 日

新功能

新增在廣告客戶層級指定指定關鍵字的功能。

在廣告訂單中新增「optimizationObjective」欄位 資源。「optimizationObjective」僅適用於許可清單中的客戶。

v3

v2

2024 年 5 月 30 日

新功能

新增結構化資料檔案 (SDF) 7.1 版支援。

v3

  • 以下列舉值已新增:

    列舉
    SdfVersion

    SDF_VERSION_7_1

v2

  • 以下列舉值已新增:

    列舉
    SdfVersion

    SDF_VERSION_7_1

2024 年 4 月 23 日

新功能

新增對新的 KPI 類型、廣告交易平台和應用程式平台的支援。

v3

v2

2024 年 2 月 28 日

新功能

新增從目標客戶比對目標對像中明確移除成員的功能。

新增指定新廣告交易平台的功能。

v3

v2

2024 年 1 月 29 日

新功能

新增透過新的 floodlightGroups.floodlightActivities 服務。

加入用來說明 YouTube 和合作夥伴委刊項 將 Google TV 廣告空間納入指定目標

新增欄位,以轉發上次登入時間的 Display &Video 360 和影片 360 使用者

v3

v2

2023 年 11 月 14 日

新功能

新增在上傳目標顧客比對時傳遞使用者同意聲明的支援功能 所有直播版本中的觀眾成員

v3

v2

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 公開測試版,包含下列異動:

請按照遷移指南中的步驟,從第 2 版遷移至新版 第 3 版,

已新增 3 個新的 LineItemType 值支援,一個新的值 YoutubeAndPartnersBiddingStrategyType和 1 個新項目 PartnerCostType

v3

v2

2023 年 8 月 25 日

新功能

新增對兩個廣告交易平台及兩個新 YouTube 和夥伴合作 出價策略類型

已在 YouTube 中新增effectiveContentCategory欄位 & 合作夥伴委刊項 委刊項使用 YoutubeAndPartnersContentCategory 同時考量廣告客戶和委刊項層級指派的值

v2

2023 年 6 月 5 日

新功能

結構化資料檔案SdfVersion新增值 (SDF) 第 1 版和第 2 版中的第 6 版。

v2

  • 以下列舉值已新增:

    列舉
    SdfVersion

    SDF_VERSION_6

v1

  • 以下列舉值已新增:

    列舉
    SdfVersion

    SDF_VERSION_6

2023 年 3 月 9 日

新功能

新增了 LineItemWarningMessage 值,將會 並指派給委刊項的「warningMessages」欄位 (如果包含 已淘汰的 excludeFirstPartyAudience 欄位設為 trueexcludeFirstPartyAudience 欄位即將停用 並在 2023 年 3 月 25 日後設為 false

v2

v1

2023 年 2 月 8 日

新功能

新增擷取 YouTubeAdGroupYouTubeAdGroupAd資源與 YouTube 廣告群組 指定資源另外,我們也加入了 YouTube 廣告群組使用的可擷取指定類型 第二,自訂角色只能 套用至專案或機構參閱新版指南頁面,瞭解如何擷取 YouTube 與夥伴合作 資源

第 1 版和第 2 版新增了四種廣告交易平台的支援。

v2

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

v1

已知問題

這項更新修正了 v2 中的下列已知問題:

2022 年 10 月 27 日

新增在上層發布商中複製現有委刊項的功能 InsertionOrder

推出部分廣告訂單指定目標的寫入支援功能 指定類型,除了加入 create 和 將 delete 方法指派給 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務

新功能

v2

v1

第 1 版沒有任何新功能。

2022 年 9 月 20 日

推出第 2 版公開測試版,包含下列變更:

請按照遷移指南中的步驟從 v1 遷移至 第 2 版。

新增對 v1 中三個新廣告交易平台的支援。

新功能

v2

以下是 v1 和 v2 的異動清單:

v1

  • 以下是 v1 新增的列舉值:

    列舉
    廣告交易平台

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

2022 年 5 月 26 日

新增了建立 InventorySource 資源的權限。 透過新的工具管理GuaranteedOrder資源 inventorySources 服務寫入方法和全新 guaranteedOrders服務。

引入modelReadiness CustomBiddingAlgorithm 資源。這個欄位會列出 會為每個廣告客戶提供專屬的演算法模型

已為以下項目啟用新的 filter 查詢參數功能: 可讓使用者設定的 advertisers.creatives.list 方法 只擷取含有 updateTime 的廣告素材 顯示在指定時間戳記之前或之後

新增對最新 SDF 版本 v5.5 版的支援。透過 新增 SdfVersion 列舉值。

新功能

2022 年 3 月 31 日

新增對以下項目的擷取和設定指定目標的支援功能 內容時間長度串流類型、 和類型

已將 billableOutcome 欄位新增至 InsertionOrder 物件。

raiseBidForDeals 欄位加入 MaximizeSpendBidStrategy 物件,可讓使用者設定是否要出價 策略會針對指定交易套用廣告主底價。

新功能

2022 年 2 月 2 日

開始支援建立更新編輯特定「目標客戶比對」的成員 FirstAndThirdPartyAudience 資源。 上傳目標客戶比對目標對象頁面: 「使用目標對象」指南詳細說明這些新功能的使用方式。

在以下位置加入新的 reservationType 欄位: InsertionOrderLineItem 指出資源是代碼保證交易、程式輔助 保證或不保證。

新增擷取及設定委刊項是否自動指定的功能 透過新的 excludeNewExchanges ] 欄位。

除了新功能外,預設配額限制也已加倍。

新功能

2021 年 12 月 8 日

新增在指定類型下指定音訊內容類型的支援功能 TARGETING_TYPE_AUDIO_CONTENT_TYPE

新功能

2021 年 11 月 8 日

新增自訂出價演算法及其指令碼的完整支援功能。 包括:

導入自訂出價」頁面已新增至 管理委刊項指南中說明瞭 建立自訂出價演算法、上傳指令碼 指派自訂出價演算法做為委刊項的出價策略。

新增對最新 SDF 版本 v5.4 版的支援,透過 新增 SdfVersion 列舉值。

新功能

2021 年 9 月 14 日

新增指定類型下的鄰近目標支援功能 TARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_POI

新增了搜尋可用項目的功能 TARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_POI 的指定目標選項 targetingTypes.targetingOptions.search,因為不可以 透過 targetingTypes.targetingOptions.gettargetingTypes.targetingOptions.list 方法。

推出新的 sharedAdvertiserIds 和 套用至自訂出價的 customBiddingAlgorithmState 欄位 演算法資源並新增支援 GOAL_BUILDER_BASED 自訂出價演算法類型。

將兩個新值新增至 Exchange 列舉。

新功能

2021 年 8 月 4 日

新增對已啟用 Open Measurement 的支援 指定類型底下的「廣告空間指定目標」 TARGETING_TYPE_OMID

提高可傳回的指派指定目標選項數量上限 且在單一頁面中,廣告客戶廣告活動廣告訂單委刊項指派的指定目標 使用 pageSize 方法參數的清單列表方法。

新功能

2021 年 5 月 26 日

啟動 advertisers.invoices 服務 使用者:

  • 擷取廣告客戶在指定月份核發的月結單。
  • 查詢廣告客戶在指定月份使用的貨幣代碼。

在廣告活動中加入「campaignBudgets」欄位 資源。廣告訂單預算區隔可連結至 指定廣告活動預算,限制 並將區隔與廣告活動總預算金額建立關聯

新增對以下項目的支援: 指定原生內容位置 指定類型:TARGETING_TYPE_NATIVE_CONTENT_POSITION

為廣告客戶推出新的 prismaEnabled 欄位 資源,讓使用者能與 Mediaocean 的 Prisma 工具整合。

開始支援將 ENTITY_STATUS_PAUSED 列舉值 廣告客戶的「entityStatus」欄位。

新功能

2021 年 4 月 29 日

在「管道」和 傳回行數的排除關鍵字清單資源 來指定目標的項目已啟用新的filter 委刊項清單方法的屬性,可讓使用者 只擷取使用特定管道或排除關鍵字的委刊項 指定名單

新功能

2021 年 3 月 30 日

新增新方法至委刊項服務,以便用來產生 委刊項採用預設設定這些預設值採用的是 指定的委刊項類型等設定 上層廣告訂單的指定目標

可讓您透過 全新的廣告活動指定目標服務 其他大量列出方法

擴大應用程式指定功能,以便指定應用程式 在更多平台上曝光

advertisers.channels.sites 進行多項變更, partners.channels.sitesadvertisers.negativeKeywordLists.negativeKeywords 項服務可執行以下動作: 可更輕鬆地管理頻道和排除關鍵字清單內容這些 變更包括:

新功能

淘汰項目

2021 年 2 月 24 日

推出新的廣告訂單指定目標服務其他大量列出方法,以便擷取 將指定目標指派給廣告訂單展開廣告素材資源,在 僅限輸出的廣告素材欄位, 以及第三方音訊廣告素材新增新的成效目標類型廣告訂單廣告活動使用 再複習一下,機構節點 是所有 Google Cloud Platform 資源的根節點

新功能

2021 年 1 月 27 日

支援擷取及管理電視廣告訂單和 over-the-top 線 向觀眾介紹 新的 [InsertOrderType] 欄位new LineItemType 列舉值。新增行動應用程式支援 委刊項透過 [mobileApp] 委刊項欄位投放委刊項 擴展式廣告交易平台Google 目標對象SDF 可透過其他列舉值支援。導入 篩選及排序 advertisers.list 的功能 依據上次更新時間排序。

新功能

2020 年 12 月 4 日

新增搜尋功能, 地理區域指定目標選項及篩選多項資源 依更新時間排序列出方法結果。推出 new LineItemWarningMessage,通知使用者 委刊項使用已淘汰的指定地理區域功能。

新功能

2020 年 11 月 5 日

新增了建立、指派及啟用的功能 手動觸發條件:用於啟動相關委刊項的 支出。推出擴展指定目標選項, 設定時,可以擴大委刊項的指定目標,納入類似以下使用者的使用者: 鎖定目標對象的使用者已將自訂區隔 ID 欄位附加至 DoubleVerifyIntegral Ad Science Kubernetes 物件 指定第三方驗證

新功能

2020 年 10 月 12 日

已在委刊項中加入可擷取的警告訊息 資源和點閱率 (CTR) 成效目標類型已新增 warningMessages:做為篩選委刊項時的可篩選欄位。

除了新功能外,新的配額限制目前已生效。 我們推出了新的使用批次要求說明文件。

新功能

2020 年 8 月 28 日

廣告客戶稽核方法的回應中加入新欄位,以及 針對各種清單方法新增可篩選欄位。

新功能

2020 年 8 月 4 日

推出新的使用者管理夥伴夥伴指定服務。推出相關工具,協助使用者主動避免達到帳戶實體上限。新增支援音訊委刊項的功能,以及在委刊項廣告訂單出價策略中使用自訂出價演算法的功能。

新功能

2020 年 6 月 24 日

推出小幅更新,為夥伴廣告客戶管道、新的 FirstAndThirdPartyAudience 欄位以及其他 廣告交易平台列舉值新增建立方法。

新功能

2020 年 6 月 2 日

導入建立、修補及填入部分可指定實體的功能,並新增以下三種指定類型的廣告客戶層級指定目標功能:管道數位內容標籤排除條件敏感類別排除

新功能

2020 年 4 月 27 日

我們已推出一組大型功能集,將 API 的適用範圍拓展到 SDF。已新增 核心資源管理功能,可讓您建立、擷取、更新及刪除實體,例如廣告客戶、廣告活動、廣告訂單、委刊項和 廣告素材。透過新功能,您也可以在委刊項層級編輯指定目標。

新功能

已新增下列服務:

服務方法
廣告客戶

建立

刪除

取得

清單

修補程式

advertisers.assets

上傳

advertisers.campaigns

建立

刪除

取得

清單

修補程式

advertisers.channels

取得

清單

advertisers.creatives

建立

刪除

取得

清單

修補程式

advertisers.insertionOrders

建立

刪除

取得

清單

修補程式

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

建立

刪除

取得

清單

修補程式

advertisers.lineItems.targetingTypes.assignedTargetingOptions

建立

刪除

取得

清單

advertisers.locationLists

取得

清單

advertisers.negativeKeywordLists

取得

清單

combinedAudiences

取得

清單

customLists

取得

清單

firstAndThirdPartyAudiences

取得

清單

floodlightGroups

取得

修補程式

googleAudiences

取得

清單

inventorySourceGroups

取得

清單

inventorySources

取得

清單

partners.channels

取得

清單

partners.channels

取得

清單

2020 年 3 月 9 日

已推出螢幕和Video 360 API 第 1 版。這是 API 的初始版本。

已知問題

無。