Release Notes

Page Summary

• This page details the release notes for currently active Google Ad Manager API versions, including some previous versions for completeness.

• The latest version, v202508, introduces additions to Video and Line Items features.

• Version v202505 includes updates related to Multiple Customer Management and Line Items/Proposal Line Items.

• Version v202502 highlights the addition of a new error code for active targeting preset limits.

• Version v202411 includes changes to Line Items and Reporting, and a renaming in the Publisher Query Language.

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: v202602
• Previous versions: v202511, v202508, v202505

v202602

What's New

PublisherQueryLanguageService

• Removed legacy DoubleClick Sales Manager entities from Change_History table.

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, 3 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
    2. ≠ type LineItemSummary
       1. + field deliveryAllocationProfileId
    3. ≠ type ProposalLineItem
       1. + field deliveryAllocationProfileId
20. = InventoryService (no changes)
21. = LabelService (no changes)
22. ≠ LineItemCreativeAssociationService (0 new, 1 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
23. ≠ LineItemService (0 new, 2 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
    2. ≠ type LineItemSummary
       1. + field deliveryAllocationProfileId
24. ≠ LineItemTemplateService (0 new, 1 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
25. = LiveStreamEventService (no changes)
26. = MobileApplicationService (no changes)
27. = NativeStyleService (no changes)
28. = NetworkService (no changes)
29. ≠ OrderService (0 new, 1 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
30. = PlacementService (no changes)
31. ≠ ProposalLineItemService (0 new, 3 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
    2. ≠ type ProposalLineItem
       1. + field deliveryAllocationProfileId
    3. ≠ enum ProposalLineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
32. ≠ ProposalService (0 new, 1 changed, 0 removed)
    1. ≠ enum ProposalLineItemError.Reason
       1. + value INVALID_LINE_ITEM_TYPE_FOR_ALLOCATION_DELIVERY_PROFILE
33. ≠ PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. ≠ enum ChangeHistoryEntityType
       1. − value PREMIUM_RATE
       2. − value PRODUCT
       3. − value PRODUCT_PACKAGE
       4. − value PRODUCT_PACKAGE_ITEM
       5. − value PRODUCT_TEMPLATE
       6. − value RATE_CARD
       7. − value WORKFLOW
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)

v202511

What's New

Creatives

• Added ThirdPartyDataDeclarationStatus.

Line Items

• Added PublisherProvidedSignalsTargeting .

Companies

• Added verifiedExchangeAdvertiserdId .

API Changes

1. ≠ AdRuleService (1 new, 1 changed, 0 removed)
   1. + type PublisherProvidedSignalsTargeting
   2. ≠ type Targeting
      1. + field publisherProvidedSignalsTargeting
2. ≠ AdjustmentService (1 new, 1 changed, 0 removed)
   1. + type PublisherProvidedSignalsTargeting
   2. ≠ type Targeting
      1. + field publisherProvidedSignalsTargeting
3. = AdsTxtService (no changes)
4. = AudienceSegmentService (no changes)
5. = CdnConfigurationService (no changes)
6. = CmsMetadataService (no changes)
7. ≠ CompanyService (0 new, 1 changed, 0 removed)
   1. ≠ type Company
      1. + field verifiedExchangeAdvertiserId
      2. + field verifiedExchangeBrandId
8. = ContactService (no changes)
9. = ContentBundleService (no changes)
10. = ContentService (no changes)
11. ≠ CreativeService (1 new, 3 changed, 0 removed)
    1. + enum ThirdPartyDataDeclarationStatus
    2. ≠ type Creative
       1. + field thirdPartyDataDeclarationStatus
    3. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
    4. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_BUYER_PLACEMENT_ID_REQUIRED
12. ≠ CreativeSetService (0 new, 1 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
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 (2 new, 5 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. + type PublisherProvidedSignalsTargetingError
    3. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
    4. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_BUYER_PLACEMENT_ID_REQUIRED
    5. ≠ type ProposalLineItem
       1. + field supplyPath
    6. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting
    7. ≠ enum TargetingDimension
       1. + value PUBLISHER_PROVIDED_SIGNALS
20. = InventoryService (no changes)
21. = LabelService (no changes)
22. ≠ LineItemCreativeAssociationService (0 new, 2 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_BUYER_PLACEMENT_ID_REQUIRED
23. ≠ LineItemService (2 new, 3 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. + type PublisherProvidedSignalsTargetingError
    3. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
    4. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_BUYER_PLACEMENT_ID_REQUIRED
    5. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting
24. ≠ LineItemTemplateService (1 new, 2 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargetingError
    2. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
    3. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_BUYER_PLACEMENT_ID_REQUIRED
25. = LiveStreamEventService (no changes)
26. = MobileApplicationService (no changes)
27. ≠ NativeStyleService (1 new, 1 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting
28. = NetworkService (no changes)
29. ≠ OrderService (1 new, 2 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargetingError
    2. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
    3. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_BUYER_PLACEMENT_ID_REQUIRED
30. = PlacementService (no changes)
31. ≠ ProposalLineItemService (2 new, 3 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. + type PublisherProvidedSignalsTargetingError
    3. ≠ enum ProposalError.Reason
       1. + value UPDATE_SUPPLY_PATH_NOT_ALLOWED
       2. + value BUYER_DISABLED_FOR_AGENCY_DIRECT
    4. ≠ type ProposalLineItem
       1. + field supplyPath
    5. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting
32. ≠ ProposalService (1 new, 3 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. ≠ type Proposal
       1. + field supplyPath
    3. ≠ enum ProposalError.Reason
       1. + value UPDATE_SUPPLY_PATH_NOT_ALLOWED
       2. + value BUYER_DISABLED_FOR_AGENCY_DIRECT
    4. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting
33. ≠ PublisherQueryLanguageService (1 new, 2 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. ≠ enum CreativeError.Reason
       1. + value CANNOT_REMOVE_PLACEMENT_IDS
    3. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting
34. = ReportService (no changes)
35. = SegmentPopulationService (no changes)
36. = SiteService (no changes)
37. = StreamActivityMonitorService (no changes)
38. = SuggestedAdUnitService (no changes)
39. ≠ TargetingPresetService (2 new, 1 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. + type PublisherProvidedSignalsTargetingError
    3. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting
40. = TeamService (no changes)
41. = UserService (no changes)
42. = UserTeamAssociationService (no changes)
43. ≠ YieldGroupService (2 new, 1 changed, 0 removed)
    1. + type PublisherProvidedSignalsTargeting
    2. + type PublisherProvidedSignalsTargetingError
    3. ≠ type Targeting
       1. + field publisherProvidedSignalsTargeting

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)