Tag Archives: release

Announcing v8_1 of the Google Ads API

Today, we’re announcing the v8_1 release of the Google Ads API. To use some of the v8_1 features, you need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week. This version has no breaking changes.

Here’s what we added: Where can I learn more?
The following resources can get you started: If you have any questions or need additional help, contact us through the forum.
Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Google Ads API 2022 release and sunset schedule

We’re announcing our tentative 2022 release and sunset schedule for upcoming versions of the Google Ads API to bring greater clarity to your planning cycle. Please keep in mind that these dates are only estimates and may be adjusted going forward. Additionally, releases may be added, removed or switched between major and minor. Check back with our release notes and deprecation schedule for updates.

Note: The AdWords API will sunset in April 2022. Migrate all requests to the Google Ads API by then to continue managing your Google Ads accounts.
Version Planned Release
Type* 		Projected launch* Projected sunset*
v7 Major April 28, 2021 (launched) January/February 2022
v8 Major June 9, 2021 (launched) March/April 2022
v8_1 Minor August 2021 March/April 2022
v9 Major October 2021 June/July 2022
v10 Major February/March 2022 October/November 2022
v10_1 Minor April/May 2022 October/November 2022
v11 Major June/July 2022 March/April 2023
v11_1 Minor August/September 2022 March/April 2023
v12 Major October/November 2022 June/July 2023
*Estimated and subject to change
 Where can I learn more?
The following resources can help you with your development planning: If you have any questions or need additional help, contact us via the forum.
- David Stevens, Google Ads API Product Manager

Call Ads Replace Call Only Ads in the Google Ads API

In the Google Ads API v8, Call Only Ads are replaced by Call Ads. You can still create Call Only Ads in the AdWords API v201809 and the Google Ads API v6 and v7, but we encourage you to use v8 to create new Call Ads.

Call Only Ads will continue to serve until the AdWords API Sunset on 27 April 2022.

Prior to v8, Call Only Ads only offered users the ability to call. Users and advertisers have said they want the ability to go directly to the website from these ads. The addition of the final URL in Call Ads enables advertisers to use calls as the primary (i.e. headline) action, while still providing users with a means to visit an advertiser’s website prior to or instead of calling.

What you need to do
  • Use the ad type CallAd instead of CallOnlyAd to create new Call Ads.
  • Filter on ad.type = 'CALL_AD' to retrieve information for existing ads regardless of what ad.type was used to create the ad. For example, using the Google Ads API to query 

        SELECT ad_group_ad.ad.call_ad.country_code,
               ad_group_ad.ad.call_ad.phone_number
        FROM ad_group_ad
        WHERE ad_group_ad.ad.type = 'CALL_AD'
    will return ads created as CALL_ONLY_AD and CALL_AD.
What has changed
Fields added
ad_group_ad.ad.final_urls This is where you specify the URL of your website.
path1 First part of text that may appear appended to the url displayed in the ad.
path2 Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.
Field removed
ad.display_url We removed the display_url for Call Only Ads.
The URL that will be displayed alongside your
ad will now be based on ad_group.ad.final_urls
if provided, or phone_number_verification_url
if ad_group.ad.final_urls is blank, as well
any additional text you specify in path1 and path2.
Field verification
phone_number_verification_url This field is now required if ad_group.ad.final_urls is empty.

AdWords API Reporting: There is no change in the AdWords API.

Google Ads API Reporting: In the Google Ads API you can include these new fields in your queries
Where to get help
If you have questions about Call Ads, please reach out to us on the forum or at [email protected].

Bob Hancock, Google Ads API Team

Announcing v8 of the Google Ads API

Today, we’re announcing the v8 release of the Google Ads API. To use v8 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week. For more information on breaking changes, see the migration guide.
Here are the highlights: Where can I learn more?
The following resources can help you get started: If you have any questions or need additional help, contact us via the forum.
Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Announcing v3.5 of the Campaign Manager 360 API

Today we're releasing v3.5 of the Campaign Manager 360 API (previously DCM/DFA Reporting and Trafficking API). Highlights of this release include:

Details of these and all other changes are covered in our release notes.

Deprecation and sunset reminder

In accordance with our deprecation schedule, this release marks the beginning of the depreciation period for v3.4, which will sunset on Dec 24, 2021. After this date, any requests made against v3.4 will begin returning errors.

As a reminder, Campaign Manager 360 API v3.3 will sunset on June 30th, 2021. After this date, all requests made to v3.3 of this API will fail. If you're still using this version, you must migrate to the most current release to avoid an interruption in service.

See the migration guide for details. For most, migrating will be as easy as adopting the latest version of your preferred client library. However, all users are advised to review the release notes to learn about important version differences you may need to be aware of.

If you have questions about this or anything else Campaign Manager 360 API related, feel free to reach out to us on our support forum.

Learn More

As with every new version of the Campaign Manager 360 API, we encourage you to carefully review all changes in the release notes. For those of you looking to get going right away, updated client libraries are now available. If you're just starting out, the Get Started guide is a great reference to help you get up and running quickly.


Give it a try and let us know if you have any questions!

- Ruizhi Liao, CM360 API Team

Announcing v202105 of the Google Ad Manager API

We're happy to announce that v202105 of the Google Ad Manager API is available starting today. With this release, Creative Previews are going mobile! You can now push creatives to multiple linked devices using the new LineItemCreativeAsociationService.pushCreativeToDevices method and Linked_Device PQL table.

This release also brings support for pause controls for programmatic proposals and new ReportService features like Inventory Share dimensions.


For the full list of changes for v202105 and all other active API versions, 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

Announcing v7 of the Google Ads API

Today, we’re announcing the v7 release of the Google Ads API. To use the v7 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week. For more information on breaking changes, see the migration guide.

Here are the highlights:
  • We now have new assets that are available in test accounts:
    • Callout assets
    • Structured snippet assets
    • Sitelinks assets
  • The promotion assets we’ve added are available in production and test accounts.
  • The Google Ads API now supports reporting for Apple’s SKAdNetwork. This feature allows advertisers to query how many SKAdNetwork conversions they receive from their iOS apps as well as the SKAdNetwork conversion value of those conversions.
  • Keyword Planning now supports:
    • Refining keywords using annotation data
    • Selecting a custom date range for search volume
    • Requesting aggregate metrics for generated keyword ideas and for keywords in a keyword plan
  • We’ve added ad_group_ad_label and ad_group_criterion_label labels for easier filtering and selection.
  • You can now manage bidding strategy and campaign simulations.
  • We updated our resource exceeded errors to include more detail such as what type of limit was exceeded and how many resources are allowed by that limit.
  • You can now use marginal ROI campaign budget recommendations. This recommendation suggests adjusting a campaign's budget if we predict that its ROI will go up.
See the release notes for details and for more features.

Where can I learn more?
The following resources can help you get started: If you have any questions or need additional help, contact us via the forum.
Nadine Wang, Google Ads API Team

Announcing v2 of the AdSense Management API

We're happy to announce that v2 of the AdSense Management API is available starting today. This version adds the ability to fetch the status of sites on your account and aligns the AdSense Management API with current Google API standards.

At this time, v1.4 of the AdSense Management API is now deprecated, and it will sunset on October 12, 2021.

Notable changes from v1.4 to v2 include the following:
  • All deprecated methods in v1.4 have been removed in v2. This includes resource methods that did not specify an AdSense account.
  • Resources are now identified by a name field. For example, an AdClient’s name would be “accounts/{accountId}/adclients/{adClientId}”.
  • With v2, AdSense Management API reporting data now aligns with the AdSense UI. This means that AdMob and YouTube properties are no longer supported. If you need to continue to fetch AdMob data programmatically, please migrate to the AdMob API. Additionally, the AdSense Management API will only support report data going back 3 years.

For a full list of changes, see the release notes. As always, feel free to reach out to us on the AdSense API forum with any API-related questions.
 - , AdSense API Team

Announcing v202102 of the Google Ad Manager API

We're happy to announce that v202102 of the Google Ad Manager API is available starting today. Upgrade to this version to take advantage of new functionality, including CreativeSizeType.IGNORED for click-tracking entities, where size doesn't matter, or for entities that allow all requested sizes, where the size represents all sizes.

Additionally, there are several highly-requested report dimensions added in v202102.

Dimension name Report data break down
BROWSER_NAME Name and version number of the user's browser
VIDEO_PLACEMENT_NAME Video placement (e.g., in-article, in-stream, and in-feed)
CLASSIFIED_YIELD_PARTNER_NAME Detected yield partner name, as classified by Google
DOMAIN Top private domain, such as "example.co.uk" (excludes subdomains)


Finally, if you use the Ad Manager API to create video LineItems, v202102 now requires that LineItem.videoMaxDuration is greater than 0. This new validation applies to newly created video LineItems as well as updates. If you think you might be affected, you should update any code that creates video LineItems to set videoMaxDuration to be greater than 0 and scan your network for existing video LineItems with videoMaxDuration set to 0.

For the full list of changes for v202102 and all other active API versions, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.
 - , Ad Manager API Team

Announcing v202102 of the Google Ad Manager API

We're happy to announce that v202102 of the Google Ad Manager API is available starting today. Upgrade to this version to take advantage of new functionality, including CreativeSizeType.IGNORED for click-tracking entities, where size doesn't matter, or for entities that allow all requested sizes, where the size represents all sizes.

Additionally, there are several highly-requested report dimensions added in v202102.

Dimension name Report data break down
BROWSER_NAME Name and version number of the user's browser
VIDEO_PLACEMENT_NAME Video placement (e.g., in-article, in-stream, and in-feed)
CLASSIFIED_YIELD_PARTNER_NAME Detected yield partner name, as classified by Google
DOMAIN Top private domain, such as "example.co.uk" (excludes subdomains)


Finally, if you use the Ad Manager API to create video LineItems, v202102 now requires that LineItem.videoMaxDuration is greater than 0. This new validation applies to newly created video LineItems as well as updates. If you think you might be affected, you should update any code that creates video LineItems to set videoMaxDuration to be greater than 0 and scan your network for existing video LineItems with videoMaxDuration set to 0.

For the full list of changes for v202102 and all other active API versions, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.
 - , Ad Manager API Team