PackageTrack
Sign in Get early access

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
Release Pre-release

Releases

latest 60 of 74
  1. v34.0.0 19 Aug 2026
    Release notes
    • Added support for Google Ads API v25.1
    • Removed support for Google Ads API v20 and v21
    Open source →
  2. v33.6.0 22 Jul 2026
    Release notes
    • 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.
    Open source →
  3. v33.5.0 24 Jun 2026
    Release notes
    • Added support for Google Ads API v24.2
    • Resolved ongoing Laravel security vulnerabilities
    • Updated Docker build images
    Open source →
  4. v33.4.0 13 May 2026
    Release notes
    • Added support for Google Ads API v24.1
    • Resolved Laravel sample app security vulnerabilities
    Open source →
  5. v33.3.0 22 Apr 2026
    Release notes
    • Added support for Google Ads API v24
    • Dependency updates
    • Resolved Laravel sample app security vulnerabilities
    • Removed grpc/grpc maximum version constraint
    Open source →
  6. v32.3.0 25 Mar 2026
    Release notes
    • Support for Google Ads API v23.2.
    • Incorporated generator updates (new 'actions' directory, Protobuf changes).
    • Dependency updates.
    Open source →
  7. v32.2.0 25 Feb 2026
    Release notes
    • 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.
    Open source →
  8. v32.1.0 28 Jan 2026
    Release notes
    • Added support for Google Ads API v23.
    • Removed support for Google Ads API v19.
    • Updated examples in examples in AddCampaigns, AddDynamicSearchAds, AddPerformanceMaxCampaign, AddPerformanceMaxRetailCampaign, and AddAppCampaign.
    • Removed the AddCallAd.php example as Call Ads are no longer supported in the API.
    • Changed the default value of the brandGuidelinesEnabled parameter to true in AddPerformanceMaxCampaign and AddPerformanceMaxRetailCampaign examples.
    • Ensured deprecated salesCountry parameter is not used in AddPerformanceMaxRetailCampaign example.
    • Updated dependencies via composer update.
    Open source →
  9. v31.1.0 15 Oct 2025
    Release notes

    Supports Ads API v22 for users still on PHP 7.4

    Open source →
    Release notes
    • Added support for Google Ads API V22.
    • Updated generated code for Google Ads API V21 to include recent fixes.
    • Updated examples/AdvancedOperations/AddPerformanceMaxCampaign.php and examples/ShoppingAds/AddPerformanceMaxRetailCampaign.php:
    • Examples now use Google Ads API V22.
    • Replaced deprecated url_expansion_opt_out field with AssetAutomationSettings to control URL expansion and text asset automation.
    Open source →
  10. v31.0.1 22 Aug 2025
    Release notes
    • Updated protobuf constraint in to be less restrictive for users on the Protobuf 3.x series and preserve backwards compatibility.
    Open source →
  11. v31.0.0 06 Aug 2025
    Release notes
    • 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
    Open source →
  12. v30.0.0 21 Jul 2025
    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 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
    Open source →
  13. v29.0.0 27 Jun 2025
    Release notes
    • Security fixes, updated deprecated getLabel to isRepeated.
    Open source →
  14. v28.0.0 04 Jun 2025
    Release notes
    • Compatibility with v20.0 of the API: https://developers.google.com/google-ads/api/docs/release-notes
    Open source →
  15. v27.2.0 14 May 2025
    Release notes
    • Removed support for v17 of the API: https://ads-developers.googleblog.com/2025/04/google-ads-api-v17-sunset-reminder.html
    Open source →
  16. v26.2.0 18 Apr 2025
    Release notes
    • Compatibility with v19.1 of the API: https://developers.google.com/google-ads/api/docs/release-notes
    Open source →
  17. v26.1.0 27 Feb 2025
    Release notes
    • 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
    Open source →
  18. v26.0.0 05 Feb 2025
    Release notes
    • Removed support for v16 of Google Ads API.
    Open source →
  19. v25.0.0 18 Oct 2024
    Release notes
    • Added support for v18 of Google Ads API.
    • Removed support for the useGapicV2Source configuration, as the source code of all versions are generated as GAPIC v2.
      • Fixed the LaravelSampleApp to use GAPIC v2.
    • Updated code examples:
      • GetAllDisapprovedAds
      • HandlePartialFailure
    Open source →
  20. v24.0.0 09 Aug 2024
    Release notes
    • 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.
    Open source →
  21. v23.1.0 07 Jun 2024
    Release notes
    • 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
    Open source →
  22. v23.0.1 30 Apr 2024
    Release notes
    • Re-generated the source code for v16_1 of Google Ads API to add some missing classes and enum values.
    Open source →
  23. v23.0.0 25 Apr 2024
    Release notes
    • Added support for v16_1 of Google Ads API.
    • Removed support for v14 of Google Ads API.
    • Added support for google/protobuf v4.26.
    • Updated composer.json to 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.json of LaravelSampleApp.
    • Added VerifyAdvertiserIdentity example.
    • Updated code examples:
      • AddCompleteCampaignsUsingBatchJob
      • DetectAndApplyRecommendations
      • DismissRecommendation
      • UploadConversionAdjustment
    • Removed code examples:
      • AddFlightsFeed
      • AddRealEstateFeed
      • ApplyRecommendation
      • ApproveMerchantCenterLink
      • DismissRecommendation
      • RejectMerchantCenterLink
    Open source →
  24. v22.1.1 24 May 2024

    Nothing published for this version

  25. v22.1.0 23 Feb 2024
    Release notes
    • Added support for v16 of Google Ads API.
    • Fixed dependabot alert in examples/LaravelSampleApp/composer.lock.
    • Renamed examples/Extensions to examples/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
    Open source →
  26. v22.0.0 24 Jan 2024
    Release notes
    • Removed support for v13 of Google Ads API.
    • Added more methods to ResourceNames of v14 and v15.
    • Updated GoogleAdsFailuresInterceptorTest.php and GoogleAdsLoggingInterceptorTest to make them work with the latest version of google/gax.
    • Updated code examples:
      • AddFlexibleRuleUserList
      • AddShoppingProductAd
      • UploadOfflineConversion
    Open source →
  27. v21.1.0 19 Oct 2023
    Release notes
    • 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 useCloudOrgForApiAccess config. This is in preparation for the pilot that uses Google Cloud orgs for API Access levels.
    • Updated InfoRedactor to 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_country field is removed:
      • AddMerchantCenterDynamicRemarketingCampaign
      • AddPerformanceMaxRetailCampaign
      • AddShoppingProductAd
    Open source →
  28. v21.0.1 29 Sep 2023
    Release notes
    Open source →
  29. v21.0.0 20 Sep 2023
    Release notes
    • Removed support for v12 of Google Ads API.
    • Use the GAPIC v2 source code in ResourceNames and ServiceClientFactoryTrait of 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.
    Open source →
  30. v20.1.0 10 Aug 2023
    Release notes
    • Added support for v14_1 of Google Ads API.
    • Removed the final modifier from GoogleAdsClient. 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-id to the header of a request.
    • Made GoogleAdsCallLogger::getNextFinerLogLevel aligned with PSR-3 LogLevel enum 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 useGapicV2Source configuration.
      • Updated all code examples to show how to use the GAPIC v2 source code.
    • Added code examples:
      • GenerateForecastMetrics (new version that uses KeywordPlanIdeaService)
      • GenerateHistoricalMetrics (new version that uses KeywordPlanIdeaService)
    • Removed AddKeywordPlan example.
    Open source →
  31. v20.0.0 07 Jul 2023
    Release notes
    • Updated composer.json to require the minimum PHP version of 8.0. See also README for more details.
    • Updated the minimum required version of google/gax to 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.
    Open source →
  32. v19.2.0 08 Jun 2023
    Release notes
    • Added support for v14 of Google Ads API.
    • Updated AddPerformanceMaxForTravelGoalsCampaign example.
    • Removed code examples:
      • GenerateForecastMetrics
      • GenerateHistoricalMetrics
      • GetCampaignCriterionBidModifierSimulations
    Open source →
  33. v19.1.0 27 Apr 2023
    Release notes
    • Added support for v13_1 of Google Ads API.
    • Renamed the HotelAds example directory to Travel.
    • Added AddThingsToDoAd example.
    • Updated AddPerformanceMaxForTravelGoalsCampaign example.
    Open source →
  34. v19.0.0 20 Mar 2023
    Release notes
    • Removed support for v11 of Google Ads API.
    • Updated CreateExperiment example.
    Open source →
  35. v18.0.0 22 Feb 2023
    Release notes
    • 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
    Open source →
  36. v17.1.0 03 Nov 2022
    Release notes
    • 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
    • Updated code examples:
      • AddPerformanceMaxRetailCampaign
      • AddSmartCampaign
      • CreateExperiment
      • ForecastReach
    Open source →
  37. v17.0.0 18 Aug 2022
    Release notes
    • 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/protobuf to 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
    Open source →
  38. v16.0.0 19 Jul 2022
    Release notes
    • 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/gax to 1.13.0.
    • Renamed a code example GetArtifactMetadata to SearchForGoogleAdsFields.
    • Updated code examples:
      • GenerateUserCredentials
      • SetCustomClientTimeouts
    • Fixed dependabot alert in examples/LaravelSampleApp/composer.lock.
    Open source →
  39. v15.1.0 16 Jun 2022
    Release notes
    • 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
    Open source →
  40. v15.0.0 28 Apr 2022
    Release notes
    • Added support for v10_1 of Google Ads API.
    • Removed support for v8 of Google Ads API.
    • Combined two examples in Authentication/ into GenerateUserCredentials, since OAuth OOB is being deprecated.
    • Updated Dockerfile to use the latest stable version of Apache PHP by default.
    • Updated examples/Migration/composer.json and 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
    Open source →
  41. v14.0.0 15 Feb 2022
    Release notes
    • 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 GoogleAdsMetadataTrait of all versions.
    • Updated composer.json and composer.lock of LaravelSampleApp.
    • Updated the minimum required version of google/protobuf to 3.19.4.
    • Added code examples:
      • AddCall
      • AddCallAd
      • AddDynamicPageFeedAsset
      • AddDynamicRemarketingAsset
      • NavigateSearchResultPagesCachingTokens
    • Updated code examples:
      • AddDisplayUploadAd
      • AddPerformanceMaxCampaign
      • AddPerformanceMaxRetailCampaign
      • GetAccountInformation
      • GetKeywords
      • UploadConversionWithIdentifiers
      • UploadImageAsset
    Open source →
  42. v13.0.0 10 Dec 2021
    Release notes
    • Updated composer.json to 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
    Open source →
  43. v12.1.0 12 Nov 2021
    Release notes
    • Added support for v9 of Google Ads API.
    • Added grpc and protobuf extensions to require-dev of composer.json.
    • Added support for conversion adjustments in GoogleAdsError.
    • Updated composer.json of 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 enableWarnings mode of OfflineUserDataJobService. See the Warnings guide for details.
    Open source →
  44. v12.0.0 28 Sep 2021
    Release notes
    • Added support for sending the library name and version with each request.
    • Updated the minimum required version of google/protobuf to 3.18.0.
    • Updated composer.json and composer.lock of LaravelSampleApp.
    • Added code examples:
      • AddBiddingDataExclusion
      • AddBiddingSeasonalityAdjustment
    • Fixed code examples:
      • AddDisplayUploadAd
      • AddLocalCampaign
      • AddMerchantCenterDynamicRemarketingCampaign
      • AddSmartDisplayAd
      • UploadImage
      • UploadImageAsset
      • UploadMediaBundle
    Open source →
  45. v11.0.0 13 Aug 2021
    Release notes
    • Added support for v8_1 of Google Ads API.
    • Added 1.26 to the minimum required version constraints of the monolog/monolog dependency.
    • 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.
    Open source →
  46. v10.1.0 02 Jul 2021
    Release notes
    • Moved the CampaignReportToCsv example to the Migration/ directory.
    • Added the LIMIT clause to the query of the GetAdGroupBidModifiers example.
    Open source →
  47. v10.0.0 16 Jun 2021
    Release notes
    • 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
    • Added support for removing unused Google Ads API versions. See this guide for details.
    • Updated the minimum required versions of google/protobuf to 3.17.1.
    • Added code examples:
      • AddSmartCampaign
      • UseCrossAccountBiddingStrategy
    • Fixed/improved code examples:
      • RemoveEntireSitelinkCampaignExtensionSetting
      • UpdateSitelinkCampaignExtensionSetting
      • UploadStoreSalesTransactions
    Open source →
  48. v9.0.0 06 May 2021
    Release notes
    • 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
    Open source →
  49. v8.1.0 05 Apr 2021
    Release notes
    • Added missing 'null' type hints in the package src/Google/Ads/GoogleAds/v6/.
    • Updated code examples:
      • AddCampaignTargetingCriteria
      • AddDynamicPageFeed
      • AddSitelinks
      • CreateCustomer
      • GetGeoTargetConstantsByNames
      • UploadStoreSalesTransactions
    Open source →
  50. v8.0.0 18 Mar 2021
    Release notes
    • Added support for PHP 8.0.
    • Updated the minimum required versions of google/gax, grpc/grpc and google/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.
    • Makes the examples directory and its dependency belong to dev in composer.json. This makes the size of the downloaded source code lighter.
    • Refactored ResourceNames.php and ServiceClientFactoryTrait.php.
    • Fixed code examples:
      • GetAdGroupBidModifier
      • ValidateTextAd
    Open source →
  51. v7.0.0 19 Feb 2021
    Release notes
    • Added support for v6_1 of Google Ads API.
    • Removed support for v3 of Google Ads API.
    • Updated composer.json to 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
    Open source →
  52. v6.1.0 11 Dec 2020
    Release notes
    • 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 in composer.json accordingly.
    • Added support for PHPUnit 9.3.
    • Added print_php_information for printing information about installed extensions.
    • Added code examples:
      • GetInvoices
      • SetupRemarketing
      • SetupAdvancedRemarketing
    Open source →
  53. v6.0.0 16 Nov 2020
    Release notes
    • 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.
    Open source →
  54. v5.0.0 01 Sep 2020
    Release notes
    • 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
    Open source →
  55. v4.0.0 13 Jul 2020
    Release notes
    • 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-id header for v4.
    • Added more tests to increase code coverage.
    • Fixed some test data.
    • Renamed AddCompleteCampaignsUsingMutateJob to AddCompleteCampaignsUsingBatchJob to reflect a new name in v4.
    • Added code examples:
      • AddDisplayUploadAd
      • AddSitelinksUsingFeeds
    • Fixed/improved code examples:
      • AddDynamicPageFeed
      • GenerateKeywordIdeas
      • HandleExpandedTextAdPolicyViolations
      • HandleKeywordPolicyViolations
      • RemoveFlightsFeedItemAttributeValue
      • UpdateAdGroup
      • UpdateFlightsFeedItemStringAttributeValue
      • UsePortfolioBiddingStrategy
    Open source →
  56. v3.2.0 05 May 2020
    Release notes
    • Added support for v3_1 of Google Ads API.
    • Fixed the field masks to work properly with repeated fields in a message.
    • Extended GoogleAdsService.searchStream with an experimental iterator.
    • Refreshed ResourceNames with 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
    Open source →
  57. v3.1.0 02 Mar 2020
    Release notes
    • 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).
    Open source →
  58. v3.0.0 16 Dec 2019
    Release notes
    • 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.
    Open source →
  59. v2.2.0 27 Sep 2019
    Release notes
    • 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.
    Open source →
  60. v2.1.0 13 Aug 2019
    Release notes
    • 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.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive