Skip to content

Latest commit

 

History

History
1073 lines (710 loc) · 27.9 KB

CHANGELOG.md

File metadata and controls

1073 lines (710 loc) · 27.9 KB
Raw

66.0.0

  • Added support for v202408.
  • Removed support for v202308.
  • Removed examples for v202311.
  • Added AdsTxtService in v202408.

65.0.0

  • Added support for v202405.
  • Removed support for v202305.
  • Removed examples for v202308.
  • Removed ActivityService and ActivityGroupService in v202405.
  • Added McmError to all versions.

64.0.0

  • Added support for v202402.
  • Removed support for v202302.
  • Removed examples for v202305.
  • Removed CreativeReviewService in v202402.

63.0.0

  • Added support for v202311.
  • Removed support for v202211.
  • Removed examples for v202302.

62.0.0

  • Added support for v202308.
  • Removed support for v202208.
  • Removed examples for v202211.
  • Added support for PHP 8.2.
  • Removed support for PHP 7.4.

61.0.0

Ad Manager
  • Added support for v202305.
  • Removed support for v202205.
  • Removed examples for v202208.
Common
  • No changes.

60.0.0

AdWords
  • Removed support because the API was sunset. Users should migrate to the new client library google-ads-php to access the new Google Ads API instead.
  • Removed all code examples including the LaravelSampleApp. Users should refer to the new set of code examples of the new client library to access the new Google Ads API instead which also includes a LaravelSampleApp.
Ad Manager
  • Added support for v202302.
  • Removed support for v202202.
  • Removed examples for v202205.
Common
  • Removed support for version 7.3 of the php dependency.
  • Added support for version 3 of the monolog/monolog dependency.
  • Added support for version 6 of the symfony/serializer dependency.
  • Upgraded the minimum version of the guzzlehttp/psr7 dependency to 1.7 and added support for version 2.
  • Migrated the example Auth/GetRefreshToken from OOB. More details can be found here.

59.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v202211.
  • Removed support for v202111.
  • Removed examples for v202202.
Common
  • No changes.

58.0.0

AdWords
  • Removed examples/AdWords/LaravelSampleApp/composer.lock file.
Ad Manager
  • Added support for v202208.
  • Removed support for v202108.
  • Removed examples for v202111.
Common
  • Added support for PHP 8.1.

57.0.0

AdWords
  • Updated examples/AdWords/LaravelSampleApp/composer.lock file.
Ad Manager
  • Added support for v202205.
  • Removed support for v202105.
  • Removed examples for v202108.
  • Removed salesperson split from CreateProposals for v202205.
  • Updated RunInventoryReport to use new Ad Exchange columns for v202205.
  • Regenerated v202202 stubs to include missing SERVING_RESTRICTION dimensions.
Common
  • No changes.

56.0.0

AdWords
  • Updated examples/AdWords/LaravelSampleApp/composer.lock file.
Ad Manager
  • Added support for v202202.
  • Removed support for v202102.
  • Removed examples for v202105.
  • Added YieldGroupService for v202202.
  • Added example to create video creative for v202202.
  • Removed AdExclusionRuleService from v202202.
Common
  • No changes.

55.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v202111.
  • Removed support for v202011.
  • Removed examples for v202102.
Common
  • No changes.

54.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v202108.
  • Removed support for v202008.
  • Removed examples for v202011.
  • Added RunReachReportWithAdUnitDimensions for v202108.
Common
  • No changes.

53.1.0

AdWords
  • Upgrade laravel/framework to version 6.20.26 in examples/AdWords/LaravelSampleApp/composer.json.
Ad Manager
  • No changes.
Common
  • Restore Guzzle 6 support.

53.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v202105.
  • Removed support for v202005.
  • Removed examples for v202008.
  • Updated the CreateProposalLineItems example to use RequestPlatformTargeting instead of marketplace info for v202105.
  • Added a new example for v202105: PushCreativeToDevices.
Common
  • No changes.

52.0.0

AdWords
  • Updated laravel/framework version from 5.8.38 to 6.20.14 in LaravelSampleApp.
Ad Manager
  • Added support for v202102.
  • Removed support for v202002.
  • Removed examples for v202005.
  • Updated the v202102/LineItemService/CreateVideoLineItems.php example to use setVideoMaxDuration function.
Common
  • Updated php version to ^7.3 as a dependency.
  • Added symfony/serializer version ^3.0.3 as a dependency.
  • Updated monolog/monolog version to ^2.2.0 as a dependency.
  • Updated phpunit/phpunit version to ^9.5.2 as a development dependency.
  • Migrated phpunit.xml.dist to comply with phpunit 9.5.2 schema.

51.0.0

AdWords
  • No changes.
Ad Manager
  • Added ext-json to composer.json file for ContentService examples.
  • Added new types in v202011:
    • TimeSeries.php
    • TrafficDataRequest.php
    • TrafficDataResponse.php
    • getTrafficDataResponse.php
    • AuthenticationErrorReason.php
    • CreativeErrorReason.php
    • TrafficForecastSegmentErrorReason.php
Common
  • Added symfony/serializer version ^3.0.3 as a dependency.
  • Updated phpunit/phpunit version to ^9.5.0 as a development dependency.

50.0.1

AdWords
Ad Manager
  • No changes.
Common
  • No changes.

50.0.0

AdWords
  • Fixed the date time format in example GetAccountChanges.php for v201809.
Ad Manager
  • Added support for v202011.
  • Added new examples for v202011: GetTrafficData and GetDefaultThirdPartyDataDeclaration.
  • Removed support for v201911.
  • Removed examples for v202002.
Common
  • No changes.

49.0.0

AdWords
  • No changes.
Ad Manager
  • Fixed issue #675 by replacing an exception with a warning when network code is missing from the adsapi_php.ini file.
Common
  • Fixed issue #679 by updating guzzlehttp/guzzle to version 7.

48.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v202008.
  • Added new examples for v202008: CreateSites, GetAllSites, GetSitesRequiringApproval and GetMcmEarnings.
  • Removed support for v201908.
  • Removed examples for v201911.
Common
  • No changes.

47.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v202005.
  • Added new examples for v202005: CmsMetadataService, UpdateForecastAdjustments and GetForecastAdjustmentsForTrafficForecastSegment.
  • Update CreateTrafficAdjustments.php to become CreateForecastAdjustments example for v202005.
  • Update GetAllTrafficForecastSegments example for v202005.
  • Removed support for v201905.
  • Removed examples for v201908.
Common
  • No changes.

46.2.1

AdWords
  • Updated the composer.json and composer.lock files of Laravel sample application to fix the reported security issue.
Ad Manager
  • No changes.
Common
  • No changes.

46.2.0

AdWords
  • Added support for ReflectionDocBlock v5.0.
Ad Manager
  • No changes.
Common
  • Removed phpcs_ruleset.xml and .gitignore from git exports.

46.1.0

AdWords
  • Updated the Laravel sample application to use Laravel framework v5.8.
Ad Manager
  • No changes.
Common
  • No changes.

46.0.0

AdWords
  • No changes.
Ad Manager
  • Added AdRuleError and AdRuleErrorReason for v202002.
  • Added new report columns for v202002: TOTAL_VIDEO_OPPORTUNITIES, TOTAL_VIDEO_CAPPED_OPPORTUNITIES and DP_ECPM.
  • Removed src/Google/AdsApi/AdManager/Util/v201808 folder.
Common
  • No changes.

45.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v202002.
  • Removed support for v201902.
  • Removed examples for v201905.
Common

44.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v201911.
  • Updated v201911/ReportService/RunReportWithCustomFields.php example to use a reportable custom targeting key as a dimension.
  • Updated v201911/ReportService/RunReachReport.php example to use replacement metrics and compatible dimensions.
  • Updated v201911/ReportService/RunInventoryReport.php example to remove no-op PQL statements.
  • Removed support for v201811.
  • Removed examples for v201902.
Common
  • No changes.

43.0.0

AdWords
  • No changes.
Ad Manager

  • Added support for v201908.

  • Removed support for v201808.

  • Removed examples for v201811.

  • Removed examples from all versions for Sales Management:

    • BaseRateService/GetAllBaseRates
    • BaseRateService/GetBaseRatesForRateCard
    • ExchangeRateService/GetAllExchangeRates
    • ExchangeRateService/GetExchangeRatesForCurrencyCode
    • PackageService/GetAllPackages
    • PackageService/GetInProgressPackages
    • PremiumRateService/GetAllPremiumRates
    • PremiumRateService/GetPremiumRatesForRateCard
    • ProductPackageItemService/GetAllProductPackageItems
    • ProductPackageItemService/GetProductPackageItemsForProductPackage
    • ProductPackageService/GetActiveProductPackages
    • ProductPackageService/GetAllProductPackages
    • ProductService/GetAllProducts
    • ProductService/GetProductsForProductTemplate
    • ProductTemplateService/ActivateProductTemplates
    • ProductTemplateService/CreateProductTemplates
    • ProductTemplateService/CreateProgrammaticProductTemplates
    • ProductTemplateService/GetAllProductTemplates
    • ProductTemplateService/GetSponsorshipProductTemplates
    • ProposalService/CreateProgrammaticProposals
    • ProposalLineItemService/CreateProgrammaticProposalLineItems
    • RateCardService/GetAllRateCards
    • RateCardService/GetMarketplaceRateCards
    • ReconciliationLineItemReportService/GetReconciliationLineItemReportsForReconciliationReport
    • ReconciliationLineItemReportService/UpdateReconciliationLineItemReports
    • ReconciliationOrderReportService/GetReconciliationOrderReportsForReconciliationReport
    • ReconciliationOrderReportService/SubmitReconciliationOrderReports
    • ReconciliationReportRowService/GetReconciliationReportRowsForReconciliationReport
    • ReconciliationReportRowService/UpdateReconciliationReportRows
    • ReconciliationReportService/GetAllReconciliationReports
    • ReconciliationReportService/GetReconciliationReportForLastBillingPeriod
    • WorkflowRequestService/ApproveWorkflowApprovalRequests
    • WorkflowRequestService/GetWorkflowApprovalRequests
    • WorkflowRequestService/GetWorkflowExternalConditionRequests
    • WorkflowRequestService/TriggerWorkflowExternalConditionRequests

  • Converted ProposalService examples:

    • GetProposalsPendingApproval to GetProposalsAwaitingSellerReview
    • CreateProgrammaticProposalsForNonSalesManagement to CreateProposals

  • Converted ProposalLineItemService example:

    • CreateProgrammaticProposalLineItemsForNonSalesManagement to CreateProposalLineItems
Common
  • No changes.

42.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v201905.
  • Removed support for v201805.
  • Removed examples for v201808.
Common
  • No changes.

41.0.0

AdWords
Ad Manager
Common
  • Updated composer.json to require the minimum PHP version of 7.1.

40.0.0

AdWords
  • No changes.
Ad Manager
  • Added support for v201902.
  • Updated RunInventoryReport example to replace deprecated metrics.
  • Added examples for AdjustmentService and CmsMetadataService.
  • Removed support for v201802.
  • Removed examples for v201805.
Common
  • Refactored GuzzleLogMessageHandler and GuzzleLogMessageFormatter so tests can be added to cover the cases when a response body is logged.

39.0.0

AdWords
Ad Manager
  • Added CreateVideoLineItems example for v201811.
  • Fixed null pointer exception when the getAllNetworks function returns null in the GetAllNetworks examples for v201811, v201808 and v201805.
Common
  • Updated GuzzleLogMessageHandler to support both logging response body.
  • Updated composer.json to require the minimum PHP version of 5.6.

38.0.0

AdWords
  • Added Smart Shopping ad example (v201809).
  • Fixed issue #541.
Ad Manager
  • Added support for v201811.
  • Removed support for v201711.
  • Removed examples for v201802.
  • Updated the Util/v201811/AdManagerDateTimes.php class for renaming the function setTimeZoneID to setTimeZoneId.
  • Discontinue the GetAllContentMetadataKeyHierarchies.php example.

37.1.0

AdWords
  • Added support and examples for v201809.
  • Fixed issue #527.

37.0.0

AdWords
  • Added a sample application to demonstrate how to use the AdWords API with the Laravel framework. The location of the sample application is examples/AdWords/LaravelSampleApp/.
Ad Manager
  • Rename files, classes and variables to replace DFP with Ad Manager. For detailed changes, please refer to the migration guide.
  • Added support and examples for v201808.
  • Removed examples for v201711.
  • Removed support for v201708.
Common
  • No changes.

36.0.0

AdWords
DFP (currently Ad Manager)
  • Added ServiceFactory classes for v201708, v201711, v201802 and v201805.
  • Updated examples to use the new ServiceFactory classes.

35.2.0

AdWords
  • Added support and examples for v201806.

35.1.0

DFP (currently Ad Manager)
  • Added ContentFilterError, ContentFilterErrorReason for all versions. These classes are for deserializing server errors.
  • Added UserConsentEligibility and updated LineItem, LineItemSummary for v201805 to make line items ineligible for non-personalized ad requests.

35.0.0

AdWords
  • Added QueryValidator for v201802 to validate parts of an AWQL string.
  • Added unit tests for ServiceQueryBuilder, ReportQueryBuilder and supporting classes for v201802.
  • Fixed issue #473.
DFP (currently Ad Manager)
  • Added DaiAuthenticationKeyService for creating, updating and retrieving DaiAuthenticationKey objects.
  • Added support and examples for v201805.
  • Removed support for v201705.
  • Removed examples for v201708.

34.0.0

AdWords
  • Removed support and examples for v201705 and v201708. See deprecation schedule at: https://developers.google.com/adwords/api/docs/sunset-dates
  • Added ServiceQueryBuilder for v201802 to support building AWQL strings for querying AdWords API services.
  • Added ReportQueryBuilder for v201802 to support building AWQL strings for downloading AdWords API reports.
DFP (currently Ad Manager)
  • Added new examples for managing user-team associations: CreateUserTeamAssociations, UpdateUserTeamAssociations and DeleteUserTeamAssociations.

33.1.0

AdWords
  • Added support and examples for v201802.

33.0.1

Common

33.0.0

AdWords
DFP (currently Ad Manager)
  • Accepted PR #438.
  • Added support and examples for v201802.
  • Removed support for v201702.
  • Removed examples for v201705.
Common

32.1.0

DFP (currently Ad Manager)

  • Added examples for v201711:

    • InventoryService\GetAdUnitHierarchy
    • InventoryService\GetTopLevelAdUnits
    • LineItemService\CreateLineItemsWithCustomCriteria
    • NetworkService\GetCurrentNetwork
    • NetworkService\MakeTestNetwork
    • PublisherQueryLanguageService\GetAllLineItems
    • PublisherQueryLanguageService\GetAllProgrammaticBuyers
    • PublisherQueryLanguageService\GetGeoTargets
    • ReportService\RunReachReport
    • ReportService\RunReportWithCustomFields
    • TeamService\UpdateTeams
    • UserService\GetCurrentUser
    • UserService\UpdateUsers

  • Added utility class CsvFiles for v201711.

Common
  • Fixed issue #399.
  • Fixed the issue that a wrong path to local WSDL files was specified in AdsSoapClient.
  • Accepted PR #401.

32.0.0

AdWords
DFP (currently Ad Manager)
  • Added support and examples for v201711.
  • Added CdnConfigurationService and examples.
  • Removed support for v201611.
  • Removed examples for v201702.
Common
  • Included WSDL files for all SOAP services and they're now used for making SOAP calls instead of live WSDLs. Therefore, the WSDL caching feature is deprecated (wsdlCache in adsapi_php.ini is now ignored). The feature will be removed completely in the next major release.

31.0.0

AdWords
  • Added support and examples for v201710.
  • Added an option for setting transparent HTTP gzip compression for reporting in adsapi_php.ini.
DFP (currently Ad Manager)
  • Added UpdateLineItems and UpdateOrders examples.
Common
  • Removed the PROXY section in adsapi_php.ini. Use "proxy" under CONNECTION instead.
  • Added proxy support for non-SOAP utilities and OAuth authentication. See the CONNECTION section in adsapi_php.ini for details.

30.0.0

AdWords

29.0.0

DFP (currently Ad Manager)
  • Added support and examples for v201708.
  • Removed examples for v201611.
Common

28.1.0

AdWords
  • Added support and examples for v201708.
  • Fixed issue #331.
Common
  • Added a getter for SOAP response header values and SOAP fault message.

28.0.0

AdWords
  • Added support for redacting access tokens in SOAP body.
  • Added support for overriding report settings in each report download request.
  • Fixed issue #247.
Common

27.1.0

AdWords
  • Added support and examples for v201705.
  • Removed support for AdWords Express (AWX) API.
  • Updated AddShoppingCampaign.php to include an option of creating an optional default partition.
Common
  • Fixed issues #287 and #298 related to too many open file descriptors.

27.0.0

DFP (currently Ad Manager)
  • Added support and examples for v201705.
Common
  • Added GuzzleLogMessageFormatter and refactored the Guzzle logging handler.
  • Made user agents sent by non-SOAP utilities more informative.

26.0.0

AdWords
  • Added support for specifying addtional request options for reporting.
  • Fixed issue #246.
  • Accepted PR #251.
  • Accepted PR #253.
  • Accepted PR #256.
  • Updated AddSiteLinksUsingFeeds examples to use field and constant names that are consistent with the field names of SitelinkFeedItem.
Common
  • Added AdsGuzzleHttpClientFactory to create Guzzle HTTP clients for non-SOAP calls.

25.4.0

DFP (currently Ad Manager)
  • Added perform action examples for core services.
  • Added CreateNativeCreatives example.
  • Fixed the CreateProposals example.
  • Added some update examples for reconciliation services.

25.3.0

AdWords
DFP (currently Ad Manager)
  • Fixed [issue #238] (#238).
  • Fixed an unmarshalling issue with ApiError.
  • Added create examples for core services.
Common
  • Added support for impersonation when using service accounts.

25.2.0

DFP (currently Ad Manager)
  • Added support and examples for v201702.
Common

25.1.0

AdWords
DFP (currently Ad Manager)
  • Accepted PR #195.
  • Added RunSavedQuery.php reporting example.
  • Added RunDeliveryReportForOrder.php reporting example.
  • Added forecast service examples.
Common

25.0.0

AdWords
  • Added support and examples for v201609.
  • Removed support and examples for v201607.
  • Fixed issue #168.
  • Fixed issue #175.
  • Fixed issue #181.
  • Refactored how to specify what format a report is downloaded in ReportDownloader by introducing ReportDownloadResult.
  • Added support for including utility usage in the user agent header.
DFP (currently Ad Manager)
  • Added support and examples for v201611.
  • Removed support and examples for v201608.
  • Renamed DateTimeUtils to DfpDateTimes and refactored some of its methods to make it easier to understand and use.
Common
  • Library is now stable and no longer in beta. See the Upgrading guide for details on how to upgrade.
  • Fixed the issue that some enum values whose names conflict with PHP reserved keywords were generated by prepending "a", e.g., "aDEFAULT". They are now generated by appending "VALUE", e.g., "DEFAULT_VALUE".
  • Removed __default const from all generated pseudo-enum classes as it's not necessary.
  • Fixed issue #173.
  • Refactored logging to support logging to different channels. There is now a SOAP logger, as well as other product-specific loggers.
  • Added convenience config options for core AdWords and DFP loggers to setup logging to a specified file.
  • Fixed issue #187.
  • Relaxed all library dependencies to use ^ instead of ~.
  • Various internal utility refactoring to make utilities clearer in what they do and easier to understand.

1.4.0-beta

AdWords
  • Added support and examples for v201607.
  • Removed support and examples for v201605.
  • User agent is now optional. If no user agent is specified, 'unknown' will be passed instead. If provided, user agent must contain US-ASCII characters only.
  • Added BatchJobs to support batch processing using BatchJobService (issue #145).
  • Added some examples for v201607.
DFP (currently Ad Manager)
  • Added support and examples for v201608.
  • Removed support and examples for v201602.

1.3.1-beta

DFP (currently Ad Manager)
  • Added v201602 retrieval examples.
Common

1.3.0-beta

AdWords
  • Added report downloader utility.
  • Added support and examples for v201605.
  • Removed support and examples for v201603.
  • Added support for reporting request header useRawEnumValues.

1.2.0-beta

Common
  • Added a GetRefreshToken.php example that helps you generate an OAuth2 offline refresh token for installed application flows.

1.1.0-beta

AdWords
  • Added support for v201603.
  • Removed support for v201601.
DFP (currently Ad Manager)
  • Added support for v201602.
  • Removed support for v201511.
  • The report downloader utility now uses Guzzle, instead of Curl, to make HTTP requests.
Common
  • OAuth2 is now handled by the Google PHP Auth Library.
  • OAuth2 service accounts are now supported and JSON key credentials can be loaded from the adsapi_php.ini file.
  • SSL peer verification is now enabled by default for SOAP requests.
  • Instances of ApiException are now thrown from services if there was a SOAP fault, instead of PHP's generic SoapFault.

1.0.0-beta

Common
  • Initial release.