googleads/google-ads-php
Google Ads API client for PHP
v34.0.0
9.1M downloads/mo
#1235 most downloaded on Packagist
googleads/google-ads-php
What this package is like to depend on
Last release 4 days ago
19 Aug 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 73 of 74 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
74 releases · first in 2018
9 releases in the last 12 months
see the full history below
Release timeline
74 releases · Jun 2018 to Aug 2026
2019
2020
2021
2022
2023
2024
2025
2026
Releases
latest 60 of 74-
v34.0.019 Aug 2026Release notes
Open source →- Added support for Google Ads API v25.1
- Removed support for Google Ads API v20 and v21
-
v33.6.022 Jul 2026Release notes
Open source →- Added support for Google Ads API v25.0
- Regenerated support for Google Ads API v24.2 to add some fields that were missing from the previous release.
-
v33.5.024 Jun 2026Release notes
Open source →- Added support for Google Ads API v24.2
- Resolved ongoing Laravel security vulnerabilities
- Updated Docker build images
-
v33.4.013 May 2026Release notes
Open source →- Added support for Google Ads API v24.1
- Resolved Laravel sample app security vulnerabilities
-
v33.3.022 Apr 2026Release notes
Open source →- Added support for Google Ads API v24
- Dependency updates
- Resolved Laravel sample app security vulnerabilities
- Removed grpc/grpc maximum version constraint
-
v32.3.025 Mar 2026Release notes
Open source →- Support for Google Ads API v23.2.
- Incorporated generator updates (new 'actions' directory, Protobuf changes).
- Dependency updates.
-
v32.2.025 Feb 2026Release notes
Open source →- Added support for Google Ads API v23.1.
- Regenerated stubs for Google Ads API v20, v21, and v22 to incorporate changes for supporting European Union Political Ads Regulation in Google Ads API
- Updated dependencies.
-
v32.1.028 Jan 2026Release notes
Open source →- Added support for Google Ads API v23.
- Removed support for Google Ads API v19.
- Updated examples in examples in
AddCampaigns,AddDynamicSearchAds,AddPerformanceMaxCampaign,AddPerformanceMaxRetailCampaign, andAddAppCampaign. - Removed the
AddCallAd.phpexample as Call Ads are no longer supported in the API. - Changed the default value of the
brandGuidelinesEnabledparameter totrueinAddPerformanceMaxCampaignandAddPerformanceMaxRetailCampaignexamples. - Ensured deprecated
salesCountryparameter is not used inAddPerformanceMaxRetailCampaignexample. - Updated dependencies via
composer update.
-
v31.1.015 Oct 2025Release notes
Open source →- Added support for Google Ads API V22.
- Updated generated code for Google Ads API V21 to include recent fixes.
- Updated
examples/AdvancedOperations/AddPerformanceMaxCampaign.phpandexamples/ShoppingAds/AddPerformanceMaxRetailCampaign.php: - Examples now use Google Ads API V22.
- Replaced deprecated
url_expansion_opt_outfield withAssetAutomationSettingsto control URL expansion and text asset automation.
-
v31.0.122 Aug 2025Release notes
Open source →- Updated protobuf constraint in to be less restrictive for users on the Protobuf 3.x series and preserve backwards compatibility.
-
v31.0.006 Aug 2025Release notes
Open source →- Compatibility with v21.0 of the API: https://developers.google.com/google-ads/api/docs/release-notes
- Added support for declaring EU political advertising status on campaign creation in examples.
- Pinned the 'grpc/grpc' dependency so it doesn't get ahead of the C 'ext-grpc'.
- Removed support for v18 of the API: https://ads-developers.googleblog.com/2025/07/google-ads-api-v18-sunset-reminder.html
-
v30.0.021 Jul 2025Release notes
Open source →- 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 getLabel method.
- Fixed the potential maximum call size error due to a bug in the GRPC C extension by pinning ext-grpc to be <=1.66.0
-
v29.0.027 Jun 2025 -
v28.0.004 Jun 2025Release notes
Open source →- Compatibility with v20.0 of the API: https://developers.google.com/google-ads/api/docs/release-notes
-
v27.2.014 May 2025Release notes
Open source →- Removed support for v17 of the API: https://ads-developers.googleblog.com/2025/04/google-ads-api-v17-sunset-reminder.html
-
v26.2.018 Apr 2025Release notes
Open source →- Compatibility with v19.1 of the API: https://developers.google.com/google-ads/api/docs/release-notes
-
v26.1.027 Feb 2025Release notes
Open source →- Added support for v19 of Google Ads API.
- Removed support for Feed-related classes, fields and enums in v19.
- Updated code examples:
- AddPerformanceMaxCampaign
- AddPerformanceMaxRetailCampaign
- AddShoppingProductAd
- GetChangeDetails
-
v26.0.005 Feb 2025 -
v25.0.018 Oct 2024Release notes
Open source →- Added support for v18 of Google Ads API.
- Removed support for the
useGapicV2Sourceconfiguration, as the source code of all versions are generated as GAPIC v2.- Fixed the LaravelSampleApp to use GAPIC v2.
- Updated code examples:
- GetAllDisapprovedAds
- HandlePartialFailure
-
v24.0.009 Aug 2024Release notes
Open source →- Added support for v17_1 of Google Ads API.
- Removed support for v15 of Google Ads API.
- Made service client classes non-final.
- Added support for setting a REST handler as a client option for each call.
-
v23.1.007 Jun 2024Release notes
Open source →- Added support for v17 of Google Ads API.
- Updated code examples for removing the usage of
pageSize:- GetAccountHierarchy
- GetChangeDetails
- GetChangeSummary
- LinkManagerToClient
- FindAndRemoveCriteriaFromSharedSet
- GetAdGroupBidModifiers
- GetResponsiveSearchAds
- GetAllDisapprovedAds
- CampaignReportToCsv
- SetUpRemarketing
- UpdateAudienceTargetRestriction
- AddPerformanceMaxProductListingGroupTree
- AddPerformanceMaxRetailCampaign
- AddShoppingProductListingGroupTree
- GetProductCategoryConstants
- Utils\Feeds
- Removed code examples:
- NavigateSearchResultPagesCachingTokens
-
v23.0.130 Apr 2024Release notes
Open source →- Re-generated the source code for v16_1 of Google Ads API to add some missing classes and enum values.
-
v23.0.025 Apr 2024Release notes
Open source →- Added support for v16_1 of Google Ads API.
- Removed support for v14 of Google Ads API.
- Added support for
google/protobufv4.26. - Updated
composer.jsonto require the minimum PHP version of 8.1. - Rolled back changes to the code base that requires PHP 8.0 or above, so PHP 7 users can still easily clone this library to work with the legacy code.
- Updated
package.jsonof LaravelSampleApp. - Added VerifyAdvertiserIdentity example.
- Updated code examples:
- AddCompleteCampaignsUsingBatchJob
- DetectAndApplyRecommendations
- DismissRecommendation
- UploadConversionAdjustment
- Removed code examples:
- AddFlightsFeed
- AddRealEstateFeed
- ApplyRecommendation
- ApproveMerchantCenterLink
- DismissRecommendation
- RejectMerchantCenterLink
-
v22.1.124 May 2024Nothing published for this version
-
v22.1.023 Feb 2024Release notes
Open source →- Added support for v16 of Google Ads API.
- Fixed dependabot alert in
examples/LaravelSampleApp/composer.lock. - Renamed
examples/Extensionstoexamples/Assets. Removed some logic related to the extensions. - Renamed code examples:
- from AddLeadFormExtension to AddLeadFormAsset
- from AddSitelinksUsingAssets to AddSitelinks
- Updated code examples:
- AddConversionAction
- AddFlexibleRuleUserList
- GetAdGroupBidModifiers
- Removed code examples:
- AddAffiliateLocationExtensions
- AddBusinessProfileLocationExtensions
- AddGeoTarget
- AddImageExtension
- AddSitelinks (the old one that uses extensions)
- MigratePromotionFeedToAsset
- RemoveEntireSitelinkCampaignExtensionSetting
- UpdateSitelink
- UpdateSitelinkCampaignExtensionSetting
-
v22.0.024 Jan 2024Release notes
Open source →- Removed support for v13 of Google Ads API.
- Added more methods to
ResourceNamesof v14 and v15. - Updated
GoogleAdsFailuresInterceptorTest.phpandGoogleAdsLoggingInterceptorTestto make them work with the latest version ofgoogle/gax. - Updated code examples:
- AddFlexibleRuleUserList
- AddShoppingProductAd
- UploadOfflineConversion
-
v21.1.019 Oct 2023Release notes
Open source →- 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:
- ApproveMerchantCenterLink
- RejectMerchantCenterLink
- UploadImage
- UploadMediaBundle
- The GAPIC v2 service clients (
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. - Added support for
useCloudOrgForApiAccessconfig. This is in preparation for the pilot that uses Google Cloud orgs for API Access levels. - Updated
InfoRedactorto redact fields of Local Services lead and Local Services lead conversation. - Updated code examples:
- AddBillingSetup
- AddPerformanceMaxProductListingGroupTree
- AddCustomerMatchUserList
- UploadCallConversion
- UploadOfflineConversion
- UploadStoreSalesTransactions
- Renamed and updated code examples:
- UploadConversionWithIdentifiers to UploadEnhancedConversionsForLeads
- UploadConversionEnhancement to UploadEnhancedConversionsForWeb
- Fixed the following Shopping examples after the
ShoppingSetting::sales_countryfield is removed:- AddMerchantCenterDynamicRemarketingCampaign
- AddPerformanceMaxRetailCampaign
- AddShoppingProductAd
- 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:
-
v21.0.129 Sep 2023 -
v21.0.020 Sep 2023Release notes
Open source →- Removed support for v12 of Google Ads API.
- Use the GAPIC v2 source
code
in
ResourceNamesandServiceClientFactoryTraitof v14. - Updated the source code to use PHP 8 features, e.g., named arguments, private constants, constructor promotion, removing unused exception variables.
- Updated code examples:
- AddCampaigns
- GenerateKeywordIdeas
- Removed trivial code examples that can be easily obtained by changing small parts of other code examples.
-
v20.1.010 Aug 2023Release notes
Open source →- Added support for v14_1 of Google Ads API.
- Removed the
finalmodifier fromGoogleAdsClient. This fixes https://github.com/googleads/google-ads-php/issues/347. - Fixed https://github.com/googleads/google-ads-php/issues/902 by passing
linked-customer-idto the header of a request. - Made
GoogleAdsCallLogger::getNextFinerLogLevelaligned with PSR-3LogLevelenum by returning a lowercase string. This fixes https://github.com/googleads/google-ads-php/issues/849. - Fixed the issue of the check for grpc versions in
GoogleAdsClientBuilder::validate(). It now supports the case when the system-package version is not found. - Added support for the GAPIC v2 source
code.
- Added support for the
useGapicV2Sourceconfiguration. - Updated all code examples to show how to use the GAPIC v2 source code.
- Added support for the
- Added code examples:
- GenerateForecastMetrics (new version that uses
KeywordPlanIdeaService) - GenerateHistoricalMetrics (new version that uses
KeywordPlanIdeaService)
- GenerateForecastMetrics (new version that uses
- Removed AddKeywordPlan example.
-
v20.0.007 Jul 2023Release notes
Open source →- Updated
composer.jsonto require the minimum PHP version of 8.0. See also README for more details. - Updated the minimum required version of
google/gaxto 1.19.1. - Added a check for the versions of grpc installed by Composer and installed
as a platform package to
GoogleAdsClientBuilder::validate(). This is a fix for #406. - Fixed dependabot alert in
examples/LaravelSampleApp/composer.lock.
- Updated
-
v19.2.008 Jun 2023Release notes
Open source →- Added support for v14 of Google Ads API.
- Updated AddPerformanceMaxForTravelGoalsCampaign example.
- Removed code examples:
- GenerateForecastMetrics
- GenerateHistoricalMetrics
- GetCampaignCriterionBidModifierSimulations
-
v19.1.027 Apr 2023Release notes
Open source →- Added support for v13_1 of Google Ads API.
- Renamed the HotelAds example directory to Travel.
- Added AddThingsToDoAd example.
- Updated AddPerformanceMaxForTravelGoalsCampaign example.
-
v19.0.020 Mar 2023Release notes
Open source →- Removed support for v11 of Google Ads API.
- Updated CreateExperiment example.
-
v18.0.022 Feb 2023Release notes
Open source →- Added support for v13 of Google Ads API.
- Removed support for v10 of Google Ads API.
- Updated code examples:
- AddCustomerMatchUserList
- AddPerformanceMaxRetailCampaign
- GetAdGroupBidModifiers
- GetChangeDetails
- Reworked code examples to address the deprecation of combined rule user lists
and expression rule user lists:
- Edited SetUpAdvancedRemarketing and SetUpRemarketing
- Renamed AddCombinedRuleUserList to AddFlexibleRuleUserList
- Removed AddExpressionRuleUserList
-
v17.1.003 Nov 2022Release notes
Open source →- Added support for v12 of Google Ads API.
- Renamed HandleExpandedTextAdPolicyViolations to HandleResponsiveSearchAdPolicyViolations and made it work with responsive search ads instead.
- Removed code examples:
- All examples in the Migration/ directory
- Moved CampaignReportToCsv to the Misc/ directory
- AddDynamicPageFeed
- AddLocalCampaign
- AddSmartDisplayAd
- AddShoppingSmartAd
- All examples in the Migration/ directory
- Updated code examples:
- AddPerformanceMaxRetailCampaign
- AddSmartCampaign
- CreateExperiment
- ForecastReach
-
v17.0.018 Aug 2022Release notes
Open source →- Added support for v11_1 of Google Ads API.
- Updated the FieldMasks utility to better handle empty message fields. For more details on how field masks work, visit https://developers.google.com/google-ads/api/docs/client-libs/php/fieldmasks.
- Updated the minimum required version of
google/protobufto 3.21.5. - Added a code example: GenerateHistoricalMetrics
- Reworked code examples to address the deprecation of Expanded Text Ads (ETA):
- Edited AddAdCustomizer
- Renamed UpdateExpandedTextAd to UpdateResponsiveSearchAd
- Renamed ValidateTextAd to ValidateAd
- Removed AddExpandedTextAds
- Removed AddExpandedTextAdWithUpgradedUrls
-
v16.0.019 Jul 2022Release notes
Open source →- Removed support for v9 of Google Ads API.
- Cleaned up the FieldMasks util to remove reference to protocol buffer's wrapper types.
- Added support for Monolog 1 back.
- Updated the minimum required version of
google/gaxto 1.13.0. - Renamed a code example GetArtifactMetadata to SearchForGoogleAdsFields.
- Updated code examples:
- GenerateUserCredentials
- SetCustomClientTimeouts
- Fixed dependabot alert in
examples/LaravelSampleApp/composer.lock.
-
v15.1.016 Jun 2022Release notes
Open source →- Added support for v11 of Google Ads API.
- Added support for version 3 of
monolog/monolog. - Fixed dependabot alert in
examples/LaravelSampleApp/composer.lock. - Added code examples:
- CreateExperiment
- DetectAndApplyRecommendations
- Removed code examples:
- CreateCampaignExperiment
- GraduateCampaignExperiment
- Updated code examples:
- AddSmartCampaign
- GenerateUserCredentials
-
v15.0.028 Apr 2022Release notes
Open source →- Added support for v10_1 of Google Ads API.
- Removed support for v8 of Google Ads API.
- Combined two examples in
Authentication/intoGenerateUserCredentials, since OAuth OOB is being deprecated. - Updated
Dockerfileto use the latest stable version of Apache PHP by default. - Updated
examples/Migration/composer.jsonand fixed #761. - Fixed dependabot alert in
examples/LaravelSampleApp/composer.lock. - Added code examples:
- AddPerformanceMaxProductListingGroupTree
- Updated code examples:
- AddCampaigns
- AddCustomerMatchUserList
- AddDynamicRemarketingAsset
- AddPerformanceMaxCampaign
- AddPerformanceMaxRetailCampaign
- GetChangeDetails
- NavigateSearchResultPagesCachingTokens
- UploadOfflineConversion
-
v14.0.015 Feb 2022Release notes
Open source →- Added support for v10 of Google Ads API.
- Removed support for v7 of Google Ads API.
- Added support for case-insensitive HTTP header field names in
GoogleAdsMetadataTraitof all versions. - Updated
composer.jsonandcomposer.lockof LaravelSampleApp. - Updated the minimum required version of
google/protobufto 3.19.4. - Added code examples:
- AddCall
- AddCallAd
- AddDynamicPageFeedAsset
- AddDynamicRemarketingAsset
- NavigateSearchResultPagesCachingTokens
- Updated code examples:
- AddDisplayUploadAd
- AddPerformanceMaxCampaign
- AddPerformanceMaxRetailCampaign
- GetAccountInformation
- GetKeywords
- UploadConversionWithIdentifiers
- UploadImageAsset
-
v13.0.010 Dec 2021Release notes
Open source →- Updated
composer.jsonto require the minimum PHP version of 7.4. - Added support for setting gRPC channel, gRPC interceptor and middleware.
- Updated the references of "Google My Business/GMB" in code examples to "Business Profile".
- Updated LaravelSampleApp to use lazy loading for the paging mechanism for lower memory footprint and page loading time.
- Added code examples:
- AddPerformanceMaxCampaign
- AddPerformanceMaxRetailCampaign
- AddResponsiveSearchAdWithAdCustomizer
- UploadConversionWithIdentifiers
- UploadConversionEnhancement
- Updated code example:
- AddAppCampaign
- Renamed code examples:
- AddGoogleMyBusinessLocationExtensions to AddBusinessProfileLocationExtensions
- SetupAdvancedRemarketing to SetUpAdvancedRemarketing
- SetupRemarketing to SetUpRemarketing
- Updated
-
v12.1.012 Nov 2021Release notes
Open source →- Added support for v9 of Google Ads API.
- Added
grpcandprotobufextensions torequire-devofcomposer.json. - Added support for conversion adjustments in
GoogleAdsError. - Updated
composer.jsonof LaravelSampleApp. - Migrated the following extension examples to use assets.
- AddSitelinksUsingFeed (renamed to AddSitelinksUsingAssets)
- AddHotelCallout
- AddPrices
- Updated the AddSmartCampaign example to use newly available methods and specifications in v9.
- Updated UploadStoreSalesTransactions to support the
enableWarningsmode ofOfflineUserDataJobService. See the Warnings guide for details.
-
v12.0.028 Sep 2021Release notes
Open source →- Added support for sending the library name and version with each request.
- Updated the minimum required version of
google/protobufto 3.18.0. - Updated
composer.jsonandcomposer.lockof LaravelSampleApp. - Added code examples:
- AddBiddingDataExclusion
- AddBiddingSeasonalityAdjustment
- Fixed code examples:
- AddDisplayUploadAd
- AddLocalCampaign
- AddMerchantCenterDynamicRemarketingCampaign
- AddSmartDisplayAd
- UploadImage
- UploadImageAsset
- UploadMediaBundle
-
v11.0.013 Aug 2021Release notes
Open source →- Added support for v8_1 of Google Ads API.
- Added 1.26 to the minimum required version constraints of the
monolog/monologdependency. - Removed support for v6 of Google Ads API.
- Improved the FieldMasks utility:
- Support getting enum value names from fields in the getFieldValue method.
- Support the case when a modified field is an empty Message with no fields declared in the compare method.
- Fixed/improved code examples:
- GetAdGroupBidModifiers
- AddSmartCampaign
- GetChangeDetails
- AddLocalCampaign
- Removed the code example AddGmailAd.
-
v10.1.002 Jul 2021Release notes
Open source →- Moved the CampaignReportToCsv example to the Migration/ directory.
- Added the LIMIT clause to the query of the GetAdGroupBidModifiers example.
-
v10.0.016 Jun 2021Release notes
Open source →- Added support for v8 of Google Ads API.
- Removed support for v5 of Google Ads API.
- Fixed the ResourceNames utility:
- Some method names are changed to be consistent with others:
- forAccountLinkName becomes forAccountLink
- forThirdPartyAppAnalyticsLinkName becomes forThirdPartyAppAnalyticsLink
- Enumerable names are now expected instead of indexes. The affected methods are:
- forAdGroupExtensionSetting (ExtensionType)
- forCampaignAsset (AssetFieldType)
- forCampaignExtensionSetting (ExtensionType)
- forCustomerExtensionSetting (ExtensionType)
- All parameters typed as integers are now typed as strings
- Some method names are changed to be consistent with others:
- Added support for removing unused Google Ads API versions. See this guide for details.
- Updated the minimum required versions of
google/protobufto 3.17.1. - Added code examples:
- AddSmartCampaign
- UseCrossAccountBiddingStrategy
- Fixed/improved code examples:
- RemoveEntireSitelinkCampaignExtensionSetting
- UpdateSitelinkCampaignExtensionSetting
- UploadStoreSalesTransactions
-
v9.0.006 May 2021Release notes
Open source →- Added support for v7 of Google Ads API.
- Removed support for v4 of Google Ads API.
- Added code examples:
- AddCustomAudience
- CampaignReportToCsv
- MigratePromotionFeedToAsset
- Fixed/improved code examples:
- GetAdGroupBidModifiers
- LaravelSampleApp
- UploadCallConversion
- UploadOfflineConversion
-
v8.1.005 Apr 2021Release notes
Open source →- Added missing 'null' type hints in the package
src/Google/Ads/GoogleAds/v6/. - Updated code examples:
- AddCampaignTargetingCriteria
- AddDynamicPageFeed
- AddSitelinks
- CreateCustomer
- GetGeoTargetConstantsByNames
- UploadStoreSalesTransactions
- Added missing 'null' type hints in the package
-
v8.0.018 Mar 2021Release notes
Open source →- Added support for PHP 8.0.
- Updated the minimum required versions of
google/gax,grpc/grpcandgoogle/protobuf.- Updated GoogleAdsLoggingInterceptor.php of all versions to accommodate a
breaking change in the new version of
grpc/grpc(1.36.0). - Updated GoogleAdsFailuresUnaryCall.php of all versions.
- Updated GoogleAdsLoggingInterceptor.php of all versions to accommodate a
breaking change in the new version of
- Makes the
examplesdirectory and its dependency belong todevincomposer.json. This makes the size of the downloaded source code lighter. - Refactored ResourceNames.php and ServiceClientFactoryTrait.php.
- Fixed code examples:
- GetAdGroupBidModifier
- ValidateTextAd
-
v7.0.019 Feb 2021Release notes
Open source →- Added support for v6_1 of Google Ads API.
- Removed support for v3 of Google Ads API.
- Updated
composer.jsonto require the minimum PHP version of 7.3. - Fixed the FieldMasks utility to make it work with null nested messages.
- Redact email address in the newly available CustomerUserAccessInvitation.
- Added code examples:
- AddImageExtension
- GetPendingInvitations
- InviteUserWithAccessRole
- Fixed/improved code examples:
- AddCampaignBidModifier
- GetChangeDetails
- GetProductBiddingCategoryConstant
-
v6.1.011 Dec 2020Release notes
Open source →- Added support for logging responses of stream calls.
- Updated the required protobuf version to v3.14.0 for better performance and bug fixes.
- Moved testing files to
tests/and updated the PSR-4 rules incomposer.jsonaccordingly. - Added support for PHPUnit 9.3.
- Added print_php_information for printing information about installed extensions.
- Added code examples:
- GetInvoices
- SetupRemarketing
- SetupAdvancedRemarketing
-
v6.0.016 Nov 2020Release notes
Open source →- Added support for v6 of Google Ads API.
- Updated all code examples to v6.
- Removed support for v2.
- Refactored LogMessageFormatter to redact any email addresses present in the requests and responses.
- Added support of client configuration from environment variables.
- Added code examples:
- UpdateAudienceTargetRestriction
- AddLocalCampaign
- SetCustomClientTimeouts
- GetChangeDetails
- CreateFeedItemSet
- GetFeedItemsOfFeedItemSet
- LinkFeedItemSet
- AddLeadFormExtension
- Renamed the code examples:
- From GetAccountChanges to GetChangeSummary
- From AuthenticateInStandaloneApplication to AuthenticateInDesktopApplication
- Migrated to field presence.
- Migrated the code examples.
- Added unit tests.
-
v5.0.001 Sep 2020Release notes
Open source →- Added support for v5 of Google Ads API.
- Upgraded dependencies:
google/protobuf(^3.13.0),ulrichsg/getopt-php(^3.4). - Fixed instantiation tests and PSR-4 issues.
- Updated all code examples to v5.
- Added code examples:
- AddLogicalUserList
- AddCombinedRuleUserList
- AddExpressionRuleUserList
- AddConversionBasedUserList
- AddBillingSetup
- RejectMerchantCenterLink
- Fixed/improved code examples:
- AddSmartDisplayAd
- UpdateSitelinkCampaignExtensionSetting
- CreateCustomer
- UsePortfolioBiddingStrategy
- ForecastReach
-
v4.0.013 Jul 2020Release notes
Open source →- Added support for v4 of Google Ads API.
- Updated code examples to v4.
- Removed support for v1.
- Regenerated source for v2 and v3 to reflect a new design.
The following methods now have different signatures:
ConversionUploadServiceClient::uploadClickConversions()ConversionUploadServiceClient::uploadCallConversions()ConversionAdjustmentUploadServiceClient::uploadConversionAdjustment()GeoTargetConstantServiceClient::suggestGeoTargetConstants()KeywordPlanIdeaServiceClient::generateKeywordIdeas()MutateJobServiceClient::addMutateJobOperations()ReachPlanServiceClient::generateProductMixIdeas()ReachPlanServiceClient::generateReachForecast()
- Added support for the
linked-customer-idheader for v4. - Added more tests to increase code coverage.
- Fixed some test data.
- Renamed
AddCompleteCampaignsUsingMutateJobtoAddCompleteCampaignsUsingBatchJobto reflect a new name in v4. - Added code examples:
- AddDisplayUploadAd
- AddSitelinksUsingFeeds
- Fixed/improved code examples:
- AddDynamicPageFeed
- GenerateKeywordIdeas
- HandleExpandedTextAdPolicyViolations
- HandleKeywordPolicyViolations
- RemoveFlightsFeedItemAttributeValue
- UpdateAdGroup
- UpdateFlightsFeedItemStringAttributeValue
- UsePortfolioBiddingStrategy
-
v3.2.005 May 2020Release notes
Open source →- Added support for v3_1 of Google Ads API.
- Fixed the field masks to work properly with repeated fields in a message.
- Extended
GoogleAdsService.searchStreamwith an experimental iterator. - Refreshed
ResourceNameswith some types:CurrencyConstant,Ad,AdGroupExtensionSetting,CustomerExtensionSetting,CampaignExtensionSetting. - Added code examples
- AddResponsiveSearchAd
- GetResponsiveSearchAds
- AddHotelCallout
- UpdateExpandedTextAd
- UpdateSitelink
- UpdateSitelinkCampaignExtensionSetting
- AddMerchantCenterDynamicRemarketingCampaign
- ForecastReach
- AddGeoTarget
- RemoveEntireSitelinkCampaignExtensionSetting
- GetAdGroupCriterionCpcBidSimulations
- UploadCallConversion
- ApproveMerchantCenterLink
- SearchForLanguageAndCarrierConstants
- GetCampaignCriterionBidModifierSimulations
- AddCustomerMatchUserList
- Improved code examples
- GetAccountHierarchy
- AddCompleteCampaignsUsingMutateJob
- GetAccountBudgets
-
v3.1.002 Mar 2020Release notes
Open source →- Added support for v3_0 of Google Ads API.
- Added support for conversion-typed API errors.
- Added code examples: AddSiteLinks, UploadMediaBundle, UploadImageAsset, UploadConversionAdjustment, ValidateTextAd, AddPrices, AddListingScope, UpdateCampaignCriterionBidModifier, AddAppCampaign.
- Fixed code examples: AddDynamicPageFeed.
- Improved code examples: UploadOfflineConversion, GetArtifactMetadata, AddRemarketingAction.
- Upgraded the Coding Style from PSR-2 to PSR-12 and made the code compliant.
- Upgraded dependencies:
squizlabs/php_codesniffer(^3.5),google/protobuf(^3.11.4).
-
v3.0.016 Dec 2019Release notes
Open source →- Removed support of PHP 7.1.
- Remove the preemptive initialization of "GoogleAdsFailures" when not running with gRPC transport.
- Added code examples: RemoveFlightsFeedItemStringAttributeValue, UpdateFlightsFeedItemStringAttributeValue, RemoveFeedItems, HandleRateExceededError, GetProductBiddingCategoryConstant, AddDemographicTargetingCriteria, AddRemarketingAction and UploadOfflineConversion.
- Fixed code examples: AddHotelAd and GetAccountHierarchy.
-
v2.2.027 Sep 2019Release notes
Open source →- Added support for v2_2 of Google Ads API.
- Added examples for feeds (ad customizer, real estate, flights, Google My Business), negative criteria, image assets and account hierarchy.
- Enhanced error management of mutate operations.
- Added support for monolog 2.0.
-
v2.1.013 Aug 2019Release notes
Open source →- Added support for v2_1 of Google Ads API.
- Switched the default implementation of protobuf to use the C extension and added related documentation.
- Added examples for Google My Business location extensions, Smart display ads and campaign experiments.