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.

v202505

What's New

Multiple Customer Management
Line Items
Proposal Line Items

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
Reporting
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)

v202408

What's New

Line Items
MCM
  • Added AdsTxtService for reading MCM supply chain diaghnostic reports.
Reporting
  • Replaced VIDEO_PLACEMENT_NAME Dimension with VIDEO_PLCMT_NAME which reflects the updated IAB definition.

API Changes

  1. + AdsTxtService
  2. AdRuleService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  3. AdjustmentService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  4. = AudienceSegmentService (no changes)
  5. = CdnConfigurationService (no changes)
  6. = CmsMetadataService (no changes)
  7. CompanyService (0 new, 1 changed, 0 removed)
    1. enum McmError.Reason
      1. + value REVENUE_SHARE_PERCENT_OUTSIDE_RANGE
      2. + value RESELLER_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT
      3. + value MI_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT
      4. + value CHILD_NETWORK_DISAPPROVED
      5. + value MANAGE_INVENTORY_UNSUPPORTED_IN_RESELLER_NETWORK
      6. + value CANNOT_SEND_INVITATION_TO_MCM_PARENT
      7. + value CANNOT_SEND_INVITATION_TO_NETWORK_WITH_RESELLER_PARENT
      8. + value CANNOT_SEND_INVITATION_TO_SELF
      9. + value CANNOT_CLOSE_MCM_WITH_ACTIVE_CHILDREN
      10. + value CANNOT_TURN_CHILD_INTO_PARENT_WITH_ACTIVE_INVITATION
      11. + value MISSING_NETWORK_EXCHANGE_ACCOUNT
  8. = ContactService (no changes)
  9. = ContentBundleService (no changes)
  10. = ContentService (no changes)
  11. CreativeService (0 new, 1 changed, 0 removed)
    1. type Creative
      1. + field adBadgingEnabled
  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, 2 changed, 0 removed)
    1. type ProposalLineItem
      1. field isProgrammatic
      2. field timeZoneId
    2. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  20. InventoryService (0 new, 1 changed, 0 removed)
    1. enum AdSenseAccountError.Reason
      1. + value CANNOT_ACCESS_INVALID_ACCOUNT
      2. + value ACCOUNT_ACCESS_DENIED
  21. = LabelService (no changes)
  22. LineItemCreativeAssociationService (0 new, 1 changed, 0 removed)
    1. enum AdSenseAccountError.Reason
      1. + value CANNOT_ACCESS_INVALID_ACCOUNT
      2. + value ACCOUNT_ACCESS_DENIED
  23. LineItemService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  24. = LineItemTemplateService (no changes)
  25. LiveStreamEventService (0 new, 1 changed, 0 removed)
    1. type LiveStreamEvent
      1. + field podServingSegmentDuration
  26. = MobileApplicationService (no changes)
  27. NativeStyleService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  28. NetworkService (0 new, 1 changed, 0 removed)
    1. enum McmError.Reason
      1. + value REVENUE_SHARE_PERCENT_OUTSIDE_RANGE
      2. + value RESELLER_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT
      3. + value MI_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT
      4. + value CHILD_NETWORK_DISAPPROVED
      5. + value MANAGE_INVENTORY_UNSUPPORTED_IN_RESELLER_NETWORK
      6. + value CANNOT_SEND_INVITATION_TO_MCM_PARENT
      7. + value CANNOT_SEND_INVITATION_TO_NETWORK_WITH_RESELLER_PARENT
      8. + value CANNOT_SEND_INVITATION_TO_SELF
      9. + value CANNOT_CLOSE_MCM_WITH_ACTIVE_CHILDREN
      10. + value CANNOT_TURN_CHILD_INTO_PARENT_WITH_ACTIVE_INVITATION
      11. + value MISSING_NETWORK_EXCHANGE_ACCOUNT
  29. = OrderService (no changes)
  30. = PlacementService (no changes)
  31. ProposalLineItemService (0 new, 2 changed, 0 removed)
    1. type ProposalLineItem
      1. field isProgrammatic
      2. field timeZoneId
    2. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  32. ProposalService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  33. PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
  34. ReportService (0 new, 2 changed, 0 removed)
    1. enum Column
      1. + value ACTIVE_VIEW_PERCENT_AUDIBLE_START_IMPRESSIONS
      2. + value ACTIVE_VIEW_PERCENT_EVER_AUDIBLE_IMPRESSIONS
    2. enum Dimension
      1. + value VIDEO_PLCMT
      2. + value VIDEO_PLCMT_NAME
      3. value VIDEO_METADATA_KEY_ID
      4. value VIDEO_METADATA_KEY_NAME
      5. value VIDEO_PLACEMENT_NAME
  35. = SegmentPopulationService (no changes)
  36. SiteService (0 new, 2 changed, 0 removed)
    1. enum AdSenseAccountError.Reason
      1. + value CANNOT_ACCESS_INVALID_ACCOUNT
      2. + value ACCOUNT_ACCESS_DENIED
    2. type Site
      1. + field approvalStatusUpdateTime
  37. = StreamActivityMonitorService (no changes)
  38. = SuggestedAdUnitService (no changes)
  39. TargetingPresetService (1 new, 2 changed, 0 removed)
    1. + operation performTargetingPresetAction
    2. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting
    3. operation performTargetingPresetAction
      1. + parameter filterStatement
      2. + response rval
      3. + parameter targetingPresetAction
  40. = TeamService (no changes)
  41. = UserService (no changes)
  42. = UserTeamAssociationService (no changes)
  43. YieldGroupService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field contentLabelTargeting
      2. + field verticalTargeting