Tag Archives: ad_manager_api

Announcing the 2019 NYC Google Ad Manager API Workshop

We’re excited to announce another Google Ad Manager API Workshop in NYC on May 8, 2019. If you’re a regular user of the Ad Manager API and Google Publisher Tags, then you’re sure to find something of interest at this event.

What is it?

A half-day event featuring technical talks by Google engineers and office hours with Google's Developer Relations team. Doors will open at 12:45pm and our keynote presentation will kick off at 1 o’clock. We will have talks on the following topics:
  • Serverless API integrations using Google Cloud Functions
  • Strategies and hands-on demos of tools for faster loading pages and ads
  • Advanced techniques for extracting data that isn't available in the reporting API

Who is the target audience?

The event is targeted toward developers who use or are interested in using the Ad Manager API. The talks will be technical in nature, so a technical background is recommended for all attendees. This event is an opportunity for you to learn more about the API's capabilities and its newest features. This is also an opportunity for you to share feedback by talking directly with Googlers who work on the API.

Where is it?

Google’s Chelsea Market Office
75 Ninth Avenue,
New York, NY 10011

How do I sign up?

To register, please visit our website for this event. Seating is limited, so after you register, we will reach back out to you to confirm your spot at the workshop.

Sunset of the Ad Manager API v201805

On Friday, May 31, 2019, in accordance with the deprecation schedule, v201805 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re using any of Google’s client libraries, you should allow extra time to migrate off of v201805, since it was the last version before the DFP API became the Google Ad Manager API. For details on what’s changed, each client library has a migration guide: Java, Python, .NET, PHP, and Ruby.

When you’re ready to upgrade, check the release notes to identify any breaking changes (such as the change to the capitalization of DateTime.timeZoneId in v201811). Then, grab the latest version of your client library and update your code. As always, don't hesitate to reach out to us on the developer forum with any questions.

To be notified of future sunsets, join the Ad Manager API Sunset Announcements group and adjust your notification settings. If you are an administrator on your network, you can also receive notifications when an application is making requests to your network using a deprecated version, as explained in this post.

Python 2 Deprecation in Ads API Client Libraries

As the official End of Life date for Python 2 approaches, we will be ending support for Python 2 in both the AdWords/Google Ad Manager and Google Ads Python client libraries in 2019. After deprecation the minimum required Python version for both libraries will be 3.6+.

Deprecation will begin with the AdWords/Google Ad Manager Python client library in May. Here’s a timeline for easy reference:
  • mid-May: version 19.0.0 is released to support Google Ad Manager API v201905. Python 2 users should not upgrade to any major version beyond this.
  • mid-May - late-June: Python 2 deprecation window.
  • Last week in June: version 20.0.0 is released that is incompatible with Python 2.
  • July 1: Support for Python 2-related issues in the library ends.
If you are a user of the AdWords/Google Ad Manager client library, please take note of the following:
  • Google Ad Manager Users:
    • If you’re already using Python 3, no need to take action.
    • If you’re using Python 2 you should remain on version 19.0.0 until you’ve migrated to Python 3.
  • AdWords Users:
    • Please migrate to the new Google Ads API.
    • If you’re using Python 2 you should remain on version 19.0.0 until you’ve migrated to the Google Ads API.
  • All Users:
    • Beginning July 1, 2019 we will discontinue prioritizing work and triaging GitHub Issues related to compatibility with Python 2. Note that we will submit patches to version 19.0.0 if any major bugs arise after this deadline.
The Google Ads API client library will continue to be compatible with Python 2 until the end of 2019. We will post more information about that migration at a later date. In the meantime, Python 2 users should start planning their migration to Python 3 as soon as possible in order to avoid complications.

If you have questions about the Python 3 migration please submit an issue on the respective GitHub repository, and for general API support please reach out to us on the Google Ads API forum or the Google Ad Manager API forum.

Announcing v201902 of the Google Ad Manager API

We're happy to announce that v201902 of the Google Ad Manager API is available starting today. The two main areas that are getting new API functionality are forecasting and video.

In v201902, you can set LineItems to be paced based on their projected traffic instead of their historical traffic by setting DeliveryForecastSource to FORECASTING. This API version also adds the AdjustmentService to manage traffic forecast adjustments. For example, if you’re expecting an increase in traffic for an upcoming holiday, you can manually adjust your forecasts to take that increase into consideration.

There are also several updates to video features in this version of the API. You can now target LineItems by CmsMetadataValues (content targeting) and custom AdSpots (position targeting).

For a full list of API changes in v201902, see the release notes.

For questions about this or any other API changes, reach out to us on the Ad Manager API forum.

Subscribe to our RSS feed to get blog posts via email

(If you want to continue getting email updates about our blog posts, read on. If you don't want email updates from this blog, you can skip this post.)

For some products, the Google Ads Developer team has used Google groups as a way to allow API users to subscribe and get new relevant blog posts delivered to their email address. Starting now, the way you can get email updates about blog posts is changing. We will no longer send an email to the Google group for each new blog post. We will continue to use the Google groups for other important updates, however.

For users who still want email updates, we've introduced new FeedBurner links on the right-hand panel of our blog homepage. You can subscribe to the RSS feed by clicking on the link for the product you're interested in, or subscribe by email by clicking on the [+] link to the right of the product name.

If you use any of the APIs that we discuss on this blog, make sure you subscribe to the feed to keep up with the latest news and updates:

Sunset of the Ad Manager API v201802

On Thursday, February 28, 2019, in accordance with the deprecation schedule, v201802 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new functionality like new reporting Dimensions, enhanced options for Targeting, and improved Forecast breakdowns.

To upgrade, check the release notes to identify any breaking changes, grab the latest version of your client library, and update your code.

Significant changes include: This is not an exhaustive list, so be sure to check the release notes for a list of all changes. As always, don't hesitate to reach out to us with any questions.

To be notified of future deprecations and sunsets, join the Ad Manager API Sunset Announcements group and adjust your notification settings. If you are an administrator on your network, you can also receive notifications when an application is making requests to your network using a deprecated version, as explained in this post.

2018 Ad Manager API Workshop Slides

Thanks to everyone who was able to make it to the recent Ad Manager API Workshop in New York. As always, it was great to connect with the developers who use our API. If you are interested in the content that we covered, you can now access the combined slide deck from the workshop talks.




We’ve already begun planning for our 2019 workshops, so be sure to check this blog for more updates. If you have general API questions or comments, please reach out to us on the Ad Manager API forums.

Announcing the 2018 Ad Manager API Workshop

We’re excited to announce our Ad Manager API Workshop on October 31, 2018. It may be Halloween, but there are no tricks, some treats, and a lot of information on how you can get more out of the Ad Manager API.

What is it?

A half-day event featuring technical talks by Google engineers and office hours with Google's Developer Relations team. Agenda with description for each of the talks is available on the registration site.

Who is the target audience?

The event is targeted toward developers who use or are interested in using the Ad Manager API. The talks will be technical, thus technical background is recommended for all attendees. This event is an opportunity for you to learn more about the API's capabilities and its newest features. This is also an opportunity for you to share feedback and influence direction by talking directly with Googlers who work on the API.

Where is it?

Google’s Chelsea Market Office
75 Ninth Avenue,
New York, NY 10011

How do I sign up?

To register, please visit registration site. Seating is limited, and after you register, we will reach back out to you to confirm your spot at the workshop.

Sunset of the Ad Manager API v201711

On Friday, November 30, 2018, in accordance with the deprecation schedule, v201711 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new functionality with Preferred Deals, forecasting, and reporting.

To upgrade, check the release notes to identify any breaking changes, grab the latest version of your client library, and update your code.

Significant changes include:

This is not an exhaustive list, so be sure to check the release notes for a list of all changes. As always, don't hesitate to reach out to us with any questions.

To be notified of future deprecations and sunsets, join the Ad Manager API Sunset Announcements group and adjust your notification settings. If you are an administrator on your network, you can now also receive notifications when an application is making requests to your network using a deprecated version, as explained in this post.

Introducing the Improved Ad Manager API Sunset Notifications

We’ve heard your feedback regarding the current API sunset notifications, and today we’re pleased to share some upcoming improvements.

Greater User Control
Network administrators will be able to choose whether or not to receive these notifications via the Notification Settings panel in the Ad Manager UI. Check the box next to Deprecated API in use to opt-in to the notifications. Administrators will be automatically opted-in at launch.








More Meaningful Information

Our communications already include a list of applications that are using the deprecated API version. The improved email notification also shows how many requests each application made to the deprecated API. We hope this will help you prioritize which applications need to be upgraded first and expedite the API upgrade process.


UI Notifications

Alongside the email notification, you will also receive a notification card in the Ad Manager UI. Both will be sent on the second Tuesday of each month.







These updates will be rolling out to network administrators in the coming weeks and we will announce in the release notes when they’re available. As always, upcoming deprecation and sunset dates are available on the deprecation schedule page. If you have any questions or feedback, please feel free to reach out to us on the Ad Manager API forums.