Release Notes

This page contains the release notes for the active versions of Google Ad Manager API. Release notes from some previous versions that are no longer available are exposed only for completeness.

• Latest version: v202508
• Previous versions: v202505, v202502, v202411

v202508

What's New

Video

• Added MimeType.VIDEO_MP2T.

Line Items

• Added CostType.CPCV .
• Added UnitType.COMPLETED_VIEWS .

API Changes

1. = AdRuleService (no changes)
2. ≠ AdjustmentService (0 new, 2 changed, 0 removed)
   1. ≠ enum DateTimeRangeTargetingError.Reason
      1. + value BLACKOUT_DURATION_TOO_SHORT
   2. ≠ enum ForecastAdjustmentError.Reason
      1. − value PARENT_SEGMENT_TARGETING_INCOMPATIBLE_WITH_HISTORICAL_BASIS_AD_REQUEST_SOURCE_SETTINGS
3. = AdsTxtService (no changes)
4. = AudienceSegmentService (no changes)
5. = CdnConfigurationService (no changes)
6. = CmsMetadataService (no changes)
7. = CompanyService (no changes)
8. = ContactService (no changes)
9. = ContentBundleService (no changes)
10. ≠ ContentService (0 new, 2 changed, 0 removed)
    1. ≠ enum MimeType
       1. + value VIDEO_MP2T
    2. ≠ enum VodIngestError
       1. + value CHAPTER_PTS_MISMATCH
       2. + value CHAPTER_RENDITION_ERROR
11. ≠ CreativeService (0 new, 2 changed, 0 removed)
    1. ≠ type Creative
       1. + field selfDeclaredEuropeanUnionPoliticalContent
    2. ≠ enum MimeType
       1. + value VIDEO_MP2T
12. = CreativeSetService (no changes)
13. = CreativeTemplateService (no changes)
14. = CreativeWrapperService (no changes)
15. = CustomFieldService (no changes)
16. = CustomTargetingService (no changes)
17. = DaiAuthenticationKeyService (no changes)
18. = DaiEncodingProfileService (no changes)
19. ≠ ForecastService (0 new, 4 changed, 0 removed)
    1. ≠ enum CostType
       1. + value CPCV
    2. ≠ enum DateTimeRangeTargetingError.Reason
       1. + value BLACKOUT_DURATION_TOO_SHORT
    3. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + value COMPLETED_VIEWS
20. = InventoryService (no changes)
21. = LabelService (no changes)
22. ≠ LineItemCreativeAssociationService (0 new, 1 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
23. ≠ LineItemService (0 new, 4 changed, 0 removed)
    1. ≠ enum CostType
       1. + value CPCV
    2. ≠ enum DateTimeRangeTargetingError.Reason
       1. + value BLACKOUT_DURATION_TOO_SHORT
    3. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + value COMPLETED_VIEWS
24. ≠ LineItemTemplateService (0 new, 2 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + value BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
25. ≠ LiveStreamEventService (0 new, 1 changed, 0 removed)
    1. ≠ enum VideoAdTagError.Reason
       1. + value DUPLICATE_AD_TAG_PARAMETER
26. = MobileApplicationService (no changes)
27. ≠ NativeStyleService (0 new, 1 changed, 0 removed)
    1. ≠ enum NativeStyleError.Reason
       1. + value INVALID_FLUID_SIZE_FOR_NEWSLETTER_FORMAT
28. = NetworkService (no changes)
29. ≠ OrderService (0 new, 2 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + value BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
30. = PlacementService (no changes)
31. ≠ ProposalLineItemService (0 new, 3 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + value BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
    3. ≠ enum UnitType
       1. + value COMPLETED_VIEWS
32. = ProposalService (no changes)
33. = PublisherQueryLanguageService (no changes)
34. = ReportService (no changes)
35. = SegmentPopulationService (no changes)
36. = SiteService (no changes)
37. ≠ StreamActivityMonitorService (0 new, 1 changed, 0 removed)
    1. ≠ type VodStreamCreateRequest
       1. + field podServingSessionTitle
38. = SuggestedAdUnitService (no changes)
39. ≠ TargetingPresetService (0 new, 1 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + value BLACKOUT_DURATION_TOO_SHORT
40. = TeamService (no changes)
41. = UserService (no changes)
42. = UserTeamAssociationService (no changes)
43. ≠ YieldGroupService (0 new, 1 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + value BLACKOUT_DURATION_TOO_SHORT

v202505

What's New

Multiple Customer Management

• Added InvitationStatus for ChildPublisher companies.

Line Items

• Added repeatedCreativeServingEnabled field to LineItems.

Proposal Line Items

• Added BuyerPermissionType to ProposalLineItems for controlling how buyers can transact on deals.

API Changes

1. = AdRuleService (no changes)
2. ≠ AdjustmentService (0 new, 1 changed, 0 removed)
   1. ≠ enum ForecastAdjustmentError.Reason
      1. + value AD_REQUEST_ADJUSTMENT_MUST_USE_PARENT_SEGMENT_TARGETING
3. = AdsTxtService (no changes)
4. = AudienceSegmentService (no changes)
5. = CdnConfigurationService (no changes)
6. = CmsMetadataService (no changes)
7. ≠ CompanyService (1 new, 2 changed, 0 removed)
   1. + enum InvitationStatus
   2. ≠ type ChildPublisher
      1. + field invitationStatus
      2. − field status
   3. ≠ enum McmError.Reason
      1. + value OPERATION_UNSUPPORTED_INITIAL_STATUS
8. = ContactService (no changes)
9. = ContentBundleService (no changes)
10. ≠ ContentService (0 new, 1 changed, 0 removed)
    1. ≠ enum VodIngestError
       1. + value DISCONTINUITY_COUNT_DOES_NOT_MATCH_PTS_COUNT
11. ≠ CreativeService (0 new, 1 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
12. ≠ CreativeSetService (0 new, 1 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
13. = CreativeTemplateService (no changes)
14. = CreativeWrapperService (no changes)
15. = CustomFieldService (no changes)
16. = CustomTargetingService (no changes)
17. = DaiAuthenticationKeyService (no changes)
18. = DaiEncodingProfileService (no changes)
19. ≠ ForecastService (0 new, 6 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + value REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ type LineItemSummary
       1. + field repeatedCreativeServingEnabled
    4. ≠ enum ProgrammaticError.Reason
       1. + value INVALID_BUYER
    5. ≠ type ProposalLineItem
       1. + field buyerPermissionType
    6. ≠ enum TargetingDimension
       1. − value VIDEO_POSITION
20. = InventoryService (no changes)
21. = LabelService (no changes)
22. ≠ LineItemCreativeAssociationService (0 new, 2 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + value REPEATED_CREATIVE_SERVING_NOT_ALLOWED
23. ≠ LineItemService (0 new, 4 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + value REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ type LineItemSummary
       1. + field repeatedCreativeServingEnabled
    4. ≠ enum ProgrammaticError.Reason
       1. + value INVALID_BUYER
24. ≠ LineItemTemplateService (0 new, 3 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + value REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ enum ProgrammaticError.Reason
       1. + value INVALID_BUYER
25. = LiveStreamEventService (no changes)
26. = MobileApplicationService (no changes)
27. = NativeStyleService (no changes)
28. ≠ NetworkService (0 new, 1 changed, 0 removed)
    1. ≠ enum McmError.Reason
       1. + value OPERATION_UNSUPPORTED_INITIAL_STATUS
29. ≠ OrderService (0 new, 3 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + value REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ enum ProgrammaticError.Reason
       1. + value INVALID_BUYER
30. = PlacementService (no changes)
31. ≠ ProposalLineItemService (0 new, 3 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    2. ≠ enum ProgrammaticError.Reason
       1. + value INVALID_BUYER
    3. ≠ type ProposalLineItem
       1. + field buyerPermissionType
32. ≠ ProposalService (0 new, 1 changed, 0 removed)
    1. ≠ enum ProgrammaticError.Reason
       1. + value INVALID_BUYER
33. ≠ PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − value INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
34. = ReportService (no changes)
35. = SegmentPopulationService (no changes)
36. = SiteService (no changes)
37. = StreamActivityMonitorService (no changes)
38. = SuggestedAdUnitService (no changes)
39. = TargetingPresetService (no changes)
40. = TeamService (no changes)
41. = UserService (no changes)
42. = UserTeamAssociationService (no changes)
43. = YieldGroupService (no changes)

v202502

What's New

Targeting Presets

• Added new error code for active targeting preset limits.

API Changes

1. = AdRuleService (no changes)
2. ≠ AdjustmentService (0 new, 1 changed, 0 removed)
   1. ≠ enum EntityLimitReachedError.Reason
      1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
3. = AdsTxtService (no changes)
4. ≠ AudienceSegmentService (0 new, 1 changed, 0 removed)
   1. ≠ enum EntityLimitReachedError.Reason
      1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
5. = CdnConfigurationService (no changes)
6. = CmsMetadataService (no changes)
7. = CompanyService (no changes)
8. = ContactService (no changes)
9. = ContentBundleService (no changes)
10. = ContentService (no changes)
11. ≠ CreativeService (0 new, 2 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
12. ≠ CreativeSetService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
13. = CreativeTemplateService (no changes)
14. = CreativeWrapperService (no changes)
15. ≠ CustomFieldService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
16. ≠ CustomTargetingService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
17. = DaiAuthenticationKeyService (no changes)
18. ≠ DaiEncodingProfileService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
19. ≠ ForecastService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
20. ≠ InventoryService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
21. = LabelService (no changes)
22. ≠ LineItemCreativeAssociationService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ type LineItemCreativeAssociationStats
       1. − field costInOrderCurrency
23. ≠ LineItemService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
24. ≠ LineItemTemplateService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
25. ≠ LiveStreamEventService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
26. = MobileApplicationService (no changes)
27. = NativeStyleService (no changes)
28. = NetworkService (no changes)
29. ≠ OrderService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
30. ≠ PlacementService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
31. ≠ ProposalLineItemService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
32. ≠ ProposalService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
33. ≠ PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
34. = ReportService (no changes)
35. = SegmentPopulationService (no changes)
36. ≠ SiteService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
37. = StreamActivityMonitorService (no changes)
38. ≠ SuggestedAdUnitService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
39. ≠ TargetingPresetService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
40. ≠ TeamService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
41. ≠ UserService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
42. = UserTeamAssociationService (no changes)
43. ≠ YieldGroupService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED

v202411

What's New

Line Items

• Removed GOOGLE as a GrpProvider

Reporting

• Added INVENTORY_FORMAT Dimensions.

Publisher Query Language

• Renamed the Line_Item table field endDateTime to servingEndTime. In both v202411 and earlier versions, the value is inclusive of any grace period The new name differentiates the PQL field from the LineItem.endDateTime field which is exclusive of any grace period.

API Changes

1. = AdRuleService (no changes)
2. = AdjustmentService (no changes)
3. = AdsTxtService (no changes)
4. = AudienceSegmentService (no changes)
5. = CdnConfigurationService (no changes)
6. = CmsMetadataService (no changes)
7. = CompanyService (no changes)
8. = ContactService (no changes)
9. = ContentBundleService (no changes)
10. = ContentService (no changes)
11. = CreativeService (no changes)
12. = CreativeSetService (no changes)
13. = CreativeTemplateService (no changes)
14. = CreativeWrapperService (no changes)
15. = CustomFieldService (no changes)
16. = CustomTargetingService (no changes)
17. = DaiAuthenticationKeyService (no changes)
18. = DaiEncodingProfileService (no changes)
19. ≠ ForecastService (0 new, 1 changed, 0 removed)
    1. ≠ enum GrpProvider
       1. − value GOOGLE
20. = InventoryService (no changes)
21. = LabelService (no changes)
22. ≠ LineItemCreativeAssociationService (0 new, 2 changed, 1 removed)
    1. ≠ enum LineItemCreativeAssociation.Status
       1. − value NOT_SERVING
    2. ≠ operation pushCreativeToDevices
       1. − parameter filterStatement
       2. − parameter options
       3. − response rval
    3. − operation pushCreativeToDevices
23. ≠ LineItemService (0 new, 1 changed, 0 removed)
    1. ≠ enum GrpProvider
       1. − value GOOGLE
24. = LineItemTemplateService (no changes)
25. = LiveStreamEventService (no changes)
26. = MobileApplicationService (no changes)
27. = NativeStyleService (no changes)
28. = NetworkService (no changes)
29. = OrderService (no changes)
30. = PlacementService (no changes)
31. ≠ ProposalLineItemService (0 new, 1 changed, 0 removed)
    1. ≠ enum GrpProvider
       1. − value GOOGLE
32. = ProposalService (no changes)
33. = PublisherQueryLanguageService (no changes)
34. ≠ ReportService (0 new, 1 changed, 0 removed)
    1. ≠ enum Dimension
       1. + value INVENTORY_FORMAT
       2. + value INVENTORY_FORMAT_NAME
35. = SegmentPopulationService (no changes)
36. ≠ SiteService (0 new, 1 changed, 0 removed)
    1. ≠ type Site
       1. − field active
37. = StreamActivityMonitorService (no changes)
38. = SuggestedAdUnitService (no changes)
39. = TargetingPresetService (no changes)
40. = TeamService (no changes)
41. = UserService (no changes)
42. = UserTeamAssociationService (no changes)
43. = YieldGroupService (no changes)