Release 37.0.0.

Author: Thang Duong

CHANGELOG.md

@@ -1,11 +1,30 @@
+### 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/`](https://github.com/googleads/googleads-php-lib/tree/master/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](https://github.com/googleads/googleads-php-lib/wiki/AdManager-migration).
+*   Added support and examples for v201808.
+*   Removed examples for v201711.
+*   Removed support for v201708.
+
+##### Common
+
+*   No changes.
+
 ### 36.0.0
 
 ##### AdWords
 
 *   Removed support and examples for v201710. See deprecation
     schedule at: https://developers.google.com/adwords/api/docs/sunset-dates
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added `ServiceFactory` classes for v201708, v201711, v201802 and v201805.
 *   Updated examples to use the new `ServiceFactory` classes.
@@ -18,7 +37,7 @@
 
 ### 35.1.0
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added `ContentFilterError`, `ContentFilterErrorReason` for all versions.
     These classes are for deserializing server errors.
@@ -35,7 +54,7 @@
 *   Fixed
     [issue #473](https://github.com/googleads/googleads-php-lib/issues/473).
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added `DaiAuthenticationKeyService` for creating, updating and retrieving
     `DaiAuthenticationKey` objects.
@@ -54,7 +73,7 @@
 *   Added `ReportQueryBuilder` for v201802 to support
     building AWQL strings for downloading AdWords API reports.
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added new examples for managing user-team associations:
     `CreateUserTeamAssociations`, `UpdateUserTeamAssociations`
@@ -81,7 +100,7 @@
 *   Removed support and examples for v201702. See deprecation schedule at:
     https://developers.google.com/adwords/api/docs/sunset-dates
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Accepted [PR #438](https://github.com/googleads/googleads-php-lib/pull/438).
 *   Added support and examples for v201802.
@@ -101,7 +120,7 @@
 
 ### 32.1.0
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added examples for v201711:
     *   InventoryService\GetAdUnitHierarchy
@@ -135,7 +154,7 @@
 *   Fixed
     [issue #378](https://github.com/googleads/googleads-php-lib/issues/378).
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added support and examples for v201711.
 *   Added CdnConfigurationService and examples.
@@ -157,7 +176,7 @@
 *   Added an option for setting transparent HTTP gzip compression for reporting
     in `adsapi_php.ini`.
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added UpdateLineItems and UpdateOrders examples.
 
@@ -179,7 +198,7 @@
 
 ### 29.0.0
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added support and examples for v201708.
 *   Removed examples for v201611.
@@ -241,7 +260,7 @@
 
 ### 27.0.0
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added support and examples for v201705.
 
@@ -270,7 +289,7 @@
 
 ### 25.4.0
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added `perform action` examples for core services.
 *   Added `CreateNativeCreatives` example.
@@ -286,7 +305,7 @@
     [issue #236](https://github.com/googleads/googleads-php-lib/issues/236).
 *   Accepted [PR #196](https://github.com/googleads/googleads-php-lib/pull/196).
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Fixed [issue #238]
     (https://github.com/googleads/googleads-php-lib/issues/238).
@@ -299,7 +318,7 @@
 
 ### 25.2.0
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added support and examples for v201702.
 
@@ -318,7 +337,7 @@
     [issue #206](https://github.com/googleads/googleads-php-lib/issues/206).
 *   Fixed some examples that had issues with printing results.
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Accepted [PR #195](https://github.com/googleads/googleads-php-lib/pull/195).
 *   Added RunSavedQuery.php reporting example.
@@ -346,7 +365,7 @@
     `ReportDownloader` by introducing `ReportDownloadResult`.
 *   Added support for including utility usage in the user agent header.
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added support and examples for v201611.
 *   Removed support and examples for v201608.
@@ -387,14 +406,14 @@
     ([issue #145](https://github.com/googleads/googleads-php-lib/issues/145)).
 *   Added some examples for v201607.
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added support and examples for v201608.
 *   Removed support and examples for v201602.
 
 ### 1.3.1-beta
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added v201602 retrieval examples.
 
@@ -428,7 +447,7 @@
 *   Added support for v201603.
 *   Removed support for v201601.
 
-##### DFP
+##### DFP (currently Ad Manager)
 
 *   Added support for v201602.
 *   Removed support for v201511.

CONTRIBUTING.md

@@ -28,7 +28,7 @@ patches.
 *   Sign a Contributor License Agreement (see above).
 *   Join the appropriate product discussion forum.
     *   AdWords API: https://developers.google.com/adwords/api/community/
-    *   DFP API: https://developers.google.com/doubleclick-publishers/community
+    *   Ad Manager API: https://developers.google.com/ad-manager/community
     *   DFA API:
         https://developers.google.com/doubleclick-advertisers/reporting/community
 *   Create an issue on the library issue tracker if there isn't one already. Use

README.md

@@ -1,7 +1,7 @@
 ## Google Ads API PHP Client Library
 
 This project hosts the PHP client library for the various SOAP-based Ads APIs
-(AdWords and DFP) at Google.
+(AdWords and Ad Manager) at Google.
 
 > Welcome to the new ads API PHP client library!
 >
@@ -40,8 +40,8 @@ This library determines the home directory of your computer by using
 
 *   [AdWords
     adsapi_php.ini](https://github.com/googleads/googleads-php-lib/blob/master/examples/AdWords/adsapi_php.ini)
-*   [DFP
-    adsapi_php.ini](https://github.com/googleads/googleads-php-lib/blob/master/examples/Dfp/adsapi_php.ini)
+*   [Ad Manager
+    adsapi_php.ini](https://github.com/googleads/googleads-php-lib/blob/master/examples/AdManager/adsapi_php.ini)
 
 ### Downloading this library
 
@@ -131,7 +131,7 @@ client library. The extracted directory of the tarball will contain only the
 
 ### Setting up your OAuth2 credentials
 
-The AdWords and DoubleClick for Publishers APIs use
+The AdWords and Ad Manager APIs use
 [OAuth2](https://oauth.net/2/) as the authentication mechanism. Follow the
 appropriate guide below based on your use case.
 
@@ -140,12 +140,12 @@ appropriate guide below based on your use case.
 *   [Using
     AdWords](https://github.com/googleads/googleads-php-lib/wiki/API-access-using-own-credentials-\(installed-application-flow\))
 *   [Using
-    DFP](https://github.com/googleads/googleads-php-lib/wiki/API-access-using-own-credentials-\(server-to-server-flow\))
+    Ad Manager](https://github.com/googleads/googleads-php-lib/wiki/API-access-using-own-credentials-\(server-to-server-flow\))
 
 **If you're accessing an API on behalf of clients...**
 
 *   [Using AdWords or
-    DFP](https://github.com/googleads/googleads-php-lib/wiki/API-access-on-behalf-of-your-clients-\(web-flow\))
+    Ad Manager](https://github.com/googleads/googleads-php-lib/wiki/API-access-on-behalf-of-your-clients-\(web-flow\))
 
 ### Basic usage
 
@@ -154,8 +154,8 @@ product.
 
 *   [AdWords
     examples](https://github.com/googleads/googleads-php-lib/blob/master/examples/AdWords)
-*   [DFP
-    examples](https://github.com/googleads/googleads-php-lib/blob/master/examples/Dfp)
+*   [Ad Manager
+    examples](https://github.com/googleads/googleads-php-lib/blob/master/examples/AdManager)
 
 > All our examples are meant to be run via the command line and not through a
 > webpage.
@@ -168,7 +168,7 @@ product.
 
 The following snippet of code from the **BasicOperations/GetCampaigns.php**
 example for AdWords gives you an idea of how to use this library. The usage
-pattern is similar for DFP.
+pattern is similar for Ad Manager.
 
 ```php
 use Google\AdsApi\AdWords\AdWordsServices;
@@ -220,7 +220,7 @@ builders instead to set the same information. See the builders for details:
 
 *   [OAuth2TokenBuilder](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/Common/OAuth2TokenBuilder.php)
 *   [AdWordsSessionBuilder](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/AdWords/AdWordsSessionBuilder.php)
-*   [DfpSessionBuilder](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/Dfp/DfpSessionBuilder.php)
+*   [AdManagerSessionBuilder](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/AdManager/AdManagerSessionBuilder.php)
 
 ### WSDL objects with names that are reserved PHP keywords
 
@@ -252,7 +252,7 @@ AdWords
 *   Report downloader logger
 *   Batch jobs utility logger
 
-DFP
+Ad Manager
 
 *   SOAP logger
 *   Report downloader logger
@@ -287,7 +287,7 @@ soapLogLevel = "NOTICE"
 If you need to further customize logging, you can specify your own logger
 entirely by providing a logger that implements
 [LoggerInterface](https://github.com/php-fig/log/blob/master/Psr/Log/LoggerInterface.php)
-in either the AdWords or DFP session builders:
+in either the AdWords or Ad Manager session builders:
 
 ```php
 $session = (new AdWordsSessionBuilder())
@@ -300,7 +300,7 @@ $session = (new AdWordsSessionBuilder())
 ### Utilities
 
 We provide some utilities in this client library for helping you use features
-in the AdWords and DFP API more conveniently. Check out the following wikis for
+in the AdWords and Ad Manager API more conveniently. Check out the following wikis for
 details:
 
 *   [BatchJobs for AdWords](//github.com/googleads/googleads-php-lib/wiki/BatchJobs-for-AdWords)
@@ -360,14 +360,14 @@ PHPDoc for this library can be found in the
 of this repository and can be viewed at:
 
 * [AdWords](http://googleads.github.io/googleads-php-lib/AdWords/)
-* [DFP](http://googleads.github.io/googleads-php-lib/Dfp/)
+* [Ad Manager](http://googleads.github.io/googleads-php-lib/AdManager/)
 
-General AdWords and DFP API documentation can be found on our Google Developers
+General AdWords and Ad Manager API documentation can be found on our Google Developers
 site:
 
 *   [AdWords API documentation](https://developers.google.com/adwords/api)
-*   [DFP API
-    documentation](https://developers.google.com/doubleclick-publishers)
+*   [Ad Manager API
+    documentation](https://developers.google.com/ad-manager)
 
 ### Coding Style
 
@@ -391,11 +391,11 @@ For client library specific bug reports, feature requests, and patches,
 create an issue on the [issue
 tracker](https://github.com/googleads/googleads-php-lib/issues).
 
-For general AdWords and DFP API questions, bug reports, or feature requests,
+For general AdWords and Ad Manager API questions, bug reports, or feature requests,
 post to our forums:
 
 *   [AdWords API Forum](https://groups.google.com/forum/#!forum/adwords-api)
-*   [DoubleClick for Publishers API
+*   [Ad Manager API
     Forum](https://groups.google.com/forum/#!forum/google-doubleclick-for-publishers-api)
 
 ### Announcements and updates
@@ -405,12 +405,12 @@ For general ads API and client library updates and news, follow:
 *   [Google Ads Developers blog](http://googleadsdeveloper.blogspot.com)
 *   [AdWords API Announcements mailing
     list](https://groups.google.com/forum/#!forum/adwordsapi-announcements)
-*   [DFP API Sunset Announcements mailing
+*   [Ad Manager API Sunset Announcements mailing
     list](https://groups.google.com/forum/#!forum/dfpapi-sunset-announce)
 
 API deprecation schedules can be found at:
 
 *   [AdWords API deprecation
     schedule](https://developers.google.com/adwords/api/docs/sunset-dates)
-*   [DFP API deprecation
-    schedule](https://developers.google.com/doubleclick-publishers/docs/deprecation)
+*   [Ad Manager API deprecation
+    schedule](https://developers.google.com/ad-manager/docs/deprecation)