從 v3 遷移至 v4

上次更新：2025 年 7 月 31 日

遷移應用程式

從 v3 遷移至 v4 時，您需要更新端點網址來呼叫 v4，並更新應用程式以因應重大變更。

將 API 呼叫從第 3 版更新至第 4 版

如要使用 v4 而非 v3，請更新要求，改用新的 v4 端點。

舉例來說，如要使用 v3 呼叫 advertisers.get 方法，請使用下列網址：

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

如果是 v4，請將網址更新為下列內容：

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

如果您使用用戶端程式庫向 API 發出要求，請使用最新版的用戶端程式庫，並更新設定以使用 v4。

進行必要變更

我們將在第 4 版中推出多項重大變更，請詳閱下列操作說明，並根據您目前使用 Display & Video 360 API 的情況，進行必要的變更。

更新有關第一方和第三方目標對象資源及相關指定目標的呼叫

FirstAndThirdPartyAudience 資源已替換為 FirstPartyAndPartnerAudience 資源。

如要進行這項變更，您必須更新下列項目：

• 參照 FirstAndThirdPartyAudience 資源，使用新的 FirstPartyAndPartnerAudience 資源。
• 現有對 v3 服務中方法的請求，會改為對新的 v4 服務 firstPartyAndPartnerAudiences 提出。firstAndThirdPartyAudiences
• 預期firstPartyAndPartnerAudiences.list要求預設頁面大小為 100 到 5000 個項目。
• 將 v3 firstAndThirdPartyAudienceType 欄位參照至新的 v4 firstPartyAndPartnerAudienceType 欄位，使用新的 FirstPartyAndPartnerAudienceType 列舉類型，舊值對應至下列新值：
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY 至 TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY 至 TYPE_PARTNER

• 參照 AudienceType 列舉值 LICENSED，改用下列其中一個新的更具體值：

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• 參照 TargetingType TARGETING_TYPE_AUDIENCE_GROUP 的 AssignedTargetingOption 資源，以取代 AudienceGroupAssignedTargetingOptionDetails 中的 v3 欄位，並使用下列新的 v4 欄位：

  • excludedFirstAndThirdPartyAudienceGroup (excludedFirstPartyAndPartnerAudienceGroup)
  • includedFirstAndThirdPartyAudienceGroups (includedFirstPartyAndPartnerAudienceGroups)

更新現有廣告群組大量名單指定目標要求

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions 已重新命名為 advertisers.adGroups.bulkListAssignedTargetingOptions。更新現有要求，改用新的方法名稱。

建立廣告訂單時，請加入最佳化目標

optimizationObjective 現在是 InsertionOrder 資源的必填欄位。更新您的 advertisers.insertionOrders.create要求，確認已設定這個欄位。

移除對廣告素材資源欄位 publisherReviewStatuses 的參照

publisherReviewStatuses 欄位已於 2024 年 6 月淘汰，並從 Creative 資源的 ReviewStatusInfo 物件中移除。