NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #1220 most downloaded on Packagist
Google Ads API client for PHP
Last release 14 days ago
23 Sep 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
76 releases · first in 2018
Added support for Google Ads API v25.2
Remove developer token validation support
Added support for Google Ads API v25.1
One column per quarter.
Added support for Google Ads API v25.0
Resolved ongoing Laravel security vulnerabilities
Resolved Laravel sample app security vulnerabilities
Resolved Laravel sample app security vulnerabilities
Support for Google Ads API v23.2.
Added support for Google Ads API v23.1.
Ensured deprecated salesCountry parameter is not used in AddPerformanceMaxRetailCampaign example.
AddCampaigns, AddDynamicSearchAds, AddPerformanceMaxCampaign, AddPerformanceMaxRetailCampaign, and AddAppCampaign.AddCallAd.php example as Call Ads are no longer supported in the API.brandGuidelinesEnabled parameter to true in AddPerformanceMaxCampaign and AddPerformanceMaxRetailCampaign examples.salesCountry parameter is not used in AddPerformanceMaxRetailCampaign example.composer update.Supports Ads API v22 for users still on PHP 7.4
Supports Ads API v22 for users still on PHP 7.4
examples/AdvancedOperations/AddPerformanceMaxCampaign.php and examples/ShoppingAds/AddPerformanceMaxRetailCampaign.php:url_expansion_opt_out field with AssetAutomationSettings to control URL expansion and text asset automation.Updated protobuf constraint in to be less restrictive for users on the Protobuf 3.x series and preserve backwards compatibility.
Compatibility with v21.0 of the API: https://developers.google.com/google-ads/api/docs/release-notes
Fixed the potential break in v29.0.0 (due to dependency conflicts) by pinning the protobuf dependency to be <=4.30.0 and reverting back to the old get
Security fixes, updated deprecated getLabel to isRepeated.
Compatibility with v20.0 of the API: https://developers.google.com/google-ads/api/docs/release-notes
Removed support for v17 of the API: https://ads-developers.googleblog.com/2025/04/google-ads-api-v17-sunset-reminder.html
Compatibility with v19.1 of the API: https://developers.google.com/google-ads/api/docs/release-notes
Added support for v19 of Google Ads API.
Removed support for v16 of Google Ads API.
Added support for v18 of Google Ads API.
useGapicV2Source configuration, as the source code
of all versions are generated as GAPIC v2.
Added support for v17_1 of Google Ads API.
Added support for v17 of Google Ads API.
pageSize:
Re-generated the source code for v16_1 of Google Ads API to add some missing classes and enum values.
Added support for v16_1 of Google Ads API.
google/protobuf v4.26.composer.json to require the minimum PHP version of 8.1.package.json of LaravelSampleApp.Nothing published for this version
Added support for v16 of Google Ads API.
examples/LaravelSampleApp/composer.lock.examples/Extensions to examples/Assets. Removed some logic
related to the extensions.Removed support for v13 of Google Ads API.
ResourceNames of v14 and v15.GoogleAdsFailuresInterceptorTest.php and GoogleAdsLoggingInterceptorTest to make them work with the latest version of google/gax.Added support for v15 of Google Ads API. The following code examples still use v14 because the services in the examples were removed in v15:
src/Google/Ads/GoogleAds/v15/Services/Client/<SERVICE_NAME>Client.php) no longer rely on base classes (src/Google/Ads/GoogleAds/v15/Services/Client/BaseClient/<SERVICE_NAME>BaseClient.php). All functions and variables are now directly included in the service classes.useCloudOrgForApiAccess config. This is in preparation for the pilot that uses Google Cloud orgs for API Access levels.InfoRedactor to redact fields of Local Services lead and Local Services lead
conversation.ShoppingSetting::sales_country field is
removed:
Fixed #946 by adding forTopicConstant() to ResourceNames.
forTopicConstant() to
ResourceNames.Removed support for v12 of Google Ads API.
ResourceNames and ServiceClientFactoryTrait of v14.Added support for v14_1 of Google Ads API.
final modifier from GoogleAdsClient. This fixes
https://github.com/googleads/google-ads-php/issues/347.linked-customer-id to the header of a request.GoogleAdsCallLogger::getNextFinerLogLevel aligned with PSR-3
LogLevel enum by returning a lowercase string. This fixes
https://github.com/googleads/google-ads-php/issues/849.GoogleAdsClientBuilder::validate(). It now supports the case when
the system-package version is not found.useGapicV2Source configuration.KeywordPlanIdeaService)KeywordPlanIdeaService)Updated composer.json to require the minimum PHP version of 8.0. See also README for more details.
composer.json to require the minimum PHP version of 8.0. See also
README for more details.google/gax to 1.19.1.GoogleAdsClientBuilder::validate(). This is a fix for
#406.examples/LaravelSampleApp/composer.lock.Added support for v14 of Google Ads API.
Added support for v13_1 of Google Ads API.
Removed support for v11 of Google Ads API.
Reworked code examples to address the deprecation of combined rule user lists and expression rule user lists:
Added support for v12 of Google Ads API.
Reworked code examples to address the deprecation of Expanded Text Ads (ETA):
google/protobuf to 3.21.5.Removed support for v9 of Google Ads API.
google/gax to 1.13.0.examples/LaravelSampleApp/composer.lock.Added support for v11 of Google Ads API.
monolog/monolog.examples/LaravelSampleApp/composer.lock.Combined two examples in Authentication/ into GenerateUserCredentials, since OAuth OOB is being deprecated.
Authentication/ into GenerateUserCredentials,
since OAuth OOB is being deprecated.Dockerfile to use the latest stable version of Apache PHP by default.examples/Migration/composer.json and fixed
#761.examples/LaravelSampleApp/composer.lock.Added support for v10 of Google Ads API.
GoogleAdsMetadataTrait of all
versions.composer.json and composer.lock of LaravelSampleApp.google/protobuf to 3.19.4.Updated composer.json to require the minimum PHP version of 7.4.
composer.json to require the minimum PHP version of 7.4.Added support for v9 of Google Ads API.
grpc and protobuf extensions to require-dev of composer.json.GoogleAdsError.composer.json of LaravelSampleApp.enableWarnings mode of
OfflineUserDataJobService. See
the Warnings
guide for details.Added support for sending the library name and version with each request.
google/protobuf to 3.18.0.composer.json and composer.lock of LaravelSampleApp.Added support for v8_1 of Google Ads API.
monolog/monolog dependency.Moved the CampaignReportToCsv example to the Migration/ directory.
Added support for v8 of Google Ads API.
google/protobuf to 3.17.1.Added support for v7 of Google Ads API.
Added missing 'null' type hints in the package src/Google/Ads/GoogleAds/v6/.
src/Google/Ads/GoogleAds/v6/.Updated GoogleAdsLoggingInterceptor.php of all versions to accommodate a breaking change in the new version of grpc/grpc (1.36.0).
google/gax, grpc/grpc and
google/protobuf.
grpc/grpc (1.36.0).examples directory and its dependency belong to dev in
composer.json. This makes the size of the downloaded source code lighter.Added support for v6_1 of Google Ads API.
composer.json to require the minimum PHP version of 7.3.Added support for logging responses of stream calls.
tests/ and updated the PSR-4 rules in
composer.json accordingly.Added support for v6 of Google Ads API.
Added support for v5 of Google Ads API.
google/protobuf (^3.13.0), ulrichsg/getopt-php (^3.4).Added support for v4 of Google Ads API.
ConversionUploadServiceClient::uploadClickConversions()ConversionUploadServiceClient::uploadCallConversions()ConversionAdjustmentUploadServiceClient::uploadConversionAdjustment()GeoTargetConstantServiceClient::suggestGeoTargetConstants()KeywordPlanIdeaServiceClient::generateKeywordIdeas()MutateJobServiceClient::addMutateJobOperations()ReachPlanServiceClient::generateProductMixIdeas()ReachPlanServiceClient::generateReachForecast()linked-customer-id header for v4.AddCompleteCampaignsUsingMutateJob to
AddCompleteCampaignsUsingBatchJob to reflect a new name in v4.Added support for v3_1 of Google Ads API.
GoogleAdsService.searchStream with an experimental iterator.ResourceNames with some types: CurrencyConstant, Ad, AdGroupExtensionSetting,
CustomerExtensionSetting, CampaignExtensionSetting.Added support for v3_0 of Google Ads API.
squizlabs/php_codesniffer (^3.5), google/protobuf (^3.11.4).Remove the preemptive initialization of "GoogleAdsFailures" when not running with gRPC transport.
Your coding agent can read these notes before it upgrades. Set up the MCP server →