Skip to content

Latest commit

 

History

History
415 lines (372 loc) · 16.1 KB

CHANGELOG.md

File metadata and controls

415 lines (372 loc) · 16.1 KB
Raw

14.0.0

  • 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

13.0.0

  • 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

12.1.0

  • 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.

12.0.0

  • 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

11.0.0

  • 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.

10.1.0

  • Moved the CampaignReportToCsv example to the Migration/ directory.
  • Added the LIMIT clause to the query of the GetAdGroupBidModifiers example.

10.0.0

  • 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

9.0.0

  • 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

8.1.0

  • Added missing 'null' type hints in the package src/Google/Ads/GoogleAds/v6/.
  • Updated code examples:
    • AddCampaignTargetingCriteria
    • AddDynamicPageFeed
    • AddSitelinks
    • CreateCustomer
    • GetGeoTargetConstantsByNames
    • UploadStoreSalesTransactions

8.0.0

  • 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

7.0.0

  • 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

6.1.0

  • 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

6.0.0

  • 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.

5.0.0

  • 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

4.0.0

  • 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

3.2.0

  • 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

3.1.0

  • 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).

3.0.0

  • 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.

2.2.0

  • 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.

2.1.0

  • 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.

2.0.0

  • Added support for v2 of Google Ads API.
  • Renamed the getter and setter functions for unwrapped values from getXXXValue/setXXXValue to getXXXUnwrapped/setXXXUnwrapped to prevent them from clashing with other field names.
  • Added a test to instantiate all classes in the codebase to make sure there are no syntax errors.
  • Upgraded dependencies.

1.4.1

  • Fixed logging level configuration (#120).
  • Set max response message and metadata size (#127).

1.4.0

  • Added support for more resources in ResourceNames.
  • Added examples for Smart Shopping campaigns, batch processing using MutateJobService, and campaign draft.
  • Increased default deadline to 1 hour and added retry support for GoogleAdsService.search().

1.3.0

  • Added support for v1_3 of Google Ads API.
  • Added examples for ad parameters, campaign labels and media upload and retrieval.

1.2.0

  • Added support for v1_2 of Google Ads API.
  • Added utility functions to convert enum names to integer values and vice versa.
  • Added convenience functions for automatic unboxing of protobuf values, e.g. getNameValue along with the existing getName.
  • Added an example on campaign management migration from the legacy AdWords API.

1.1.0

  • Added support for v1_1 of Google Ads API.
  • Upgraded PHPUnit dependency to v7.5.
  • Added support for partial failures and matching example.

1.0.0

  • Added support and examples for v1_0 of Google Ads API.
  • Updated some dependencies, e.g., google/gax 0.38.0 and ulrichsg/getopt-php 3.2.2.
  • Updated some examples to match the new API specifications, e.g., GetHotelAdsPerformance.
  • Fixed a bug that prevented the login-customer-id header from being sent.

0.7.0

  • Added support and examples for v0_7 of Google Ads API.
  • Updated some examples to match the new API specifications, e.g., ApplyRecommendation, DismissRecommendation, GetKeywordStats, AddCampaignBidModifier.
  • Added GetHotelAdsPerformance example.
  • Removed AddCampaignGroup example.

0.6.0

  • Added support and examples for v0_6 of Google Ads API.
  • Added support for passing log-in customer ID with API requests.
  • Updated some examples to match the new API specifications, e.g., ApplyRecommendations.php, GetGeoTargetConstantByNames.php.
  • Updated AddCampaignTargetingCriteria example to show how to include proximity targeting.

0.5.0

  • Added support and examples for v0_5 of Google Ads API.
  • Added campaign targeting criteria examples.
  • Added an account budget example.
  • Added Shopping campaign examples.
  • Added an account change example.

0.4.0

  • Added support and examples for v0_4 of Google Ads API.
  • Added account budget proposal and billing setup examples.
  • Added conversion action examples.
  • Added an example showing how to retrieve disapproved ads.

0.3.0

  • Added support and examples for V0_3 of Google Ads API.
  • Updated GetArtifactMetadata to quote the name param value.
  • Updated examples to initialize properties via constructors instead of setters.
  • Added examples showing how to add and get ad group bid modifiers.
  • Added an example showing how to create and attach shared keyword sets.
  • Added an example showing how to remove shared set criteria.
  • Updated hotel ad group bid modifier example with v0_3 criteria changes.
  • Added AddCampaignBidModifier example.

0.2.0

  • Added support for V0_2 of Google Ads API, which includes the Percent CPC bidding strategy.

0.1.0

  • Initial release with support for V0_1 of Google Ads API.