Google Ads Developer Blog

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

Introducing Publisher Ads Audits for Lighthouse v1.2.0

Friday, August 28, 2020

Today, we're announcing the general release of Publisher Ads Audits for Lighthouse v1.2.0. The major highlights of this release are:

A new cumulative ad shift metric
Support for auditing AMP pages (thanks to @adamsilverstein)
Updates to support Lighthouse 6.0

A number of smaller enhancements and bug fixes are also included. For complete details, see the changelog on GitHub.

Measuring the impact of ads on the user experience

The new cumulative ad shift metric is the first publisher ads audit aimed at measuring the impact of ads on Core Web Vitals metrics. In particular, this metric provides insight into how ads affect the stability of your page's layout. To learn more about how ads affect layout stability and steps you can take to address this, see our article on minimizing layout shift with GPT.

The APIs for measuring layout stability are new and still evolving, so it's not currently possible to attribute layout shifts to ads with 100% accuracy. We'll be updating this audit as these APIs mature, so scores may change over time.

Try it out and let us know what you think

Publisher Ads Audits v1.2.0 is available to use right now. You can try generating an updated report from the web app, or grab the latest CLI release from GitHub or npm to run locally. Updates to the Chrome DevTools version will land in Chrome Stable with the Chrome 87 release (mid-November).

Have questions about this or anything else Ad Speed related? Interested in contributing? Visit our GitHub repo.

- Jonathon Imperiosi, Publisher Ads Audits Team

Filter options update to Display & Video 360 API v1

Friday, August 28, 2020

Display & Video 360 API v1

New filterable fields for various list methods, including targeting option subtypes carrierAndIspDetails.type and geoRegionDetails.geo_region_type for the targetingTypes.targetingOptions.list method.

Additional fields in the advertisers.audit method response body that allow for the tracking of more entity counts against their account entity limits.

release notessupport contact form

- Trevor Mulchay, Display & Video 360 API Team

Google Ads API v2 sunset reminder

Thursday, August 27, 2020

sunsetAfter this date, all v2 API requests will begin to fail.newer version

Upgrading to the newest version

Release notes

forumgoogleadsapi-support@google.com

- Thanet Knack Praneenararat, Google Ads API Team

Sunset of DBM API v1, SDF Download and Line Item services

Thursday, August 27, 2020

Doubleclick Bid Manager (DBM) API v1.1 Line Item serviceFebruary 26, 2021DBM API v1DBM API v1.1 Structured Data File (SDF) Download serviceoriginally scheduled for June 15, 2020postponed due to COVID-19

Service

Methods

Available in v1.1 after
February 26, 2021?

Reporting

queries.createquery

queries.deletequery

queries.getquery

queries.listqueries

queries.runquery

reports.listreports

Yes

Line Item

lineitems.downloadlineitems

lineitems.uploadlineitems

No. Use the new Display &
Video 360 API instead.

SDF Download

sdf.download

No. Use the new Display &
Video 360 API instead.

DBM API v1 Reporting servicev1.1API release notes

Queries created and accessed through the Reporting service require more specific filters in the params.groupBy field in v1.1. You might have to add more values to the params.groupBy field in order to create the same report structure generated in v1.

Responses from queries.listqueries and reports.listreports calls are paginated in v1.1. Users have to update their implementation to traverse multiple pages if they wish to consume more than the first 100 items returned.

Display & Video 360 (DV360) API

The DBM API SDF Download service is being replaced by the DV360 API asynchronous SDF Download service. It features new filter options and a new download format.

The DBM API Line Item service is being replaced by the DV360 API Line Item service. This service provides create, update, and delete methods for line items using a more easily managed REST Line Item resource separate from Entity Write File format currently used in the DBM API.

set up the Display & Video 360 APIdownload SDFsmanage your line items
If you encounter issues with your migration or want to report a separate issue, please contact us using our support contact form.

- Trevor Mulchay, Display & Video 360 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?

Release Notes

Guides

Reference

Upgrading to the newest version

forum

Nadine Wang, on behalf of the Google Ads API Team

Stricter field validation implemented for Doubleclick Bid Manager API

Monday, August 24, 2020

Doubleclick Bid Manager (DBM) APIINVALID_ARGUMENTVerify that your code converts values with decimals to longs and integers. If you receive an INVALID_ARGUMENT error, make sure your numbers are actual longs or integers.If you need help adjusting for this new validation or want to report a separate issue, please contact us using our support contact form.

- Trevor Mulchay, Display & Video 360 API Team

Ads Developer Blog

Announcing AdMob API v1 General Availability

Introducing Publisher Ads Audits for Lighthouse v1.2.0

Filter options update to Display & Video 360 API v1

Google Ads API v2 sunset reminder

Sunset of DBM API v1, SDF Download and Line Item services

Announcing v5 of the Google Ads API beta

Stricter field validation implemented for Doubleclick Bid Manager API

Labels

Archive