googleads/googleads-php-lib

• Added support for v202605.
• Removed support for v202505.
• Removed examples for v202508.
• Removed AudienceExtensionError.

• Added support for v202602.
• Removed support for v202502.
• Removed examples for v202505.

• Added support for v202511.
• Removed support for v202411.
• Removed examples for v202502.

• Added support for v202508.
• Removed support for v202408.
• Removed examples for v202411.

• Added support for v202505.
• Removed support for v202405.
• Removed examples for v202408.

• Added support for v202502.
• Removed support for v202402.
• Removed examples for v202405.

• Added support for v202411.
• Removed support for v202311.
• Removed examples for v202402.

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

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

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

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

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

Ad Manager

• Added support for v202305.
• Removed support for v202205.
• Removed examples for v202208.

Common

• No changes.

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.

AdWords

• No changes.

Ad Manager

• Added support for v202211.
• Removed support for v202111.
• Removed examples for v202202.

Common

• No changes.

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.

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.

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.

AdWords

• No changes.

Ad Manager

• Added support for v202111.
• Removed support for v202011.
• Removed examples for v202102.

Common

• No changes.

AdWords

• No changes.

Ad Manager

• Added support for v202108.
• Removed support for v202008.
• Removed examples for v202011.
• Added RunReachReportWithAdUnitDimensions for v202108.

Common

• No changes.

AdWords

• Upgrade laravel/framework to version 6.20.26 in examples/AdWords/LaravelSampleApp/composer.json.

Ad Manager

• No changes.

Common

• Restore Guzzle 6 support.

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.

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.

AdWords

• Fixed issue #684.

Ad Manager

• No changes.

Common

• No changes.

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.

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.

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.

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.

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.

AdWords

• Added support for ReflectionDocBlock v5.0.

Ad Manager

• No changes.

Common

• Removed phpcs_ruleset.xml and .gitignore from git exports.

AdWords

• Updated the Laravel sample application to use Laravel framework v5.8.

Ad Manager

• No changes.

Common

• No changes.

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.

AdWords

• No changes.

Ad Manager

• Added support for v202002.
• Removed support for v201902.
• Removed examples for v201905.

Common

• Fixed issue #640.
• Fixed issue #637.

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.

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.

AdWords

• No changes.

Ad Manager

• Added support for v201905.
• Removed support for v201805.
• Removed examples for v201808.

Common

• No changes.

AdWords

• Removed support and examples for v201806. See deprecation schedule at: https://developers.google.com/adwords/api/docs/sunset-dates

Ad Manager

• Fixed issue #538.

Common

• Updated composer.json to require the minimum PHP version of 7.1.

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.

AdWords

• Removed support and examples for v201802. See deprecation schedule at: https://developers.google.com/adwords/api/docs/sunset-dates

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.

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.

AdWords

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

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.

AdWords

• Removed support and examples for v201710. See deprecation schedule at: https://developers.google.com/adwords/api/docs/sunset-dates

DFP (currently Ad Manager)

• Added ServiceFactory classes for v201708, v201711, v201802 and v201805.
• Updated examples to use the new ServiceFactory classes.

AdWords

• Added support and examples for v201806.

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.

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.

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.

AdWords

• Added support and examples for v201802.

Common

• Fixed issue #447.

AdWords

• Accepted PR #429.
• Removed support and examples for v201702. See deprecation schedule at: https://developers.google.com/adwords/api/docs/sunset-dates

DFP (currently Ad Manager)

• Accepted PR #438.
• Added support and examples for v201802.
• Removed support for v201702.
• Removed examples for v201705.

Common

• Fixed issue #194.
• Accepted PR #396.
• Accepted PR #415.
• Accepted PR #421.
• Accepted PR #422.
• Fixed issue #426.

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.

AdWords

• Fixed issue #378.

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.

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.

AdWords

• Removed support and examples for v201609. See deprecation schedule at: https://developers.google.com/adwords/api/docs/sunset-dates
• Fixed issue #349.

DFP (currently Ad Manager)

• Added support and examples for v201708.
• Removed examples for v201611.

Common

• Fixed issue #320.

AdWords

• Added support and examples for v201708.
• Fixed issue #331.

Common

• Added a getter for SOAP response header values and SOAP fault message.

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

• Fixed issue #226.
• Fixed issue #244.
• Fixed issue #254.
• Fixed issue #261.
• Fixed issue #292.
• Fixed issue #306.

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.

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.

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.