Reminder: v201705 will be sunset on May 31, 2018.

Release Notes

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

v201802

What's New

Line Items
  • Removed creativePersistenceType from Line Items, impacting LineItemService and ForecastService.
  • Added a lineItemType for Preferred Deals, which allows offering inventory to specific buyers.
Reports
PQL
  • Added PpidSize column to Audience_Segment PQL table for determining the number of unique viewers in a segment.
  • Added EnabledForPreferredDeals and EnabledForProgrammaticGuaranteed columns to Programmatic_Buyer PQL table for determining which types a deals a buyer has enabled.
Creatives

API Changes

  1. = ActivityGroupService (no changes)
  2. = ActivityService (no changes)
  3. = AdExclusionRuleService (no changes)
  4. = AdRuleService (no changes)
  5. AudienceSegmentService (0 new, 1 changed, 0 removed)
    1. type AudienceSegment
      1. + field ppidSize
  6. = BaseRateService (no changes)
  7. = CdnConfigurationService (no changes)
  8. = CompanyService (no changes)
  9. = ContactService (no changes)
  10. = ContentBundleService (no changes)
  11. = ContentMetadataKeyHierarchyService (no changes)
  12. ContentService (0 new, 2 changed, 0 removed)
    1. type Content
      1. + field dashIngestErrors
      2. + field dashIngestStatus
      3. + field hlsIngestErrors
      4. + field hlsIngestStatus
      5. + field lastDashIngestDateTime
      6. + field lastHlsIngestDateTime
      7. field daiIngestErrors
      8. field daiIngestStatus
      9. field lastDaiIngestDateTime
    2. enum VodIngestError
      1. + value AC3_SPLIT_ERROR
      2. + value AC3_PARSE_ERROR
      3. + value EAC3_SPLIT_ERROR
      4. + value INVALID_ENCRYPTION_KEY
      5. + value EAC3_PARSE_ERROR
  13. CreativeService (0 new, 2 changed, 2 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
    2. enum CreativePolicyViolation
      1. + value DOWNLOAD_PROMPT_IN_CREATIVE
      2. + value UNAUTHORIZED_COOKIE_DETECTED
    3. type VpaidLinearCreative
    4. type VpaidLinearRedirectCreative
  14. CreativeSetService (0 new, 1 changed, 0 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
  15. = CreativeTemplateService (no changes)
  16. = CreativeWrapperService (no changes)
  17. CustomFieldService (0 new, 1 changed, 0 removed)
    1. enum CustomFieldEntityType
      1. value USER
  18. = CustomTargetingService (no changes)
  19. = ExchangeRateService (no changes)
  20. ForecastService (0 new, 4 changed, 0 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
    2. type LineItemSummary
      1. field creativePersistenceType
    3. enum LineItemType
      1. + value PREFERRED_DEAL
    4. type ProposalLineItem
      1. + field estimatedMinimumImpressions
  21. = InventoryService (no changes)
  22. = LabelService (no changes)
  23. LineItemCreativeAssociationService (0 new, 1 changed, 0 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
  24. LineItemService (0 new, 3 changed, 0 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
    2. type LineItemSummary
      1. field creativePersistenceType
    3. enum LineItemType
      1. + value PREFERRED_DEAL
  25. LineItemTemplateService (0 new, 2 changed, 0 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
    2. enum LineItemType
      1. + value PREFERRED_DEAL
  26. = LiveStreamEventService (no changes)
  27. = MobileApplicationService (no changes)
  28. = NativeStyleService (no changes)
  29. = NetworkService (no changes)
  30. OrderService (0 new, 1 changed, 0 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
  31. = PackageService (no changes)
  32. = PlacementService (no changes)
  33. = PremiumRateService (no changes)
  34. = ProductPackageItemService (no changes)
  35. = ProductPackageService (no changes)
  36. ProductService (1 new, 1 changed, 0 removed)
    1. + type PreferredDealError
    2. enum LineItemType
      1. + value PREFERRED_DEAL
  37. ProductTemplateService (1 new, 4 changed, 0 removed)
    1. + type PreferredDealError
    2. type Content
      1. + field dashIngestErrors
      2. + field dashIngestStatus
      3. + field hlsIngestErrors
      4. + field hlsIngestStatus
      5. + field lastDashIngestDateTime
      6. + field lastHlsIngestDateTime
      7. field daiIngestErrors
      8. field daiIngestStatus
      9. field lastDaiIngestDateTime
    3. enum LineItemType
      1. + value PREFERRED_DEAL
    4. type ProductSegmentation
      1. + field mobileApplicationSegment
      2. + field operatingSystemVersionSegment
      3. + field sizeSegment
    5. enum VodIngestError
      1. + value AC3_SPLIT_ERROR
      2. + value AC3_PARSE_ERROR
      3. + value EAC3_SPLIT_ERROR
      4. + value INVALID_ENCRYPTION_KEY
      5. + value EAC3_PARSE_ERROR
  38. ProposalLineItemService (1 new, 3 changed, 0 removed)
    1. + type PreferredDealError
    2. enum LineItemType
      1. + value PREFERRED_DEAL
    3. type ProposalLineItem
      1. + field estimatedMinimumImpressions
    4. enum ProposalLineItemProgrammaticError.Reason
      1. + value MIX_GUARANTEED_AND_PREFERRED_DEAL_NOT_ALLOWED
  39. ProposalService (2 new, 3 changed, 0 removed)
    1. + type BuyerRfp
    2. + enum RfpType
    3. type BuyerRfp
      1. + field rfpType
    4. type Proposal
      1. + field buyerRfp
      2. + field hasBuyerRfp
    5. enum ProposalLineItemProgrammaticError.Reason
      1. + value MIX_GUARANTEED_AND_PREFERRED_DEAL_NOT_ALLOWED
  40. PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. enum CreativeError.Reason
      1. + value INVALID_SIZE_FOR_THIRD_PARTY_IMPRESSION_TRACKER
  41. = RateCardService (no changes)
  42. = ReconciliationLineItemReportService (no changes)
  43. = ReconciliationOrderReportService (no changes)
  44. = ReconciliationReportRowService (no changes)
  45. = ReconciliationReportService (no changes)
  46. ReportService (2 new, 4 changed, 0 removed)
    1. + type CurrencyCodeError
    2. + enum TimeZoneSelection
    3. enum Dimension
      1. + value YIELD_GROUP_ID
      2. + value YIELD_GROUP_NAME
      3. + value YIELD_GROUP_BUYER_NAME
      4. + value YIELD_GROUP_BUYER_TAG_NAME
      5. + value REQUEST_TYPE
      6. + value DEMAND_CHANNEL_ID
      7. + value DEMAND_CHANNEL_NAME
    4. enum DimensionAttribute
      1. + value PROPOSAL_LINE_ITEM_TYPE
    5. type QuerySpecDto
      1. + field timeZoneSelection
    6. type ReportQuery
      1. + field reportCurrency
      2. + field timeZoneSelection
      3. field useSalesLocalTimeZone
  47. = SuggestedAdUnitService (no changes)
  48. = TeamService (no changes)
  49. UserService (0 new, 1 changed, 0 removed)
    1. type User
      1. field customFieldValues
  50. = UserTeamAssociationService (no changes)
  51. = WorkflowRequestService (no changes)

v201711

What's New

Please note that Ad Exchange historical reports will be run in the Pacific timezone in v201711. This will allow you to report on Bid and Deals metrics. If you need to continue running Ad Exchange historical reports in your network timezone, please stay on v201708. Future versions will support both options.

Creatives
Ad Units
  • Added support for fluid sizes with isFluid field.
Video
  • Added CdnConfigurationService to support managing CDN configurations. A CdnConfiguration encapsulates information about where and how to ingest and deliver content enabled for DAI (Dynamic Ad Insertion).
  • Added startDateTimeType to LiveStreamEvents to support creating events that start immediately.
  • Added support for HLS settings in LiveStreamEvents.
Reporting

API Changes

  1. + CdnConfigurationService
  2. = ActivityGroupService (no changes)
  3. = ActivityService (no changes)
  4. = AdExclusionRuleService (no changes)
  5. = AdRuleService (no changes)
  6. = AudienceSegmentService (no changes)
  7. = BaseRateService (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, 3 changed, 1 removed)
    1. type CustomCreative
      1. + field thirdPartyImpressionTrackingUrls
    2. type InternalRedirectCreative
      1. + field thirdPartyImpressionTrackingUrls
    3. type ThirdPartyCreative
      1. + field thirdPartyImpressionTrackingUrls
    4. type LegacyDfpMobileCreative
  14. = CreativeSetService (no changes)
  15. = CreativeTemplateService (no changes)
  16. CreativeWrapperService (0 new, 1 changed, 0 removed)
    1. type CreativeWrapper
      1. + field ampBody
      2. + field ampHead
  17. = CustomFieldService (no changes)
  18. = CustomTargetingService (no changes)
  19. = ExchangeRateService (no changes)
  20. ForecastService (0 new, 2 changed, 0 removed)
    1. type LineItemSummary
      1. + field programmaticCreativeSource
    2. type ProposalLineItem
      1. + field programmaticCreativeSource
  21. InventoryService (0 new, 1 changed, 0 removed)
    1. type AdUnit
      1. + field isFluid
  22. = LabelService (no changes)
  23. LineItemCreativeAssociationService (2 new, 2 changed, 0 removed)
    1. + type CreativeNativeStylePreview
    2. + operation getPreviewUrlsForNativeStyles
    3. enum CreativePreviewError.Reason
      1. + value CANNOT_GENERATE_PREVIEW_URL_FOR_NATIVE_CREATIVES
    4. operation getPreviewUrlsForNativeStyles
      1. + parameter creativeId
      2. + parameter lineItemId
      3. + response rval
      4. + parameter siteUrl
  24. LineItemService (0 new, 1 changed, 0 removed)
    1. type LineItemSummary
      1. + field programmaticCreativeSource
  25. = LineItemTemplateService (no changes)
  26. LiveStreamEventService (9 new, 6 changed, 0 removed)
    1. + type CdnConfiguration
    2. + enum CdnConfigurationType
    3. + type HlsSettings
    4. + type LiveStreamEventCdnSettingsError
    5. + type MediaLocationSettings
    6. + enum PlaylistType
    7. + type SecurityPolicySettings
    8. + enum SecurityPolicyType
    9. + type SourceContentConfiguration
    10. type CdnConfiguration
      1. + field cdnConfigurationType
      2. + field sourceContentConfiguration
    11. type HlsSettings
      1. + field playlistType
    12. type LiveStreamEvent
      1. + field hlsSettings
      2. + field sourceContentConfigurations
      3. + field startDateTimeType
      4. field authenticationKey
      5. field authenticationService
      6. field originForwardingType
      7. field originPathPrefix
      8. field tokenAuthenticationUnsigned
    13. type MediaLocationSettings
      1. + field securityPolicy
    14. type SecurityPolicySettings
      1. + field securityPolicyType
    15. type SourceContentConfiguration
      1. + field defaultDeliverySettings
      2. + field ingestSettings
  27. = MobileApplicationService (no changes)
  28. = NativeStyleService (no changes)
  29. = NetworkService (no changes)
  30. = OrderService (no changes)
  31. = PackageService (no changes)
  32. = PlacementService (no changes)
  33. = PremiumRateService (no changes)
  34. = ProductPackageItemService (no changes)
  35. = ProductPackageService (no changes)
  36. = ProductService (no changes)
  37. = ProductTemplateService (no changes)
  38. ProposalLineItemService (0 new, 2 changed, 0 removed)
    1. type ProposalLineItem
      1. + field programmaticCreativeSource
    2. enum ProposalLineItemProgrammaticError.Reason
      1. + value CANNOT_UPDATE_PROGRAMMATIC_CREATIVE_SOURCE
  39. ProposalService (0 new, 1 changed, 0 removed)
    1. enum ProposalLineItemProgrammaticError.Reason
      1. + value CANNOT_UPDATE_PROGRAMMATIC_CREATIVE_SOURCE
  40. = PublisherQueryLanguageService (no changes)
  41. = RateCardService (no changes)
  42. = ReconciliationLineItemReportService (no changes)
  43. = ReconciliationOrderReportService (no changes)
  44. = ReconciliationReportRowService (no changes)
  45. = ReconciliationReportService (no changes)
  46. ReportService (0 new, 2 changed, 0 removed)
    1. enum Column
      1. + value PARTNER_MANAGEMENT_PARTNER_IMPRESSIONS
      2. + value PARTNER_MANAGEMENT_PARTNER_CLICKS
      3. + value PARTNER_MANAGEMENT_PARTNER_CTR
      4. + value PARTNER_MANAGEMENT_GROSS_REVENUE
      5. + value PARTNER_FINANCE_HOST_IMPRESSIONS
      6. + value PARTNER_FINANCE_HOST_REVENUE
      7. + value PARTNER_FINANCE_HOST_ECPM
      8. + value PARTNER_FINANCE_PARTNER_REVENUE
      9. + value PARTNER_FINANCE_PARTNER_ECPM
      10. + value PARTNER_FINANCE_GROSS_REVENUE
      11. value PARTNER_MANAGEMENT_HOST_REVENUE
      12. value PARTNER_MANAGEMENT_HOST_ECPM
      13. value PARTNER_MANAGEMENT_PARTNER_REVENUE
      14. value PARTNER_MANAGEMENT_PARTNER_ECPM
    2. enum Dimension
      1. + value PARTNER_MANAGEMENT_ASSIGNMENT_ID
      2. + value PARTNER_MANAGEMENT_ASSIGNMENT_NAME
  47. = SuggestedAdUnitService (no changes)
  48. = TeamService (no changes)
  49. = UserService (no changes)
  50. = UserTeamAssociationService (no changes)
  51. = WorkflowRequestService (no changes)

v201708

What's New

Creatives
Sales Management
Reporting

API Changes

  1. ActivityGroupService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  2. ActivityService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  3. AdExclusionRuleService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  4. AdRuleService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  5. AudienceSegmentService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  6. BaseRateService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  7. CompanyService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  8. ContactService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  9. ContentBundleService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  10. ContentMetadataKeyHierarchyService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  11. ContentService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  12. CreativeService (1 new, 3 changed, 0 removed)
    1. + enum SkippableAdType
    2. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    3. type BaseVideoCreative
      1. + field skippableAdType
    4. type VideoRedirectCreative
      1. + field mezzanineFile
  13. CreativeSetService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  14. CreativeTemplateService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  15. CreativeWrapperService (0 new, 2 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. type CreativeWrapper
      1. + field htmlFooter
      2. + field htmlHeader
      3. field footer
      4. field header
  16. CustomFieldService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  17. CustomTargetingService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  18. ExchangeRateService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  19. ForecastService (1 new, 1 changed, 0 removed)
    1. + enum SkippableAdType
    2. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  20. InventoryService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  21. LabelService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  22. LineItemCreativeAssociationService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  23. LineItemService (1 new, 1 changed, 0 removed)
    1. + enum SkippableAdType
    2. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  24. LineItemTemplateService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  25. LiveStreamEventService (0 new, 2 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. type LiveStreamEvent
      1. + field adHolidayDuration
      2. + field defaultAdBreakDuration
      3. + field enableDurationlessAdBreaks
  26. MobileApplicationService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  27. NativeStyleService (0 new, 2 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. enum NativeStyleError.Reason
      1. + value TOO_MANY_CUSTOM_TARGETING_KEY_VALUES
  28. NetworkService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  29. OrderService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  30. PackageService (0 new, 3 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. enum ProposalError.Reason
      1. + value COMPANY_CREDIT_STATUS_NOT_ACTIVE
    3. enum ProposalLineItemError.Reason
      1. + value DISPLAY_ENVIRONMENT_MUST_HAVE_EXCLUDED_MOBILE_APPS_TARGETING
      2. + value MOBILE_ENVIRONMENT_MUST_HAVE_INCLUDED_MOBILE_APPS_TARGETING
  31. PlacementService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  32. PremiumRateService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  33. ProductPackageItemService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  34. ProductPackageService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  35. ProductService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  36. ProductTemplateService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  37. ProposalLineItemService (0 new, 3 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. enum ProposalError.Reason
      1. + value COMPANY_CREDIT_STATUS_NOT_ACTIVE
    3. enum ProposalLineItemError.Reason
      1. + value DISPLAY_ENVIRONMENT_MUST_HAVE_EXCLUDED_MOBILE_APPS_TARGETING
      2. + value MOBILE_ENVIRONMENT_MUST_HAVE_INCLUDED_MOBILE_APPS_TARGETING
  38. ProposalService (0 new, 3 changed, 1 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. enum ProposalError.Reason
      1. + value COMPANY_CREDIT_STATUS_NOT_ACTIVE
    3. enum ProposalLineItemError.Reason
      1. + value DISPLAY_ENVIRONMENT_MUST_HAVE_EXCLUDED_MOBILE_APPS_TARGETING
      2. + value MOBILE_ENVIRONMENT_MUST_HAVE_INCLUDED_MOBILE_APPS_TARGETING
    4. type SyncProposalsWithMarketplace
  39. PublisherQueryLanguageService (0 new, 2 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. enum ChangeHistoryEntityType
      1. + value BASE_RATE
      2. + value PREMIUM_RATE
      3. + value PRODUCT
      4. + value PRODUCT_PACKAGE
      5. + value PRODUCT_PACKAGE_ITEM
      6. + value PRODUCT_TEMPLATE
      7. + value PROPOSAL
      8. + value PROPOSAL_LINK
      9. + value PROPOSAL_LINE_ITEM
      10. + value PACKAGE
      11. + value RATE_CARD
      12. + value WORKFLOW
  40. RateCardService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  41. ReconciliationLineItemReportService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  42. ReconciliationOrderReportService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  43. ReconciliationReportRowService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  44. ReconciliationReportService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  45. ReportService (0 new, 4 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. enum Column
      1. value AD_SERVER_IMPRESSIONS_OUT_OF_NETWORK
      2. value AD_SERVER_CLICKS_OUT_OF_NETWORK
      3. value AD_SERVER_CTR_OUT_OF_NETWORK
      4. value TOTAL_DYNAMIC_ALLOCATION_IMPRESSIONS_OUT_OF_NETWORK
      5. value AD_EXCHANGE_AD_ECPM_LEGACY
      6. value TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS_INCLUDING_OUT_OF_NETWORK_DELIVERY
      7. value TOTAL_UNFILLED_IMPRESSIONS_INCLUDING_OUT_OF_NETWORK_DELIVERY
    3. enum DateRangeType
      1. + value LAST_3_MONTHS
    4. enum Dimension
      1. value AD_EXCHANGE_BID_TYPE
  46. SuggestedAdUnitService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  47. TeamService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  48. UserService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  49. UserTeamAssociationService (0 new, 1 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
  50. WorkflowRequestService (0 new, 2 changed, 0 removed)
    1. enum AuthenticationError.Reason
      1. + value UNDER_INVESTIGATION
    2. enum WorkflowRequestError.Reason
      1. value TYPE_REQUIRED

v201705

What's New

Inventory
Placements
Native Styles
Teams
Roles
  • Added Role.status field to expose the active/inactive status of roles.
Creatives
Partner Management
Reporting
  • Major changes to DFP support for AdX reporting, v201705 brings complete feature parity to the AdX API.
  • Removed references to VAST version in error metrics, the new convention is VIDEO_ERRORS_VAST_ERROR_[CODE]_COUNT.
  • Added Active View average viewable time metrics.
  • Changed reporting of local sales metrics in CSV_DUMP format to micros with ISO code making automated parsing easier. For example: USD 3900000 is $3.9 (USD).

API Changes

  1. ActivityGroupService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  2. ActivityService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  3. AdExclusionRuleService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  4. AdRuleService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  5. AudienceSegmentService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  6. BaseRateService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  7. CompanyService (0 new, 5 changed, 0 removed)
    1. enum Company.Type
      1. + value PARTNER
      2. value AFFILIATE_DISTRIBUTION_PARTNER
      3. value CONTENT_PARTNER
    2. enum CrossSellError.Reason
      1. value UNSUPPORTED_RESERVATION_TYPE
      2. value NO_VALID_ELIGIBLE_RESERVATION_TYPES
    3. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    4. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    5. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  8. ContactService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  9. ContentBundleService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  10. ContentMetadataKeyHierarchyService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  11. ContentService (0 new, 4 changed, 2 removed)
    1. type ContentPartnerError
      1. field reason
    2. enum ContentPartnerError.Reason
      1. value INVALID_PARTNER_TYPE
      2. value NO_PARTNER_CATCH_ALL
    3. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    4. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    5. type ContentPartnerError
    6. enum ContentPartnerError.Reason
  12. CreativeService (0 new, 3 changed, 0 removed)
    1. type Html5Creative
      1. field isInterstitial
    2. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  13. CreativeSetService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  14. CreativeTemplateService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  15. CreativeWrapperService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  16. CustomFieldService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  17. CustomTargetingService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  18. ExchangeRateService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  19. ForecastService (0 new, 4 changed, 0 removed)
    1. enum CrossSellError.Reason
      1. value UNSUPPORTED_RESERVATION_TYPE
      2. value NO_VALID_ELIGIBLE_RESERVATION_TYPES
    2. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    4. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  20. FreeEditingService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  21. InventoryService (0 new, 9 changed, 7 removed)
    1. type AdUnit
      1. + field adSenseSettings
      2. + field adSenseSettingsSource
      3. field crossSellingDistributor
      4. field inheritedAdSenseSettings
      5. field isSharedByDistributor
      6. field mobilePlatform
      7. field partnerId
    2. type AdUnitTypeError
      1. field reason
    3. enum AdUnitTypeError.Reason
      1. value MOBILE_APP_PLATFORM_NOT_VALID
    4. enum CrossSellError.Reason
      1. value UNSUPPORTED_RESERVATION_TYPE
      2. value NO_VALID_ELIGIBLE_RESERVATION_TYPES
    5. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    6. type InventoryUnitPartnerAssociationError
      1. field reason
    7. enum InventoryUnitPartnerAssociationError.Reason
      1. value ANCESTOR_AD_UNIT_HAS_PARTNER_ASSOCIATION
      2. value DESCENDANT_AD_UNIT_HAS_PARTNER_ASSOCIATION
      3. value NO_PARTNER_CATCH_ALL
    8. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    9. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
    10. type AdUnitTypeError
    11. enum AdUnitTypeError.Reason
    12. type AssignAdUnitsToPlacement
    13. type CrossSellingDistributor
    14. type InventoryUnitPartnerAssociationError
    15. enum InventoryUnitPartnerAssociationError.Reason
    16. type RemoveAdUnitsFromPlacement
  22. LabelService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  23. LineItemCreativeAssociationService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  24. LineItemService (0 new, 4 changed, 0 removed)
    1. enum CrossSellError.Reason
      1. value UNSUPPORTED_RESERVATION_TYPE
      2. value NO_VALID_ELIGIBLE_RESERVATION_TYPES
    2. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    4. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  25. LineItemTemplateService (0 new, 4 changed, 0 removed)
    1. enum CrossSellError.Reason
      1. value UNSUPPORTED_RESERVATION_TYPE
      2. value NO_VALID_ELIGIBLE_RESERVATION_TYPES
    2. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    4. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  26. LiveStreamEventService (1 new, 3 changed, 0 removed)
    1. + enum OriginForwardingType
    2. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    3. type LiveStreamEvent
      1. + field originForwardingType
      2. + field originPathPrefix
    4. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  27. MobileApplicationService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  28. NativeStyleService (0 new, 3 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. type NativeStyle
      1. + field status
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  29. NetworkService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  30. OrderService (0 new, 4 changed, 0 removed)
    1. enum CrossSellError.Reason
      1. value UNSUPPORTED_RESERVATION_TYPE
      2. value NO_VALID_ELIGIBLE_RESERVATION_TYPES
    2. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    4. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  31. PackageService (0 new, 3 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    3. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  32. PlacementService (0 new, 4 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. type Placement
      1. field adSenseTargetingLocale
      2. field isAdSenseTargetingEnabled
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    4. type SiteTargetingInfo
      1. field targetingAdLocation
      2. field targetingDescription
      3. field targetingSiteName
  33. PremiumRateService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  34. ProductPackageItemService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  35. ProductPackageService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  36. ProductService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  37. ProductTemplateService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  38. ProposalLineItemService (0 new, 3 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    3. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  39. ProposalService (0 new, 3 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    3. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  40. PublisherQueryLanguageService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  41. RateCardService (0 new, 3 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    3. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  42. ReconciliationLineItemReportService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  43. ReconciliationOrderReportService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  44. ReconciliationReportRowService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  45. ReconciliationReportService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  46. ReportService (0 new, 5 changed, 0 removed)
    1. enum Column
      1. + value AD_EXCHANGE_AD_IMPRESSIONS_ADJUSTED
      2. + value AD_EXCHANGE_AD_ECPM
      3. + value AD_EXCHANGE_VIDEO_DROPOFF_RATE_ADX_QT
      4. + value AD_EXCHANGE_VIDEO_ABANDONMENT_RATE_ADX_QT
      5. + value AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE
      6. + value AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE
      7. + value AD_EXCHANGE_AVERAGE_VIEWABLE_TIME
      8. + value AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS
      9. + value AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS
      10. + value AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS
      11. + value AD_EXCHANGE_AD_ECPM_LEGACY
      12. + value AD_EXCHANGE_DEALS_BID_RESPONSES
      13. + value AD_EXCHANGE_DEALS_MATCHED_REQUESTS
      14. + value AD_EXCHANGE_DEALS_AD_REQUESTS
      15. + value AD_EXCHANGE_DEALS_MATCH_RATE
      16. + value TOTAL_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME
      17. + value AD_SERVER_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME
      18. + value ADSENSE_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME
      19. + value AD_EXCHANGE_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME
      20. value AD_EXCHANGE_IMPRESSIONS
      21. value AD_EXCHANGE_VIEWED_QUERIES
      22. value AD_EXCHANGE_VIDEO_DROPOFF_RATE
      23. value AD_EXCHANGE_VIDEO_ABANDONMENT_RATE
      24. value AD_EXCHANGE_ACTIVE_VIEW_MEASUREABLE_RATE
      25. value AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_RATE
      26. value AD_EXCHANGE_VIDEO_FILL_RATE
      27. value AD_EXCHANGE_THIRD_PARTY_DISCREPANCY
      28. value AD_EXCHANGE_THIRD_PARTY_EARNINGS
      29. value AD_EXCHANGE_THIRD_PARTY_ECPM
      30. value AD_EXCHANGE_THIRD_PARTY_PASSBACKS
      31. value AD_EXCHANGE_THIRD_PARTY_IMPRESSIONS
      32. value AD_EXCHANGE_IMPRESSIONS_INCLUDING_THIRD_PARTY
      33. value VIDEO_ERRORS_VAST_2_ERROR_COUNT
    2. enum Dimension
      1. + value AD_EXCHANGE_INVENTORY_SIZE_CODE
      2. + value AD_EXCHANGE_PRODUCT_CODE
      3. + value AD_EXCHANGE_BRAND_NAME
      4. + value AD_EXCHANGE_BID_TYPE_CODE
      5. + value AD_EXCHANGE_BRANDING_TYPE_LOCAL
      6. + value AD_EXCHANGE_BUYER_NETWORK_ID
      7. + value AD_EXCHANGE_CUSTOM_CHANNEL_CODE
      8. + value AD_EXCHANGE_CUSTOM_CHANNEL_ID
      9. + value AD_EXCHANGE_DFP_AD_UNIT_ID
      10. + value AD_EXCHANGE_DFP_AD_UNIT
      11. + value AD_EXCHANGE_TARGETING_TYPE_LOCAL
      12. + value AD_EXCHANGE_TRANSACTION_TYPE_CODE
      13. + value AD_EXCHANGE_AD_LOCATION
      14. + value AD_EXCHANGE_ADVERTISER_VERTICAL
      15. value AD_EXCHANGE_TRANSACTION_TYPE_NAME
      16. value AD_EXCHANGE_DEAL_CPM
      17. value AD_EXCHANGE_THIRD_PARTY_BUYER_ACCOUNT_NAME
      18. value AD_EXCHANGE_THIRD_PARTY_NETWORK_TAG_CURRENCY
      19. value AD_EXCHANGE_THIRD_PARTY_NETWORK_TAG_NAME
    3. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    4. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    5. enum ReportError.Reason
      1. + value START_DATE_MORE_THAN_THREE_YEARS_AGO
      2. value DIMENSION_COMBINATION_NOT_ALLOWED
  47. SuggestedAdUnitService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
  48. TeamService (5 new, 5 changed, 0 removed)
    1. + type ActivateTeams
    2. + type DeactivateTeams
    3. + type TeamAction
    4. + enum TeamStatus
    5. + operation performTeamAction
    6. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    7. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    8. type Team
      1. + field status
    9. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
    10. operation performTeamAction
      1. + parameter filterStatement
      2. + response rval
      3. + parameter teamAction
  49. UserService (1 new, 4 changed, 0 removed)
    1. + enum RoleStatus
    2. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    3. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    4. type Role
      1. + field status
    5. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  50. UserTeamAssociationService (0 new, 3 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT
    3. enum TeamError.Reason
      1. + value CANNOT_UPDATE_INACTIVE_TEAM
  51. WorkflowRequestService (0 new, 2 changed, 0 removed)
    1. enum InternalApiError.Reason
      1. + value ERROR_GENERATING_RESPONSE
    2. enum QuotaError.Reason
      1. + value REPORT_JOB_LIMIT

Send feedback about...

DoubleClick for Publishers API
DoubleClick for Publishers API
Need help? Visit our support page.