Google Ads Developer Blog: release

Upgrading to the newest version

forum

Nadine Wang, Google Ads API Team

Announcing v2 of the AdSense Management API

Monday, April 19, 2021

v2 of the AdSense Management APIthe status of sitesGoogle API standardsit will sunset on October 12, 2021

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.

release notesAdSense API forum

- Donovan McMurray, AdSense API Team

Announcing v202102 of the Google Ad Manager API

Thursday, February 18, 2021

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.

- Donovan McMurray, Ad Manager API Team

Announcing v6.1 of the Google Ads API

Wednesday, February 10, 2021

Google Ads APIclient libraries

Retrieving and managing recommendations for adding responsive search ads.

Added support for managing user invitations for a Google Ads account.

Added Feed, FeedItem, CampaignFeed, AdGroupFeed, and AdGroupAd resources to the list of resource types returned in queries against the change_event resource.

New conversion metrics by conversion date.

New call_view resource for reporting on call extensions and call only ads.

Where can I learn more?

forumJosh Radcliff, on behalf of the Google Ads API Team

Announcing new AdMob API methods and authorization scope

Thursday, November 19, 2020

Today we are announcing the launch of two new features in the AdMob API:

New admob.readonly OAuth 2.0 scope

Inventory methods including list apps and ad units

New OAuth 2.0 scope While the admob.report scope is only intended for reports, the new admob.readonly scope is intended for all read methods, including reports and inventory. We recommend using the admob.readonly scope as it can be used for all read only methods.

Scope

Functionality

https://www.googleapis.com/auth/admob.readonly

See all of your AdMob data. This may include your account information, inventory and mediation settings, reports, and other data. If you agree, this app will be allowed to see, but not make changes to your AdMob data. This doesn't include sensitive data, such as payments or campaign details.

https://www.googleapis.com/auth/admob.report

See ad performance and earnings reports.

See publisher ID, timezone and default currency code.

New methods We have added the following new methods to the v1beta AdMob API, which allow you to view your AdMob apps and ad units.

listApps

listAdUnits

How can I start using the new methods and scope? The beta is available to all AdMob users. You can start with the client libraries that we have created for you. Where can I learn more?

Get started with the AdMob API - Follow this guide to learn how to generate credentials and make your first request using the AdMob API.

Reference documentation - Read the page for detailed information on each REST method and its specific parameters.

Client Library Samples - Check out this page for code samples on how to make requests in Java and Python.

Feel free to reach out to us via the AdMob API forum if you have questions or feedback regarding the AdMob API.

- Amira Badreldin, AdMob API team

Announcing v202011 of the Google Ad Manager API

Tuesday, November 10, 2020

We're happy to announce that v202011 of the Google Ad Manager API is available starting today. Upgrade to this version to take advantage of new functionality, like support for Ad Speed reports. Now you can programmatically monitor ad speed, because fast ads matter to both you and your users.

This release also brings a new ForecastService method to let you explore historical and future impression opportunities. This is backed by the same data as your network's Traffic Forecast.

For the full list of changes for v202011 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 v6 of the Google Ads API

Monday, November 9, 2020

Google Ads APIclient librariesmigration guide

The API now has Change History similar to the Google Ads UI with ChangeEvent including what interface and who made the changes.

You can now manage user access in your Google Ads account.

Maximize conversion value and maximize conversions are now available as portfolio bidding strategies, which includes Search.

The new Customer.optimization_score_weight helps you calculate your overall optimization score for your manager account.

New audience types are available including CombinedAudience and CustomAudience.

Where can I learn more?

Upgrading to the newest version

forum

Nadine Wang, on behalf of the Google Ads API Team

Announcing the Google Ads API is out of beta

Monday, September 21, 2020

Google Ads APIBatch processingWhere can I learn more?

forumgoogleadsapi-support@google.com

Nadine Wang, on behalf of the Google Ads API Team

Announcing AdMob API v1 General Availability

Monday, August 31, 2020

Today we’re excited to announce the general availability v1 release of the new AdMob API. It allows publishers to programmatically get information on their AdMob account. The AdMob API v1 release offers the following benefits for app developers compared with the existing AdSense API used to access AdMob data:

Retrieve metrics that are consistent with how the AdMob UI defines and calculates them

Retrieve mediation reports previously not available through the AdSense API

How can I get started? The AdMob API is now available to all AdMob users. You can use the Getting Started guide and the client libraries to get started. If you’re already working with the AdSense API, please refer to our migration guide to get started. Please make plans to migrate to the new AdMob API, as we will sunset access to AdMob data via the AdSense API in the fall of 2021. If you have any questions, please contact us via the AdMob API Developer Forum. We will be able to provide suggestions on how to best migrate your workflow. We look forward to hearing your feedback.

- Amira Badreldin, AdMob API team

Announcing v5 of the Google Ads API beta

Wednesday, August 26, 2020

Google Ads API betaclient librariesmigration guide

Return metrics for entities not formally supported in the API, such as Discovery campaigns, are now available. These entities will show UNKNOWN enum values returned. See the release notes for more details.

New request parameter to opt into returning all mutable fields in the response during a mutate.

The API is moving towards using field presence such as optional string and optional double instead of wrapper types such as StringValue and DoubleValue. Your code will be easier to use and simplifies the API with payloads that are significantly smaller. Approximately half of our resources have been updated in this release. The full list is in the migration guide, and our code examples have been updated. The rest of the resources will change to field presence in a future release.

Subfields of AdGroupAd.policy_summary are now selectable. Non-repeated subfields of AdGroupAd.policy_summary are now filterable.

Support for Keyword Planner:

Added KeywordPlanKeywordHistoricalMetrics.close_variants to return the close variant keywords that have been merged to compute the historical metrics.
Added KeywordPlanService.GenerateForecastTimeSeries that returns the weekly forecast trend for Keyword Plan for the next 52 weeks.

Where can I learn more?

Upgrading to the newest version

forum

Nadine Wang, on behalf of the Google Ads API Team

Announcing v202008 of the Google Ad Manager API

Monday, August 24, 2020

v202008Audio AdsViewability Provider CompaniesLineItem

We’ve added nielsenCtvPacingType for specifying the pacing computation method for impressions on connected devices for a Nielsen measured LineItem.

You can now call the performCmsMetadataKeyAction to activate and deactivate CmsMetadataKeys.

For the full list of changes for v202008 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.

- Donovan McMurray, Ad Manager API Team

Announcing v4 of the Google Ads API beta

Wednesday, July 8, 2020

Today, we’re announcing the v4 release of the Google Ads API beta. To use the v4 features, update your client library. If you are upgrading from v1, v2, or v3, some of your code may require changes when you switch to the new v4 endpoint. For more information on breaking changes, see the migration guide. If you are using v1, upgrade by July 29, 2020.

Here are the highlights:

Local campaigns. Local campaigns streamline the process for you, making it easy to promote your stores across Google’s largest properties including the Google Search Network, Maps, YouTube, and the Google Display Network.
Support for retrieving and reporting on Smart campaigns.
Support for account-level optimization score.
Keyword Planning. See the Planning section in the release notes for details.
Linking third party app analytics accounts to Google Ads accounts. See the Account Management section in the release notes for details.

Where can I learn more?
The following resources can help you get going with the Google Ads API:

The updated client libraries and code examples will be published next week. If you have any questions or need additional help, contact us via the forum.

Nadine Wang, on behalf of the Google Ads API Team

Announcing Authorized Buyers’ new Real-Time Bidding API

Thursday, June 25, 2020

Today we are pleased to announce the release of Authorized Buyers’ Real-Time Bidding API. In addition, we are also announcing that all versions of the Ad Exchange Buyer API are now deprecated, and will sunset by the end of Q2, 2021. With the exception of the Budgets and PerformanceReport resources that are not being carried over to the new API, we recommend migrating to the Real-Time Bidding API’s equivalent resources well before the sunset to avoid interruptions to your integration. Note that this deprecation does not include the Ad Exchange Buyer II API, which will continue to be supported.

The Real-Time Bidding API currently includes resources for managing creatives and user lists, and will be expanded in Q4 to include resources for managing pretargeting. Additional updates through Q4 will add features for managing accounts and billing information. We recommend reading through the migration guide—which will be updated as new features are added to the Real-Time Bidding API—to learn more about getting started with the new API.

Feel free to reach out to us via the Authorized Buyers API forums if you have questions or feedback concerning the Real-Time Bidding API.

Mark Saniscalchi, Authorized Buyers Developer Relations

Announcing v202005 of the Google Ad Manager API

Thursday, May 14, 2020

We're happy to announce that v202005 of the Google Ad Manager API is available starting today. This version adds new functionality to several use cases, like managing video ads.

For video ads, v202005 allows you to set competitiveConstraintScope and thirdPartyMeasurementSettings on video LineItems. Also, you can now get the duration of video metadata Content for better targeting. Additionally, you can manage your CMS metadata values by marking them as active or inactive.

Another improvement that v202005 brings is that ActivityGroup.id, Activity.id, and Activity.activityGroupId fields have been changed from type int to type long. So if your API integration is strongly typed, be aware that you might need to make changes for this update.

This release also includes a number of Beta features, like reporting on Nielsen Digital Ad Ratings, creating Makegoods for ProposalLineItems, and managing child networks through Multiple Customer Management. For the full list of API changes for v202005 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.

- Donovan McMurray, Ad Manager API Team

Announcing v3_1 of the Google Ads API beta

Wednesday, April 29, 2020

Today we’re announcing the v3_1 release of the Google Ads API beta. To use the v3_1 features, please update your client library. If you are upgrading from v1 or v2, some of your code may require changes when you switch to the new v3 endpoint. Please see the migration guide for more information on breaking changes.

Here are the highlights:

Added support for retrieving campaign optimization score in Campaign.optimization_score.
Added new conversion action categories to ConversionActionCategory. See the release notes for details.
Added a new service OfflineUserDataJobService which supports asynchronous upload of Customer Match data and store sales (direct upload) data. These features are whitelisted.
Added support for retrieving the paying manager customer with PaymentsAccount.paying_manager_customer when making a request to PaymentsAccountService.ListPaymentsAccounts().

Where can I learn more?
The following resources can help you get going with the Google Ads API:

The updated client libraries and code examples will be published next week. If you have any questions or need additional help, please contact us via the forum.

Nadine Wang, on behalf of the Google Ads API Team

Join the beta for the new AdMob API

Thursday, April 2, 2020

Today we’re announcing the open beta release of the AdMob API v1. It offers a new and improved way to interact with AdMob reporting data programmatically. Built with app publishers in mind, the new AdMob API will replace the need for you to use the AdSense API and provide enhanced capabilities to query AdMob reporting data. For example, unlike the AdSense API that uses different definitions of certain ads metrics for app publishers, the AdMob API includes metrics that are consistent with the AdMob UI. The AdMob API v1 beta release offers the following benefits for app publishers:

Receive metrics that are more accurate and consistent with the AdMob UI.

Gain access to mediation reporting programmatically.

Integrate newer technologies like JSON REST into your product sooner.

We will continue to make improvements to the AdMob API and we encourage you to join the open beta now and provide feedback to influence the product roadmap before the general release. How can I join the beta? The beta is available to all AdMob users. You can start with the Getting Started guide or use the client libraries that we have created for you. Additional client library samples will be coming soon. Where can I learn more?