Release Notes

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

v201905

What's New

Targeting
Programmatic
Creatives
Reporting

API Changes

  1. + TargetingPresetService
  2. = ActivityGroupService (no changes)
  3. = ActivityService (no changes)
  4. = AdExclusionRuleService (no changes)
  5. = AdRuleService (no changes)
  6. AdjustmentService (0 new, 1 changed, 0 removed)
    1. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
  7. = AudienceSegmentService (no changes)
  8. = BaseRateService (no changes)
  9. = CdnConfigurationService (no changes)
  10. = CmsMetadataService (no changes)
  11. = CompanyService (no changes)
  12. = ContactService (no changes)
  13. = ContentBundleService (no changes)
  14. = ContentService (no changes)
  15. CreativeService (0 new, 2 changed, 0 removed)
    1. type Creative
      1. + field policyLabels
    2. type ImageCreative
      1. field lockedOrientation
  16. = CreativeSetService (no changes)
  17. = CreativeTemplateService (no changes)
  18. = CreativeWrapperService (no changes)
  19. = CustomFieldService (no changes)
  20. CustomTargetingService (1 new, 1 changed, 0 removed)
    1. + enum ReportableType
    2. type CustomTargetingKey
      1. + field reportableType
  21. = DaiAuthenticationKeyService (no changes)
  22. = ExchangeRateService (no changes)
  23. ForecastService (1 new, 2 changed, 0 removed)
    1. + type LineItemDealInfoDto
    2. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
    3. type LineItemSummary
      1. + field dealInfo
  24. = InventoryService (no changes)
  25. = LabelService (no changes)
  26. = LineItemCreativeAssociationService (no changes)
  27. LineItemService (1 new, 2 changed, 0 removed)
    1. + type LineItemDealInfoDto
    2. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
    3. type LineItemSummary
      1. + field dealInfo
  28. LineItemTemplateService (0 new, 1 changed, 0 removed)
    1. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
  29. = LiveStreamEventService (no changes)
  30. = MobileApplicationService (no changes)
  31. = NativeStyleService (no changes)
  32. = NetworkService (no changes)
  33. OrderService (0 new, 1 changed, 0 removed)
    1. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
  34. = PackageService (no changes)
  35. = PlacementService (no changes)
  36. = PremiumRateService (no changes)
  37. = ProductPackageItemService (no changes)
  38. = ProductPackageService (no changes)
  39. ProductService (0 new, 1 changed, 0 removed)
    1. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
  40. ProductTemplateService (0 new, 1 changed, 0 removed)
    1. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
  41. ProposalLineItemService (0 new, 1 changed, 0 removed)
    1. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
  42. ProposalService (3 new, 1 changed, 0 removed)
    1. + enum NegotiationRole
    2. + type PauseProposals
    3. + type ResumeProposals
    4. type ProposalMarketplaceInfo
      1. + field pauseReason
      2. + field pausedBy
  43. = PublisherQueryLanguageService (no changes)
  44. = RateCardService (no changes)
  45. = ReconciliationLineItemReportService (no changes)
  46. = ReconciliationOrderReportService (no changes)
  47. = ReconciliationReportRowService (no changes)
  48. = ReconciliationReportService (no changes)
  49. ReportService (0 new, 2 changed, 0 removed)
    1. enum Dimension
      1. + value CUSTOM_DIMENSION
    2. type ReportQuery
      1. + field customDimensionKeyIds
  50. = SuggestedAdUnitService (no changes)
  51. TargetingService (0 new, 1 changed, 0 removed)
    1. enum DateTimeRangeTargetingError.Reason
      1. + value FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
      2. + value LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
  52. = TeamService (no changes)
  53. = UserService (no changes)
  54. = UserTeamAssociationService (no changes)
  55. = WorkflowRequestService (no changes)

v201902

What's New

Adjustment
AdRule
CmsMetadata
LineItem
LiveStreamEvent
Reporting

API Changes

  1. + AdjustmentService
  2. + CmsMetadataService
  3. = ActivityGroupService (no changes)
  4. = ActivityService (no changes)
  5. AdExclusionRuleService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  6. AdRuleService (3 new, 4 changed, 0 removed)
    1. + type Subpod
    2. + type SubpodPage
    3. + operation getSubpodsByStatement
    4. type SubpodPage
      1. + field results
    5. enum VideoPosition.Type
      1. + value ALL
    6. type VideoPositionTarget
      1. + field videoSubpodId
    7. operation getSubpodsByStatement
      1. + parameter filterStatement
      2. + response rval
  7. AudienceSegmentService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  8. BaseRateService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  9. = CdnConfigurationService (no changes)
  10. = CompanyService (no changes)
  11. = ContactService (no changes)
  12. = ContentBundleService (no changes)
  13. = ContentService (no changes)
  14. CreativeService (0 new, 2 changed, 0 removed)
    1. enum CreativePolicyViolation
      1. + value CIRCUMVENTING_SYSTEMS
    2. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  15. CreativeSetService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  16. = CreativeTemplateService (no changes)
  17. = CreativeWrapperService (no changes)
  18. CustomFieldService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  19. CustomTargetingService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  20. = DaiAuthenticationKeyService (no changes)
  21. = ExchangeRateService (no changes)
  22. ForecastService (1 new, 7 changed, 0 removed)
    1. + enum DeliveryForecastSource
    2. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    3. type GrpSettings
      1. + field enableNielsenCoViewingSupport
    4. enum LineItemError.Reason
      1. + value CANNOT_ACCESS_CUSTOM_PACING_CURVE_CLOUD_STORAGE_BUCKET
    5. type LineItemSummary
      1. + field childContentEligibility
      2. + field deliveryForecastSource
    6. enum VideoPosition.Type
      1. + value ALL
    7. type VideoPositionTarget
      1. + field videoSubpodId
    8. enum VideoPositionTargetingError.Reason
      1. + value CAN_ONLY_TARGET_CUSTOM_AD_SPOTS
  23. InventoryService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  24. LabelService (0 new, 2 changed, 0 removed)
    1. type Label
      1. + field adCategory
    2. enum LabelType
      1. + value CANONICAL_CATEGORY
  25. LineItemCreativeAssociationService (0 new, 2 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    2. enum LineItemError.Reason
      1. + value CANNOT_ACCESS_CUSTOM_PACING_CURVE_CLOUD_STORAGE_BUCKET
  26. LineItemService (2 new, 8 changed, 0 removed)
    1. + enum DeliveryForecastSource
    2. + operation hasCustomPacingCurve
    3. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    4. type GrpSettings
      1. + field enableNielsenCoViewingSupport
    5. enum LineItemError.Reason
      1. + value CANNOT_ACCESS_CUSTOM_PACING_CURVE_CLOUD_STORAGE_BUCKET
    6. type LineItemSummary
      1. + field childContentEligibility
      2. + field deliveryForecastSource
    7. enum VideoPosition.Type
      1. + value ALL
    8. type VideoPositionTarget
      1. + field videoSubpodId
    9. enum VideoPositionTargetingError.Reason
      1. + value CAN_ONLY_TARGET_CUSTOM_AD_SPOTS
    10. operation hasCustomPacingCurve
      1. + parameter lineItemId
      2. + response rval
  27. LineItemTemplateService (0 new, 3 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    2. enum LineItemError.Reason
      1. + value CANNOT_ACCESS_CUSTOM_PACING_CURVE_CLOUD_STORAGE_BUCKET
    3. enum VideoPositionTargetingError.Reason
      1. + value CAN_ONLY_TARGET_CUSTOM_AD_SPOTS
  28. LiveStreamEventService (3 new, 2 changed, 0 removed)
    1. + type MasterPlaylistSettings
    2. + type RefreshLiveStreamEventMasterPlaylists
    3. + enum RefreshType
    4. type HlsSettings
      1. + field masterPlaylistSettings
    5. type MasterPlaylistSettings
      1. + field refreshType
  29. = MobileApplicationService (no changes)
  30. NativeStyleService (0 new, 2 changed, 0 removed)
    1. enum VideoPosition.Type
      1. + value ALL
    2. type VideoPositionTarget
      1. + field videoSubpodId
  31. = NetworkService (no changes)
  32. OrderService (0 new, 3 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    2. enum LineItemError.Reason
      1. + value CANNOT_ACCESS_CUSTOM_PACING_CURVE_CLOUD_STORAGE_BUCKET
    3. enum VideoPositionTargetingError.Reason
      1. + value CAN_ONLY_TARGET_CUSTOM_AD_SPOTS
  33. PackageService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  34. PlacementService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  35. PremiumRateService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  36. ProductPackageItemService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  37. ProductPackageService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  38. ProductService (0 new, 3 changed, 0 removed)
    1. enum VideoPosition.Type
      1. + value ALL
    2. type VideoPositionTarget
      1. + field videoSubpodId
    3. enum VideoPositionTargetingError.Reason
      1. + value CAN_ONLY_TARGET_CUSTOM_AD_SPOTS
  39. ProductTemplateService (0 new, 4 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    2. enum VideoPosition.Type
      1. + value ALL
    3. type VideoPositionTarget
      1. + field videoSubpodId
    4. enum VideoPositionTargetingError.Reason
      1. + value CAN_ONLY_TARGET_CUSTOM_AD_SPOTS
  40. ProposalLineItemService (0 new, 5 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    2. enum LineItemError.Reason
      1. + value CANNOT_ACCESS_CUSTOM_PACING_CURVE_CLOUD_STORAGE_BUCKET
    3. enum VideoPosition.Type
      1. + value ALL
    4. type VideoPositionTarget
      1. + field videoSubpodId
    5. enum VideoPositionTargetingError.Reason
      1. + value CAN_ONLY_TARGET_CUSTOM_AD_SPOTS
  41. ProposalService (0 new, 3 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
    2. enum VideoPosition.Type
      1. + value ALL
    3. type VideoPositionTarget
      1. + field videoSubpodId
  42. PublisherQueryLanguageService (0 new, 2 changed, 0 removed)
    1. enum VideoPosition.Type
      1. + value ALL
    2. type VideoPositionTarget
      1. + field videoSubpodId
  43. RateCardService (0 new, 1 changed, 0 removed)
    1. enum EntityLimitReachedError.Reason
      1. + value ACTIVE_LINE_ITEMS_LIMIT_REACHED
  44. = ReconciliationLineItemReportService (no changes)
  45. = ReconciliationOrderReportService (no changes)
  46. = ReconciliationReportRowService (no changes)
  47. = ReconciliationReportService (no changes)
  48. ReportService (0 new, 2 changed, 0 removed)
    1. enum Column
      1. + value DP_CLICKS
      2. value AD_SERVER_INVENTORY_LEVEL_PERCENT_IMPRESSIONS
      3. value AD_SERVER_INVENTORY_LEVEL_PERCENT_CLICKS
      4. value AD_SERVER_INVENTORY_LEVEL_WITHOUT_CPD_PERCENT_REVENUE
      5. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_IMPRESSIONS
      6. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_CLICKS
      7. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_CTR
      8. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_REVENUE
      9. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_AVERAGE_ECPM
      10. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_PERCENT_IMPRESSIONS
      11. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_PERCENT_CLICKS
      12. value DYNAMIC_ALLOCATION_INVENTORY_LEVEL_WITHOUT_CPD_PERCENT_REVENUE
      13. value TOTAL_INVENTORY_LEVEL_IMPRESSIONS
      14. value TOTAL_INVENTORY_LEVEL_CLICKS
      15. value TOTAL_INVENTORY_LEVEL_CTR
      16. value TOTAL_INVENTORY_LEVEL_CPM_AND_CPC_REVENUE
      17. value TOTAL_INVENTORY_LEVEL_WITHOUT_CPD_AVERAGE_ECPM
    2. enum Dimension
      1. + value PROGRAMMATIC_CHANNEL_ID
      2. + value PROGRAMMATIC_CHANNEL
      3. + value DP_DEAL_ID
      4. + value DP_APP_ID
      5. value BUYER_ID
      6. value BUYER_NAME
  49. = SuggestedAdUnitService (no changes)
  50. = TeamService (no changes)
  51. = UserService (no changes)
  52. = UserTeamAssociationService (no changes)
  53. = WorkflowRequestService (no changes)

v201811

What's New

Global
  • Standardized the capitalization of DateTime.timeZoneId. In previous versions, the capitalization was timeZoneID.
ContentMetadataKeyHierarchy
Creatives
Reporting
Targeting

API Changes

  1. = ActivityGroupService (no changes)
  2. = ActivityService (no changes)
  3. = AdExclusionRuleService (no changes)
  4. AdRuleService (1 new, 3 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    3. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
    4. type Targeting
      1. + field dateTimeRangeTargeting
  5. AudienceSegmentService (0 new, 1 changed, 0 removed)
    1. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
  6. = BaseRateService (no changes)
  7. = CdnConfigurationService (no changes)
  8. = CompanyService (no changes)
  9. = ContactService (no changes)
  10. = ContentBundleService (no changes)
  11. ContentMetadataKeyHierarchyService (0 new, 34 changed, 67 removed)
    1. type ApiError
      1. field fieldPathElements
    2. type ApiException
      1. field errors
    3. type ApiVersionError
      1. field reason
    4. type AuthenticationError
      1. field reason
    5. type CollectionSizeError
      1. field reason
    6. type CommonError
      1. field reason
    7. type ContentMetadataKeyHierarchy
      1. field hierarchyLevels
      2. field status
    8. type ContentMetadataKeyHierarchyError
      1. field reason
    9. type ContentMetadataKeyHierarchyPage
      1. field results
    10. type DateTime
      1. field date
    11. type DateTimeValue
      1. field value
    12. type DateValue
      1. field value
    13. type FeatureError
      1. field reason
    14. type InternalApiError
      1. field reason
    15. type LocalizedErrorWrapper
      1. field wrapped
    16. type NotNullError
      1. field reason
    17. type ParseError
      1. field reason
    18. type PermissionError
      1. field reason
    19. type PublisherQueryLanguageContextError
      1. field reason
    20. type PublisherQueryLanguageSyntaxError
      1. field reason
    21. type QuotaError
      1. field reason
    22. type RequiredCollectionError
      1. field reason
    23. type RequiredError
      1. field reason
    24. type RequiredNumberError
      1. field reason
    25. type ServerError
      1. field reason
    26. type SetValue
      1. field values
    27. type StatementError
      1. field reason
    28. type StringFormatError
      1. field reason
    29. type StringLengthError
      1. field reason
    30. type String_ValueMapEntry
      1. field value
    31. operation createContentMetadataKeyHierarchies
      1. parameter contentMetadataKeyHierarchies
      2. response rval
    32. operation getContentMetadataKeyHierarchiesByStatement
      1. parameter filterStatement
      2. response rval
    33. operation performContentMetadataKeyHierarchyAction
      1. parameter contentMetadataKeyHierarchyAction
      2. parameter filterStatement
      3. response rval
    34. operation updateContentMetadataKeyHierarchies
      1. parameter contentMetadataKeyHierarchies
      2. response rval
    35. type ApiError
    36. type ApiException
    37. type ApiVersionError
    38. enum ApiVersionError.Reason
    39. type ApplicationException
    40. type AuthenticationError
    41. enum AuthenticationError.Reason
    42. type BooleanValue
    43. type CollectionSizeError
    44. enum CollectionSizeError.Reason
    45. type CommonError
    46. enum CommonError.Reason
    47. type ContentMetadataKeyHierarchy
    48. type ContentMetadataKeyHierarchyAction
    49. type ContentMetadataKeyHierarchyError
    50. enum ContentMetadataKeyHierarchyError.Reason
    51. type ContentMetadataKeyHierarchyLevel
    52. type ContentMetadataKeyHierarchyPage
    53. enum ContentMetadataKeyHierarchyStatus
    54. type Date
    55. type DateTime
    56. type DateTimeValue
    57. type DateValue
    58. type DeleteContentMetadataKeyHierarchies
    59. type FeatureError
    60. enum FeatureError.Reason
    61. type FieldPathElement
    62. type InternalApiError
    63. enum InternalApiError.Reason
    64. type NotNullError
    65. enum NotNullError.Reason
    66. type NumberValue
    67. type ObjectValue
    68. type ParseError
    69. enum ParseError.Reason
    70. type PermissionError
    71. enum PermissionError.Reason
    72. type PublisherQueryLanguageContextError
    73. enum PublisherQueryLanguageContextError.Reason
    74. type PublisherQueryLanguageSyntaxError
    75. enum PublisherQueryLanguageSyntaxError.Reason
    76. type QuotaError
    77. enum QuotaError.Reason
    78. type RequiredCollectionError
    79. enum RequiredCollectionError.Reason
    80. type RequiredError
    81. enum RequiredError.Reason
    82. type RequiredNumberError
    83. enum RequiredNumberError.Reason
    84. type ServerError
    85. enum ServerError.Reason
    86. type SetValue
    87. type Statement
    88. type StatementError
    89. enum StatementError.Reason
    90. type StringFormatError
    91. enum StringFormatError.Reason
    92. type StringLengthError
    93. enum StringLengthError.Reason
    94. type TextValue
    95. type UniqueError
    96. type UpdateResult
    97. type Value
    98. operation createContentMetadataKeyHierarchies
    99. operation getContentMetadataKeyHierarchiesByStatement
    100. operation performContentMetadataKeyHierarchyAction
    101. operation updateContentMetadataKeyHierarchies
  12. = ContentService (no changes)
  13. CreativeService (0 new, 2 changed, 0 removed)
    1. enum CreativePolicyViolation
      1. + value ABUSIVE_EXPERIENCE
    2. type ProgrammaticCreative
      1. field isSafeFrameCompatible
  14. = CreativeSetService (no changes)
  15. = CreativeTemplateService (no changes)
  16. = CreativeWrapperService (no changes)
  17. = CustomFieldService (no changes)
  18. CustomTargetingService (0 new, 1 changed, 0 removed)
    1. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
  19. = DaiAuthenticationKeyService (no changes)
  20. = ExchangeRateService (no changes)
  21. ForecastService (1 new, 4 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum AdUnitCodeError.Reason
      1. + value INVALID_CHARACTERS_FOR_LEGACY_AD_EXCHANGE_TAG
    3. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    4. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
    5. type Targeting
      1. + field dateTimeRangeTargeting
  22. InventoryService (0 new, 1 changed, 0 removed)
    1. enum AdUnitCodeError.Reason
      1. + value INVALID_CHARACTERS_FOR_LEGACY_AD_EXCHANGE_TAG
  23. = LabelService (no changes)
  24. = LineItemCreativeAssociationService (no changes)
  25. LineItemService (1 new, 3 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    3. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
    4. type Targeting
      1. + field dateTimeRangeTargeting
  26. LineItemTemplateService (0 new, 2 changed, 0 removed)
    1. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    2. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
  27. = LiveStreamEventService (no changes)
  28. = MobileApplicationService (no changes)
  29. NativeStyleService (1 new, 2 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
    3. type Targeting
      1. + field dateTimeRangeTargeting
  30. = NetworkService (no changes)
  31. OrderService (0 new, 2 changed, 0 removed)
    1. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    2. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
  32. PackageService (0 new, 1 changed, 0 removed)
    1. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
  33. = PlacementService (no changes)
  34. = PremiumRateService (no changes)
  35. = ProductPackageItemService (no changes)
  36. = ProductPackageService (no changes)
  37. ProductService (1 new, 3 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    3. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
    4. type Targeting
      1. + field dateTimeRangeTargeting
  38. ProductTemplateService (1 new, 3 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    3. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
    4. type Targeting
      1. + field dateTimeRangeTargeting
  39. ProposalLineItemService (1 new, 4 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum ContentMetadataTargetingError.Reason
      1. + value CONTENT_METADATA_TARGETING_DEPRECATED
    3. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY
    4. enum ProposalLineItemProgrammaticError.Reason
      1. + value INVALID_MAX_VIDEO_CREATIVE_DURATION
    5. type Targeting
      1. + field dateTimeRangeTargeting
  40. ProposalService (1 new, 2 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum ProposalLineItemProgrammaticError.Reason
      1. + value INVALID_MAX_VIDEO_CREATIVE_DURATION
    3. type Targeting
      1. + field dateTimeRangeTargeting
  41. PublisherQueryLanguageService (1 new, 2 changed, 0 removed)
    1. + type DateTimeRangeTargeting
    2. enum AdUnitCodeError.Reason
      1. + value INVALID_CHARACTERS_FOR_LEGACY_AD_EXCHANGE_TAG
    3. type Targeting
      1. + field dateTimeRangeTargeting
  42. = RateCardService (no changes)
  43. = ReconciliationLineItemReportService (no changes)
  44. = ReconciliationOrderReportService (no changes)
  45. = ReconciliationReportRowService (no changes)
  46. = ReconciliationReportService (no changes)
  47. ReportService (0 new, 2 changed, 0 removed)
    1. enum Column
      1. value AD_SERVER_DOWNLOADED_IMPRESSIONS
    2. enum Dimension
      1. + value DP_WEEK
      2. + value DP_MONTH_YEAR
      3. + value DP_TAG_ID
  48. = SuggestedAdUnitService (no changes)
  49. = TeamService (no changes)
  50. = UserService (no changes)
  51. = UserTeamAssociationService (no changes)
  52. WorkflowRequestService (0 new, 1 changed, 0 removed)
    1. enum CustomTargetingError.Reason
      1. + value INVALID_VALUE_FOR_KEY

v201808

What's New

Line Items
  • Added RequestPlatformTargeting which provides line items the ability to target the platform that requests and renders the ad (BROWSER, MOBILE_APP, or VIDEO_PLAYER).
Proposal Line Items
Forecasting
  • Added the ability to call getAvailabilityForecast passing a ProposalLineItem as the ProspectiveLineItem.
  • Added enhanced breakdown features to the ForecastService, including the ability to break forecasts down by time windows and by any targeting configuration.
  • Added isAmpOnly field to CreativePlaceholders, which signifies if the expected creative of this placeholder has an AMP-only variant.
Reporting
  • Added support for “Demand product” reports.
    • New Dimensions are DP_DATE, DP_COUNTRY_CRITERIA_ID, DP_COUNTRY_NAME, DP_INVENTORY_TYPE, DP_CREATIVE_SIZE, DP_BRAND_NAME, DP_ADVERTISER_NAME, DP_ADX_BUYER_NETWORK_NAME, DP_MOBILE_DEVICE_NAME, and DP_DEVICE_CATEGORY_NAME.
    • New Columns are DP_IMPRESSIONS, DP_QUERIES, DP_COST, and DP_MATCHED_QUERIES.
  • Removed deprecated Column AD_SERVER_CODE_SERVED_COUNT.
  • Removed deprecated Column AD_REQUEST_SIZE.
  • Removed deprecated Dimension VERIFIED_ADVERTISER_ID.
  • Removed deprecated Dimension VERIFIED_ADVERTISER_NAME.

API Changes

  1. = ActivityGroupService (no changes)
  2. = ActivityService (no changes)
  3. AdExclusionRuleService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  4. AdRuleService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field requestPlatformTargeting
  5. AudienceSegmentService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  6. BaseRateService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  7. = CdnConfigurationService (no changes)
  8. = CompanyService (no changes)
  9. = ContactService (no changes)
  10. = ContentBundleService (no changes)
  11. = ContentMetadataKeyHierarchyService (no changes)
  12. = ContentService (no changes)
  13. CreativeService (0 new, 2 changed, 0 removed)
    1. enum CreativePolicyViolation
      1. + value TEMPORARY_PAUSE_FOR_VENDOR_INVESTIGATION
    2. enum LineItemCreativeAssociationError.Reason
      1. + value UNSUPPORTED_CREAIVE_VAST_REDIRECT_TYPE
      2. + value UNSUPPORTED_YOUTUBE_HOSTED_CREATIVE
      3. + value CLICK_MACROS_REQUIRED
      4. + value VIEW_MACROS_NOT_ALLOWED
  14. = CreativeSetService (no changes)
  15. = CreativeTemplateService (no changes)
  16. = CreativeWrapperService (no changes)
  17. = CustomFieldService (no changes)
  18. CustomTargetingService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  19. = DaiAuthenticationKeyService (no changes)
  20. = ExchangeRateService (no changes)
  21. ForecastService (5 new, 11 changed, 0 removed)
    1. + type BreakdownForecast
    2. + type ForecastBreakdown
    3. + type ForecastBreakdownEntry
    4. + type ForecastBreakdownOptions
    5. + type ForecastBreakdownTarget
    6. enum AdExchangeEnvironment
      1. + value MOBILE_OUTSTREAM_VIDEO
      2. + value DISPLAY_OUTSTREAM_VIDEO
    7. type AvailabilityForecast
      1. + field breakdowns
    8. type AvailabilityForecastOptions
      1. + field breakdown
    9. type CreativePlaceholder
      1. + field isAmpOnly
    10. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    11. type ForecastBreakdown
      1. + field breakdownEntries
    12. type ForecastBreakdownEntry
      1. + field forecast
    13. type ForecastBreakdownOptions
      1. + field targets
    14. enum LineItemCreativeAssociationError.Reason
      1. + value UNSUPPORTED_CREAIVE_VAST_REDIRECT_TYPE
      2. + value UNSUPPORTED_YOUTUBE_HOSTED_CREATIVE
      3. + value CLICK_MACROS_REQUIRED
      4. + value VIEW_MACROS_NOT_ALLOWED
    15. type ProspectiveLineItem
      1. + field proposalLineItem
    16. type Targeting
      1. + field requestPlatformTargeting
  22. InventoryService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  23. = LabelService (no changes)
  24. LineItemCreativeAssociationService (0 new, 2 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    2. enum LineItemCreativeAssociationError.Reason
      1. + value UNSUPPORTED_CREAIVE_VAST_REDIRECT_TYPE
      2. + value UNSUPPORTED_YOUTUBE_HOSTED_CREATIVE
      3. + value CLICK_MACROS_REQUIRED
      4. + value VIEW_MACROS_NOT_ALLOWED
  25. LineItemService (0 new, 4 changed, 0 removed)
    1. type CreativePlaceholder
      1. + field isAmpOnly
    2. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    3. enum LineItemCreativeAssociationError.Reason
      1. + value UNSUPPORTED_CREAIVE_VAST_REDIRECT_TYPE
      2. + value UNSUPPORTED_YOUTUBE_HOSTED_CREATIVE
      3. + value CLICK_MACROS_REQUIRED
      4. + value VIEW_MACROS_NOT_ALLOWED
    4. type Targeting
      1. + field requestPlatformTargeting
  26. LineItemTemplateService (0 new, 2 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    2. enum LineItemCreativeAssociationError.Reason
      1. + value UNSUPPORTED_CREAIVE_VAST_REDIRECT_TYPE
      2. + value UNSUPPORTED_YOUTUBE_HOSTED_CREATIVE
      3. + value CLICK_MACROS_REQUIRED
      4. + value VIEW_MACROS_NOT_ALLOWED
  27. LiveStreamEventService (2 new, 1 changed, 0 removed)
    1. + type LiveStreamEventDvrWindowError
    2. + enum LiveStreamEventDvrWindowError.Reason
    3. type LiveStreamEventDvrWindowError
      1. + field reason
  28. = MobileApplicationService (no changes)
  29. NativeStyleService (0 new, 2 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    2. type Targeting
      1. + field requestPlatformTargeting
  30. = NetworkService (no changes)
  31. OrderService (0 new, 2 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    2. enum LineItemCreativeAssociationError.Reason
      1. + value UNSUPPORTED_CREAIVE_VAST_REDIRECT_TYPE
      2. + value UNSUPPORTED_YOUTUBE_HOSTED_CREATIVE
      3. + value CLICK_MACROS_REQUIRED
      4. + value VIEW_MACROS_NOT_ALLOWED
  32. PackageService (0 new, 2 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    2. enum ProposalError.Reason
      1. + value UNSUPPORTED_BUYER_CURRENCY_CODE
      2. + value NEW_TRADITIONAL_ONLY_PROPOSAL_NOT_ALLOWED
  33. PlacementService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  34. PremiumRateService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  35. ProductPackageItemService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  36. ProductPackageService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  37. ProductService (0 new, 4 changed, 0 removed)
    1. enum AdExchangeEnvironment
      1. + value MOBILE_OUTSTREAM_VIDEO
      2. + value DISPLAY_OUTSTREAM_VIDEO
    2. type CreativePlaceholder
      1. + field isAmpOnly
    3. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    4. type Targeting
      1. + field requestPlatformTargeting
  38. ProductTemplateService (0 new, 4 changed, 0 removed)
    1. enum AdExchangeEnvironment
      1. + value MOBILE_OUTSTREAM_VIDEO
      2. + value DISPLAY_OUTSTREAM_VIDEO
    2. type CreativePlaceholder
      1. + field isAmpOnly
    3. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    4. type Targeting
      1. + field requestPlatformTargeting
  39. ProposalLineItemService (0 new, 6 changed, 0 removed)
    1. enum AdExchangeEnvironment
      1. + value MOBILE_OUTSTREAM_VIDEO
      2. + value DISPLAY_OUTSTREAM_VIDEO
    2. type CreativePlaceholder
      1. + field isAmpOnly
    3. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    4. enum ProposalError.Reason
      1. + value UNSUPPORTED_BUYER_CURRENCY_CODE
      2. + value NEW_TRADITIONAL_ONLY_PROPOSAL_NOT_ALLOWED
    5. enum ProposalLineItemProgrammaticError.Reason
      1. + value BUYER_DISABLED_FOR_PG_VIOLATING_SLA
    6. type Targeting
      1. + field requestPlatformTargeting
  40. ProposalService (0 new, 6 changed, 0 removed)
    1. enum AdExchangeEnvironment
      1. + value MOBILE_OUTSTREAM_VIDEO
      2. + value DISPLAY_OUTSTREAM_VIDEO
    2. type CreativePlaceholder
      1. + field isAmpOnly
    3. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
    4. enum ProposalError.Reason
      1. + value UNSUPPORTED_BUYER_CURRENCY_CODE
      2. + value NEW_TRADITIONAL_ONLY_PROPOSAL_NOT_ALLOWED
    5. enum ProposalLineItemProgrammaticError.Reason
      1. + value BUYER_DISABLED_FOR_PG_VIOLATING_SLA
    6. type Targeting
      1. + field requestPlatformTargeting
  41. PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. type Targeting
      1. + field requestPlatformTargeting
  42. RateCardService (0 new, 1 changed, 0 removed)
    1. enum EntityChildrenLimitReachedError.Reason
      1. + value TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED
  43. = ReconciliationLineItemReportService (no changes)
  44. = ReconciliationOrderReportService (no changes)
  45. = ReconciliationReportRowService (no changes)
  46. = ReconciliationReportService (no changes)
  47. ReportService (0 new, 2 changed, 0 removed)
    1. enum Column
      1. + value DP_IMPRESSIONS
      2. + value DP_QUERIES
      3. + value DP_MATCHED_QUERIES
      4. + value DP_COST
      5. value AD_SERVER_CODE_SERVED_COUNT
    2. enum Dimension
      1. + value DP_DATE
      2. + value DP_COUNTRY_CRITERIA_ID
      3. + value DP_COUNTRY_NAME
      4. + value DP_INVENTORY_TYPE
      5. + value DP_CREATIVE_SIZE
      6. + value DP_BRAND_NAME
      7. + value DP_ADVERTISER_NAME
      8. + value DP_ADX_BUYER_NETWORK_NAME
      9. + value DP_MOBILE_DEVICE_NAME
      10. + value DP_DEVICE_CATEGORY_NAME
      11. value AD_REQUEST_SIZE
      12. value VERIFIED_ADVERTISER_ID
      13. value VERIFIED_ADVERTISER_NAME
  48. = SuggestedAdUnitService (no changes)
  49. = TeamService (no changes)
  50. = UserService (no changes)
  51. = UserTeamAssociationService (no changes)
  52. = WorkflowRequestService (no changes)

Send feedback about...

Ad Manager API
Ad Manager API
Need help? Visit our support page.