自 2025 年 9 月 8 日起，每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明，请参阅我们的弃用页面。

此页面由 Cloud Translation API 翻译。

从 v3 迁移到 v4

上次更新日期：2025 年 7 月 31 日

迁移应用

从 v3 迁移到 v4 需要更新端点网址以调用 v4，并更新应用以应对重大变更。

如需使用 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。

我们将在 v4 中引入多项破坏性变更。请查看以下说明，并根据您目前对 Display & Video 360 API 的使用情况进行必要的更改。

FirstAndThirdPartyAudience 资源已替换为 FirstPartyAndPartnerAudience 资源。

此更改要求您更新以下内容：

对 FirstAndThirdPartyAudience 资源的引用，用于使用新的 FirstPartyAndPartnerAudience 资源。
将对 v3 服务中方法的现有请求从 firstAndThirdPartyAudiences 迁移到新的 v4 服务 firstPartyAndPartnerAudiences。
对于 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 字段已从 Creative 资源下的 ReviewStatusInfo 对象中移除，此前该字段已于 2024 年 6 月被弃用。