We're pleased to announce that v202302 of the Google Ad Manager API is available starting today, February 21st. This release brings a number of new features for Reporting including Yield Group metrics, Programmatic metrics, and time zone support.
For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.
- Chris Seeley, Ad Manager API Team
TravelAssetSuggestionService to suggest required assets (such as headlines, descriptions, long descriptions) that can be used to create asset groups in the Performance Max for travel goal campaigns. TravelAssetSuggestionService is available to a closed allowlist for now.Customer to track the migration status of location and image assets.SmartCampaignSettingService.GetSmartCampaignStatus.BatchJobMetadata.execution_limit_seconds to set the limit of execution in seconds. Batch jobs will be canceled if their execution time is longer than specified in this field.CombinedRuleUserListInfo and ExpressionRuleUserListInfo and their references in RuleBasedUserListInfo. Use FlexibleUserListInfo instead.ConversionUploadError.CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS will be thrown if you try to upload ClickConversion with user_identifiers set, but have not accepted the customer data terms.gbraid, conversion_action, and conversion_date_time on different days. Trying to do so will cause a ConversionUploadError.CLICK_CONVERSION_ALREADY_EXISTS error.Asset.field_type_policy_summaries.local_service_id.ProductLinkService for adding and removing a link between a Google Ads account and an account of another product.ResponsiveSearchAdAssetRecommendation.current_ad.ProductBiddingCategoryInfo.country_code.PreferredContentInfo and its reference from AdGroupBidModifier.TargetCpm.target_frequency_goal to support providing additional details about the goal of the Target CPM bidding strategy.
Thanet Knack Praneenararat, on behalf of the Google Ads API Team
- Ruizhi Liao, CM360 API Team
ImageCreative and other creative types replaced the string field thirdPartyImpressionTrackingUrl with the list field thirdPartyImpressionTrackingUrls. Currently only a single URL can be provided in the list. - Chris Seeley, Ad Manager API Team
RaiseTargetCpaBidTooLowRecommendation and ForecastingSetTargetRoasRecommendation.primary_status and primary_status_reasons to Campaign to provide insight into why a campaign is not serving or not serving optimally.conversion_tracking_id will always be greater than 0 for all customers. In the previous versions, this field could be 0 for customers who had never created any conversion actions.SmartCampaignSuggestService.SuggestKeywordThemes to generate more keyword theme suggestions for Smart campaigns, including free-form keyword themes.CampaignExperimentService in favor of the previously added new experiments.ReachPlanService.CampaignAsset and AdGroupAsset with the field_type: AD_IMAGE (Image assets).
Thanet Knack Praneenararat, on behalf of the Google Ads API Team
| Version | Planned Release Type* | Projected launch* | Projected sunset* |
|---|---|---|---|
| V13 | Major | January/February 2023 | January 2024 |
| V13_1 | Minor | April/May 2023 | January 2024 |
| V14 | Major | May/June 2023 | May 2024 |
| V14_1 | Minor | July/August 2023 | May 2024 |
| V15 | Major | September/October 2023 | September 2024 |
- David Stevens, Google Ads API Product ManagerWe’re pleased to announce that Display & Video 360 API v2 is available in public beta starting today. We're also extending our DV360 API Developer Survey through the end of September so that we can gather more customer feedback on v2 and the API in general.
v2 includes a number of new features and breaking changes. Here are some of the changes introduced in v2:
get and list methods in the advertisers.lineItems and advertisers.lineItems.targetingTypes.assignedTargetingOptions services. advertisers.lineItems.bulkListAssignedTargetingOptions and advertisers.lineItems.bulkEditAssignedTargetingOptions methods. lineItem.entityStatus field across multiple line items in a single request using the new advertisers.lineItems.bulkUpdate method. assignedTargetingOptionId values, enabling the retrieval, creation, and deletion of targeting settings with enums.More detailed information about this release can be found in our release notes. Follow the steps in our migration guide to migrate from v1 to v2. As it is in beta, be aware that we might make unversioned breaking changes to DV360 API v2 before it exits the beta phase.
If you want to provide feedback and recommend features that should be included in future versions of the API, please fill out our DV360 API Developer Survey. The survey has been extended through the end of September and will help shape the product roadmap for v2 and beyond.
If you run into issues or need help with these new features or samples, please contact us using our support contact form.
- Trevor Mulchay, Display & Video 360 API Team
UpgradeLocalCampaignToPerformanceMaxRecommendation to help you migrate from Local campaigns to Performance Max campaigns (more details).Campaign.bidding_strategy_system_status to show the system status of the bidding strategy. It’ll help you understand if the bidding strategy is learning, limited, or misconfigured, etc. This addresses a long standing feature request to surface learning status in the API.FlexibleRuleUserListInfo for creating user lists in a more flexible way. This is also a replacement for DateSpecificRuleUserListInfo that was removed in the previous release.GoogleAdsService.Mutate(). Previously, it was possible only when using ExperimentService.ReachPlanService.GenerateReachForecast.YouTubeSelectSettings when calling ReachPlanService.GenerateReachForecast.YouTubeSelectLineUp when calling ReachPlanService.ListPlannableProducts.
Thanet Knack Praneenararat, on behalf of the Google Ads API Team
We're pleased to announce that v202208 of the Google Ad Manager API is available starting today, August 16th. This release adds support for AMP URLs in ThirdPartyCreatives, InventorySizeTargeting in traffic forecasts, and Real-time video reporting.
For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.
orderBy query parameter for queries.list and queries.reports.list methods.queries.reports.get method.queries.run requests so that they return the resulting Report object instead of an empty response.Query and Report resources to use new named object types and enums. - Trevor Mulchay, Display & Video 360 API Team