版本说明

本页面包含 Google Ad Manager API 的有效版本的版本说明。为了完整起见，我们仅展示一些不再可用的旧版本的版本说明。

• 最新版本：v202508
• 之前版本：v202505、v202502、v202411

v202508

新变化

视频

• 添加了 MimeType.VIDEO_MP2T。

订单项

• 添加了 CostType.CPCV 。
• 添加了 UnitType.COMPLETED_VIEWS 。

API 更改

1. = AdRuleService （无变动）
2. ≠ AdjustmentService （0 个新功能、2 个已更改的功能、0 个已移除的功能）
   1. ≠ 枚举 DateTimeRangeTargetingError.Reason
      1. + 值 BLACKOUT_DURATION_TOO_SHORT
   2. ≠ enum ForecastAdjustmentError.Reason
      1. − 值 PARENT_SEGMENT_TARGETING_INCOMPATIBLE_WITH_HISTORICAL_BASIS_AD_REQUEST_SOURCE_SETTINGS
3. = AdsTxtService （无更改）
4. = AudienceSegmentService （无变化）
5. = CdnConfigurationService （无变化）
6. = CmsMetadataService （无变化）
7. = CompanyService （无变化）
8. = ContactService （无变动）
9. = ContentBundleService （无变化）
10. ≠ ContentService （0 个新增、2 个已更改、0 个已移除）
    1. ≠ enum MimeType
       1. + 值 VIDEO_MP2T
    2. ≠ enum VodIngestError
       1. + 值 CHAPTER_PTS_MISMATCH
       2. + 值 CHAPTER_RENDITION_ERROR
11. ≠ CreativeService （0 个新增、2 个已更改、0 个已移除）
    1. ≠ 类型广告素材
       1. + 字段 selfDeclaredEuropeanUnionPoliticalContent
    2. ≠ enum MimeType
       1. + 值 VIDEO_MP2T
12. = CreativeSetService （无变化）
13. = CreativeTemplateService （无变化）
14. = CreativeWrapperService （无变化）
15. = CustomFieldService （无更改）
16. = CustomTargetingService （无更改）
17. = DaiAuthenticationKeyService （无更改）
18. = DaiEncodingProfileService （无更改）
19. ≠ ForecastService （0 个新增、4 个已更改、0 个已移除）
    1. ≠ enum CostType
       1. + 价值 CPCV
    2. ≠ 枚举 DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    3. ≠ 枚举 LineItemError.Reason
       1. + 值 PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + 值 COMPLETED_VIEWS
20. = InventoryService （无变化）
21. = LabelService （无变化）
22. ≠ LineItemCreativeAssociationService （0 个新增，1 个已更改，0 个已移除）
    1. ≠ 枚举 LineItemError.Reason
       1. + 值 PLACEHOLDER_COUNT_NOT_SUPPORTED
23. ≠ LineItemService （0 个新增、4 个已更改、0 个已移除）
    1. ≠ enum CostType
       1. + 价值 CPCV
    2. ≠ 枚举 DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    3. ≠ 枚举 LineItemError.Reason
       1. + 值 PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + 值 COMPLETED_VIEWS
24. ≠ LineItemTemplateService （0 个新增、2 个已更改、0 个已移除）
    1. ≠ 枚举 DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 PLACEHOLDER_COUNT_NOT_SUPPORTED
25. ≠ LiveStreamEventService （0 个新增、1 个更改、0 个移除）
    1. ≠ enum VideoAdTagError.Reason
       1. + 值 DUPLICATE_AD_TAG_PARAMETER
26. = MobileApplicationService （无变化）
27. ≠ NativeStyleService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ 枚举 NativeStyleError.Reason
       1. + 值 INVALID_FLUID_SIZE_FOR_NEWSLETTER_FORMAT
28. = NetworkService （无变化）
29. ≠ OrderService （0 个新项，2 个更改项，0 个移除项）
    1. ≠ 枚举 DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 PLACEHOLDER_COUNT_NOT_SUPPORTED
30. = PlacementService （无变化）
31. ≠ ProposalLineItemService （0 个新增、3 个已更改、0 个已移除）
    1. ≠ 枚举 DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 PLACEHOLDER_COUNT_NOT_SUPPORTED
    3. ≠ enum UnitType
       1. + 值 COMPLETED_VIEWS
32. = ProposalService （无变化）
33. = PublisherQueryLanguageService （无变化）
34. = ReportService （无变化）
35. = SegmentPopulationService （无变化）
36. = SiteService （无变化）
37. ≠ StreamActivityMonitorService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ type VodStreamCreateRequest
       1. + 字段 podServingSessionTitle
38. = SuggestedAdUnitService （无更改）
39. ≠ TargetingPresetService （0 个新增，1 个已更改，0 个已移除）
    1. ≠ 枚举 DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
40. = TeamService （无更改）
41. = UserService （无变化）
42. = UserTeamAssociationService （无变化）
43. ≠ YieldGroupService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ 枚举 DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT

v202505

新变化

多客户管理

• 为 ChildPublisher 公司添加了 InvitationStatus。

订单项

• 向 LineItems 添加了 repeatedCreativeServingEnabled 字段。

提案订单项

• 向 ProposalLineItems 添加了 BuyerPermissionType，用于控制买方如何通过交易进行交易。

API 更改

1. = AdRuleService （无变动）
2. ≠ AdjustmentService （0 个新增、1 个更改、0 个移除）
   1. ≠ enum ForecastAdjustmentError.Reason
      1. + 值 AD_REQUEST_ADJUSTMENT_MUST_USE_PARENT_SEGMENT_TARGETING
3. = AdsTxtService （无更改）
4. = AudienceSegmentService （无变化）
5. = CdnConfigurationService （无变化）
6. = CmsMetadataService （无变化）
7. ≠ CompanyService （1 个新功能、2 个已更改的功能、0 个已移除的功能）
   1. + enum InvitationStatus
   2. ≠ type ChildPublisher
      1. + 字段 invitationStatus
      2. − 字段状态
   3. ≠ enum McmError.Reason
      1. + 值 OPERATION_UNSUPPORTED_INITIAL_STATUS
8. = ContactService （无变动）
9. = ContentBundleService （无变化）
10. ≠ ContentService （0 个新内容、1 个已更改内容、0 个已移除内容）
    1. ≠ enum VodIngestError
       1. + 值 DISCONTINUITY_COUNT_DOES_NOT_MATCH_PTS_COUNT
11. ≠ CreativeService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
12. ≠ CreativeSetService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
13. = CreativeTemplateService （无变化）
14. = CreativeWrapperService （无变化）
15. = CustomFieldService （无更改）
16. = CustomTargetingService （无更改）
17. = DaiAuthenticationKeyService （无更改）
18. = DaiEncodingProfileService （无更改）
19. ≠ ForecastService （0 个新增、6 个已更改、0 个已移除）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ type LineItemSummary
       1. + 字段 repeatedCreativeServingEnabled
    4. ≠ 枚举 ProgrammaticError.Reason
       1. + value INVALID_BUYER
    5. ≠ type ProposalLineItem
       1. + 字段 buyerPermissionType
    6. ≠ 枚举 TargetingDimension
       1. − 值 VIDEO_POSITION
20. = InventoryService （无变化）
21. = LabelService （无变化）
22. ≠ LineItemCreativeAssociationService （0 个新增、2 个已更改、0 个已移除）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
23. ≠ LineItemService （0 个新增、4 个已更改、0 个已移除）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ type LineItemSummary
       1. + 字段 repeatedCreativeServingEnabled
    4. ≠ 枚举 ProgrammaticError.Reason
       1. + value INVALID_BUYER
24. ≠ LineItemTemplateService （0 个新增、3 个已更改、0 个已移除）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ 枚举 ProgrammaticError.Reason
       1. + value INVALID_BUYER
25. = LiveStreamEventService （无变化）
26. = MobileApplicationService （无变化）
27. = NativeStyleService （无变化）
28. ≠ NetworkService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum McmError.Reason
       1. + 值 OPERATION_UNSUPPORTED_INITIAL_STATUS
29. ≠ OrderService （0 个新功能、3 个已更改的功能、0 个已移除的功能）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ 枚举 LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ 枚举 ProgrammaticError.Reason
       1. + value INVALID_BUYER
30. = PlacementService （无变化）
31. ≠ ProposalLineItemService （0 个新增、3 个已更改、0 个已移除）
    1. ≠ 枚举 LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    2. ≠ 枚举 ProgrammaticError.Reason
       1. + value INVALID_BUYER
    3. ≠ type ProposalLineItem
       1. + 字段 buyerPermissionType
32. ≠ ProposalService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ 枚举 ProgrammaticError.Reason
       1. + value INVALID_BUYER
33. ≠ PublisherQueryLanguageService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ 枚举 CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − 值 INVALID_AD_EXCHANGE_CREATIVE_SIZE
34. = ReportService （无变化）
35. = SegmentPopulationService （无变化）
36. = SiteService （无变化）
37. = StreamActivityMonitorService （无变化）
38. = SuggestedAdUnitService （无更改）
39. = TargetingPresetService （无变化）
40. = TeamService （无更改）
41. = UserService （无变化）
42. = UserTeamAssociationService （无变化）
43. = YieldGroupService （无更改）

v202502

新变化

定位预设

• 针对有效定位预设限制添加了新的错误代码。

API 更改

1. = AdRuleService （无变动）
2. ≠ AdjustmentService （0 个新增、1 个更改、0 个移除）
   1. ≠ enum EntityLimitReachedError.Reason
      1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
3. = AdsTxtService （无更改）
4. ≠ AudienceSegmentService （0 个新增、1 个已更改、0 个已移除）
   1. ≠ enum EntityLimitReachedError.Reason
      1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
5. = CdnConfigurationService （无变化）
6. = CmsMetadataService （无变化）
7. = CompanyService （无变化）
8. = ContactService （无变动）
9. = ContentBundleService （无变化）
10. = ContentService （无变化）
11. ≠ CreativeService （0 个新增、2 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ 枚举 LineItemCreativeAssociationError.Reason
       1. + 值 CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
12. ≠ CreativeSetService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
13. = CreativeTemplateService （无变化）
14. = CreativeWrapperService （无变化）
15. ≠ CustomFieldService （0 个新字段、1 个已更改字段、0 个已移除字段）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
16. ≠ CustomTargetingService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
17. = DaiAuthenticationKeyService （无更改）
18. ≠ DaiEncodingProfileService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
19. ≠ ForecastService （0 个新功能、3 个已更改的功能、0 个已移除的功能）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ 枚举 LineItemCreativeAssociationError.Reason
       1. + 值 CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ 枚举 OrderActionError.Reason
       1. + 值 CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
20. ≠ InventoryService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
21. = LabelService （无变化）
22. ≠ LineItemCreativeAssociationService （0 个新增、3 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ 枚举 LineItemCreativeAssociationError.Reason
       1. + 值 CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ type LineItemCreativeAssociationStats
       1. − 字段 costInOrderCurrency
23. ≠ LineItemService （0 个新对象、3 个已更改对象、0 个已移除对象）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ 枚举 LineItemCreativeAssociationError.Reason
       1. + 值 CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ 枚举 OrderActionError.Reason
       1. + 值 CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
24. ≠ LineItemTemplateService （0 个新增、3 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ 枚举 LineItemCreativeAssociationError.Reason
       1. + 值 CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ 枚举 OrderActionError.Reason
       1. + 值 CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
25. ≠ LiveStreamEventService （0 个新增、1 个更改、0 个移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
26. = MobileApplicationService （无变化）
27. = NativeStyleService （无变化）
28. = NetworkService （无变化）
29. ≠ OrderService （0 个新功能、3 个已更改的功能、0 个已移除的功能）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ 枚举 LineItemCreativeAssociationError.Reason
       1. + 值 CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ 枚举 OrderActionError.Reason
       1. + 值 CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
30. ≠ PlacementService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
31. ≠ ProposalLineItemService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
32. ≠ ProposalService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
33. ≠ PublisherQueryLanguageService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ 枚举 OrderActionError.Reason
       1. + 值 CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
34. = ReportService （无变化）
35. = SegmentPopulationService （无变化）
36. ≠ SiteService （0 个新增、1 个更改、0 个移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
37. = StreamActivityMonitorService （无变化）
38. ≠ SuggestedAdUnitService （0 个新增、1 个更改、0 个移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
39. ≠ TargetingPresetService （0 个新增，1 个已更改，0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
40. ≠ TeamService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
41. ≠ UserService （0 个新服务、1 个已更改的服务、0 个已移除的服务）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
42. = UserTeamAssociationService （无变化）
43. ≠ YieldGroupService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum EntityLimitReachedError.Reason
       1. + 值 ACTIVE_TARGETING_PRESETS_LIMIT_REACHED

v202411

新变化

订单项

• 已移除“GOOGLE”（作为GrpProvider） GrpProvider

报告

• 添加了 INVENTORY_FORMAT 维度。

发布商查询语言

• 将 Line_Item 表字段 endDateTime 重命名为 servingEndTime。在 v202411 及更早版本中，该值包含所有宽限期。新名称可将此 PQL 字段与不包含任何宽限期的 LineItem.endDateTime 字段区分开来。

API 更改

1. = AdRuleService （无变动）
2. = AdjustmentService （无更改）
3. = AdsTxtService （无更改）
4. = AudienceSegmentService （无变化）
5. = CdnConfigurationService （无变化）
6. = CmsMetadataService （无变化）
7. = CompanyService （无变化）
8. = ContactService （无变动）
9. = ContentBundleService （无变化）
10. = ContentService （无变化）
11. = CreativeService （无变化）
12. = CreativeSetService （无变化）
13. = CreativeTemplateService （无变化）
14. = CreativeWrapperService （无变化）
15. = CustomFieldService （无更改）
16. = CustomTargetingService （无更改）
17. = DaiAuthenticationKeyService （无更改）
18. = DaiEncodingProfileService （无更改）
19. ≠ ForecastService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum GrpProvider
       1. − 价值 Google
20. = InventoryService （无变化）
21. = LabelService （无变化）
22. ≠ LineItemCreativeAssociationService （0 个新增、2 个已更改、1 个已移除）
    1. ≠ 枚举 LineItemCreativeAssociation.Status
       1. − 值 NOT_SERVING
    2. ≠ 操作 pushCreativeToDevices
       1. − parameter filterStatement
       2. − 参数选项
       3. − 响应 rval
    3. − 操作 pushCreativeToDevices
23. ≠ LineItemService （0 个新增、1 个更改、0 个移除）
    1. ≠ enum GrpProvider
       1. − 价值 Google
24. = LineItemTemplateService （无变化）
25. = LiveStreamEventService （无变化）
26. = MobileApplicationService （无变化）
27. = NativeStyleService （无变化）
28. = NetworkService （无变化）
29. = OrderService （无变化）
30. = PlacementService （无变化）
31. ≠ ProposalLineItemService （0 个新增、1 个已更改、0 个已移除）
    1. ≠ enum GrpProvider
       1. − 价值 Google
32. = ProposalService （无变化）
33. = PublisherQueryLanguageService （无变化）
34. ≠ ReportService （0 个新报告、1 个已更改的报告、0 个已移除的报告）
    1. ≠ enum Dimension
       1. + 值 INVENTORY_FORMAT
       2. + 值 INVENTORY_FORMAT_NAME
35. = SegmentPopulationService （无变化）
36. ≠ SiteService （0 个新增、1 个更改、0 个移除）
    1. ≠ type Site
       1. − 字段处于有效状态
37. = StreamActivityMonitorService （无变化）
38. = SuggestedAdUnitService （无更改）
39. = TargetingPresetService （无变化）
40. = TeamService （无更改）
41. = UserService （无变化）
42. = UserTeamAssociationService （无变化）
43. = YieldGroupService （无更改）