File "CHANGELOG.md"
Full Path: /home/warrior1/public_html/wp-content/plugins/google-listings-and-ads/vendor/googleads/google-ads-php/CHANGELOG.md
File size: 18 KB
MIME-type: text/plain
Charset: utf-8
## 16.0.0
* 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`.
## 15.1.0
* Added support for v11 of Google Ads API.
* Added support for version 3 of [`monolog/monolog`](https://github.com/Seldaek/monolog).
* Fixed dependabot alert in `examples/LaravelSampleApp/composer.lock`.
* Added code examples:
* CreateExperiment
* DetectAndApplyRecommendations
* Removed code examples:
* CreateCampaignExperiment
* GraduateCampaignExperiment
* Updated code examples:
* AddSmartCampaign
* GenerateUserCredentials
## 15.0.0
* 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](https://developers.googleblog.com/2022/02/making-oauth-flows-safer.html?m=1#disallowed-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](https://github.com/googleads/google-ads-php/issues/761).
* Fixed dependabot alert in `examples/LaravelSampleApp/composer.lock`.
* Added code examples:
* AddPerformanceMaxProductListingGroupTree
* Updated code examples:
* AddCampaigns
* AddCustomerMatchUserList
* AddDynamicRemarketingAsset
* AddPerformanceMaxCampaign
* AddPerformanceMaxRetailCampaign
* GetChangeDetails
* NavigateSearchResultPagesCachingTokens
* UploadOfflineConversion
## 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](https://developers.google.com/google-ads/api/docs/best-practices/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](
https://developers.google.com/google-ads/api/docs/client-libs/php/performance#unused_versions)
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](https://github.com/protocolbuffers/protobuf/blob/master/docs/field_presence.md).
* 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](https://github.com/googleads/google-ads-php/pull/120)).
* Set max response message and metadata size ([#127](https://github.com/googleads/google-ads-php/pull/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.