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.

• Latest version: v201905
• Previous versions: v201902, v201811, v201808

v201905

What's New

Targeting

• Added new TargetingPresetService to read TargetingPresets.

Programmatic

• Added support for reading deal IDs.
• Added PauseProposals and ResumeProposals actions.

Creatives

• Removed deprecated ImageCreative.lockedOrientation.

Reporting

• Added support for custom dimensions and configuring reporting options on CustomTargetingKeys.

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

• Added new AdjustmentService to manage traffic forecast adjustments.

AdRule

• Added getAdSpotsByStatement method to fetch AdSpots.

CmsMetadata

• Added new CmsMetadataService with methods for querying CMS metadata keys and values.

LineItem

• Added DeliveryForecastSource enumeration to allow LineItems to be paced based on their projected traffic instead of their historical traffic.
• Added ChildContentEligibility enumeration to help with COPPA compliance.
• Added CmsMetadataCriteria for targeting CMS metadata values alongside custom key-values and audience.
• Added VideoPositionTarget.adSpotId to target by AdSpot.

LiveStreamEvent

• Added RefreshLiveStreamEventMasterPlaylists action for refreshing the master playlists of LiveStreamEvent objects.

Reporting

• Added Dimensions PROGRAMMATIC_CHANNEL_ID and PROGRAMMATIC_CHANNEL_NAME for breaking up reports by the type of transaction that occurred in Ad Exchange.

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

• Removed the ContentMetadataKeyHierarchyService. You can continue to target video content with key‑values mapped from content metadata or content bundles.

Creatives

• Removed deprecated ProgrammaticCreative.isSafeFrameCompatible.

Reporting

• Removed deprecated Column AD_SERVER_DOWNLOADED_IMPRESSIONS. This metric has been the same as AD_SERVER_IMPRESSIONS for over a year.

Targeting

• Added DateTimeRangeTargeting for specifying time ranges in which to target ads.

• Added CONTENT_METADATA_TARGETING_DEPRECATED error since creating new LineItems with ContentMetadataKeyHierarchyTargeting is no longer allowed.
• Added INVALID_VALUE_FOR_KEY as a more descriptive error for CustomTargeting validations, including checks that the custom targeting key exists and that the value exists under the specified key.

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

• Added two new AdExchangeEnvironments: MOBILE_OUTSREAM_VIDEO and DISPLAY_OUTSTREAM_VIDEO.

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)