Tag Archives: php

Updating the minimum required PHP version for the Google Ads API client library for PHP (AdWords and Ad Manager)

Starting March 2019, the composer file of all releases of the Google Ads API client library for PHP (AdWords and Ad Manager) will require PHP version 7.1 or later. The latest major version of the client library (v39.0.0) will be the last release that supports PHP 5, with the minimum required PHP version of 5.6. We’ll still fix critical bugs for this major version, but no new features will be added to it in the future.

PHP 5.6 and 7.0 were sunset at the end of 2018. The PHP development team no longer provides security fixes for these versions, so we highly recommend migrating to the latest version (7.3) if possible.

You can see some useful resources below: As always, if you have any questions, feel free to drop us a line on the Google Ads API or Google Ad Manager API forums.

Reminder to PHP users – upgrade to the new Ads PHP library!

Hello PHP developers! In December 2016, we announced the stable release of the new ads PHP library and the deprecation of the old one. This is a reminder to upgrade to the new library by July 31, 2017.

The new PHP library has many improvements such as support of namespaces and Composer installation. It is currently available as the master branch on GitHub. We also provide an upgrading guide to help you during this upgrade.

The old library has been moved to the deprecated branch with reduced support and will reach end of life (EOL) on July 31, 2017. We recommend you complete your upgrade before that date. Past this date, the deprecated branch can still be used until all of the AdWords / DFP API versions it supports are sunset, but we will not add support and examples for new API versions, nor fix any bugs.

If you have questions about upgrading or need help, as always, feel free to ask on the GitHub issues page. If you have questions regarding AdWords or DFP API, please drop us a line on the AdWords or DFP API forums.

Announcing the new ads PHP client library

Hello ads PHP developers! Today we're pleased to announce the stable release of the new ads PHP client library. This has been in beta for a while now, is a huge overhaul of the library, and offers the following improvements:

  • Uses namespaces and conforms to PSR-4 autoloading.
  • Conforms to PSR-3 for logging.
  • Supports installation via Composer.
  • Uses the Google PHP auth library for OAuth2, offering more features, flexibility, and service account support.
  • Uses Guzzle for non-SOAP HTTP calls, conforming to PSR-7.
  • Contains better object-oriented library design and stub interfaces, including builders to configure settings.
  • Contains upgraded and easier to use utilities for AdWords reporting, AdWords batch jobs, and DFP reporting.
  • Enables SSL by default for SOAP API calls and non-SOAP HTTP API calls.

This library has been pushed to the master branch on GitHub. The old library is now deprecated and moved to a deprecated branch with reduced support until it reaches end of life (EOL) on July 31, 2017. Reduced support details can be found in issue #193. To help you upgrade, we've written an upgrading guide.

As always, if you have any questions, feel free to drop us a line on the AdWords or DFP API forums, or the Ads Developer Google+ page.

Announcing BETA release of the new Ads PHP Client Library

Today we're pleased to announce that we have released an updated BETA version of the Ads PHP Client Library. This is the first step in completely refactoring the Ads PHP Client Library to adhere to modern PHP standards. Major changes include:

  • Namespaced and conforms to PSR-4 for autoloading.
  • Conforms to PSR-3 for logging standards.
  • Entry point classes use a builder pattern for their construction.
  • Core class design is composition-based instead of inheritance-based.
  • Classes generated from WSDLs now use getters and setters for accessing fields.

To get started with this new library, please see the README's "Basic usage" section.

As a reminder, since this new client library is in BETA, it is not yet recommended for production usage. We do however recommend that you test it out, play around with it, and give us your feedback on the issue tracker.

Stay tuned for more changes to this BETA library in the coming year.

As always, if you have any questions, feel free to drop us a line on the AdWords API forums, DFP API forums or the Ads Developer Google+ page.

Deprecating PHP 5.2 support for the Ads PHP Client Library

Starting January 1st, 2015, the PHP Ads client library will stop supporting PHP 5.2:
  • We will no longer test against PHP 5.2, or fix bugs that only affect PHP 5.2 users
  • Newer versions of the library may not work with PHP 5.2
This will impact PHP client library users of the AdWords API, the DoubleClick for Publishers API, and the DoubleClick Ad Exchange Buyer APIs.

PHP 5.2 hasn’t been supported since 2011 and should be upgraded to a current, stable version. Upgrading ensures you’ll receive the latest security updates.

In addition, there are numerous issues when using the PHP 5.2 SOAP client, such as: In particular, custom HTTP headers are required for the DoubleClick for Publishers API starting from DoubleClick for Publishers API v201405 - the OAuth 2.0 access token must be passed via the HTTP headers rather than the URL parameter. In this case, PHP 5.2 users must upgrade in order to use DoubleClick for Publishers API v201405.

As always, if you have any questions, drop us a line on the forums (AdWords API, DoubleClick for Publishers API, DoubleClick Ad Exchange Buyer API) or Ads Developers Google+ page.