Release 18.0.0.

googleads · May 24, 2017 · fe0cfce · fe0cfce
1 parent e745ffd
commit fe0cfce
Show file tree

Hide file tree

Showing 403 changed files with 31,448 additions and 14,222 deletions.
diff --git a/ChangeLog.md b/ChangeLog.md
@@ -1,3 +1,13 @@
+### 18.0.0
+
+DFP:
+  - Added support and examples for v201705.
+  - Removed examples for v201608 (deprecated).
+  - Removed support for v201605 (sunset).
+
+Common:
+  - Made user agents sent by non-SOAP utilities more informative.
+
 ### 17.0.0
 
 AdWords:

diff --git a/...vityGroupService/CreateActivityGroups.php → ...vityGroupService/CreateActivityGroups.php b/...vityGroupService/CreateActivityGroups.php → ...vityGroupService/CreateActivityGroups.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2013, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -46,7 +46,7 @@
   $user->LogDefaults();
 
   // Get the ActivityGroupService.
-  $activityGroupService = $user->GetService('ActivityGroupService', 'v201608');
+  $activityGroupService = $user->GetService('ActivityGroupService', 'v201705');
 
   // Set the ID of the advertiser company this activity group is associated
   // with.

diff --git a/...yGroupService/GetActiveActivityGroups.php → ...yGroupService/GetActiveActivityGroups.php b/...yGroupService/GetActiveActivityGroups.php → ...yGroupService/GetActiveActivityGroups.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 try {
@@ -47,7 +47,7 @@
   $user->LogDefaults();
 
   // Get the ActivityGroupService.
-  $activityGroupService = $user->GetService('ActivityGroupService', 'v201608');
+  $activityGroupService = $user->GetService('ActivityGroupService', 'v201705');
 
   // Create a statement to select only active activity groups.
   $statementBuilder = new StatementBuilder();

diff --git a/...vityGroupService/GetAllActivityGroups.php → ...vityGroupService/GetAllActivityGroups.php b/...vityGroupService/GetAllActivityGroups.php → ...vityGroupService/GetAllActivityGroups.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 try {
@@ -47,7 +47,7 @@
   $user->LogDefaults();
 
   // Get the ActivityGroupService.
-  $activityGroupService = $user->GetService('ActivityGroupService', 'v201608');
+  $activityGroupService = $user->GetService('ActivityGroupService', 'v201705');
 
   // Create a statement to select all activity groups.
   $statementBuilder = new StatementBuilder();

diff --git a/...vityGroupService/UpdateActivityGroups.php → ...vityGroupService/UpdateActivityGroups.php b/...vityGroupService/UpdateActivityGroups.php → ...vityGroupService/UpdateActivityGroups.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 // Set the ID of the activity group to update.
@@ -53,7 +53,7 @@
   $user->LogDefaults();
 
   // Get the ActivityGroupService.
-  $activityGroupService = $user->GetService('ActivityGroupService', 'v201608');
+  $activityGroupService = $user->GetService('ActivityGroupService', 'v201705');
 
   // Create a statement to select a single activity group by ID.
   $statementBuilder = new StatementBuilder();

diff --git a/...1608/ActivityService/CreateActivities.php → ...1705/ActivityService/CreateActivities.php b/...1608/ActivityService/CreateActivities.php → ...1705/ActivityService/CreateActivities.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2013, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -46,7 +46,7 @@
   $user->LogDefaults();
 
   // Get the ActivityService.
-  $activityService = $user->GetService('ActivityService', 'v201608');
+  $activityService = $user->GetService('ActivityService', 'v201705');
 
   // Set the ID of the activity group this activity is associated with.
   $activityGroupId = 'INSERT_ACTIVITY_GROUP_ID_HERE';

diff --git a/...8/ActivityService/GetActiveActivities.php → ...5/ActivityService/GetActiveActivities.php b/...8/ActivityService/GetActiveActivities.php → ...5/ActivityService/GetActiveActivities.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 try {
@@ -47,7 +47,7 @@
   $user->LogDefaults();
 
   // Get the ActivityService.
-  $activityService = $user->GetService('ActivityService', 'v201608');
+  $activityService = $user->GetService('ActivityService', 'v201705');
 
   // Create a statement to select only active activities.
   $statementBuilder = new StatementBuilder();

diff --git a/...1608/ActivityService/GetAllActivities.php → ...1705/ActivityService/GetAllActivities.php b/...1608/ActivityService/GetAllActivities.php → ...1705/ActivityService/GetAllActivities.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 try {
@@ -47,7 +47,7 @@
   $user->LogDefaults();
 
   // Get the ActivityService.
-  $activityService = $user->GetService('ActivityService', 'v201608');
+  $activityService = $user->GetService('ActivityService', 'v201705');
 
   // Create a statement to select all activities.
   $statementBuilder = new StatementBuilder();

diff --git a/...1608/ActivityService/UpdateActivities.php → ...1705/ActivityService/UpdateActivities.php b/...1608/ActivityService/UpdateActivities.php → ...1705/ActivityService/UpdateActivities.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 // Set the ID of the activity to update.
@@ -50,7 +50,7 @@
   $user->LogDefaults();
 
   // Get the ActivityService.
-  $activityService = $user->GetService('ActivityService', 'v201608');
+  $activityService = $user->GetService('ActivityService', 'v201705');
 
   // Create a statement to select a single activity by ID.
   $statementBuilder = new StatementBuilder();

diff --git a/...SegmentService/CreateAudienceSegments.php → ...SegmentService/CreateAudienceSegments.php b/...SegmentService/CreateAudienceSegments.php → ...SegmentService/CreateAudienceSegments.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2013, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -47,10 +47,10 @@
 
   // Get the AudienceSegmentService.
   $audienceSegmentService =
-      $user->GetService('AudienceSegmentService', 'v201608');
+      $user->GetService('AudienceSegmentService', 'v201705');
 
   // Get the NetworkService.
-  $networkService = $user->GetService('NetworkService', 'v201608');
+  $networkService = $user->GetService('NetworkService', 'v201705');
 
   // Set the IDs of the custom criteria to be used in the segment rule.
   $customTargetingKeyId = 'INSERT_CUSTOM_TARGETING_KEY_ID_HERE';

diff --git a/...SegmentService/GetAllAudienceSegments.php → ...SegmentService/GetAllAudienceSegments.php b/...SegmentService/GetAllAudienceSegments.php → ...SegmentService/GetAllAudienceSegments.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 try {
@@ -48,7 +48,7 @@
 
   // Get the AudienceSegmentService.
   $audienceSegmentService = $user->GetService('AudienceSegmentService',
-      'v201608');
+      'v201705');
 
   // Create a statement to select all audience segments.
   $statementBuilder = new StatementBuilder();

diff --git a/...Service/GetFirstPartyAudienceSegments.php → ...Service/GetFirstPartyAudienceSegments.php b/...Service/GetFirstPartyAudienceSegments.php → ...Service/GetFirstPartyAudienceSegments.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 try {
@@ -48,7 +48,7 @@
 
   // Get the AudienceSegmentService.
   $audienceSegmentService = $user->GetService('AudienceSegmentService',
-      'v201608');
+      'v201705');
 
   // Create a statement to select only first party audience segments.
   $statementBuilder = new StatementBuilder();

diff --git a/...ce/PopulateFirstPartyAudienceSegments.php → ...ce/PopulateFirstPartyAudienceSegments.php b/...ce/PopulateFirstPartyAudienceSegments.php → ...ce/PopulateFirstPartyAudienceSegments.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -35,7 +35,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 // Set the ID of the first party audience segment to populate.
@@ -51,7 +51,7 @@
 
   // Get the AudienceSegmentService.
   $audienceSegmentService =
-      $user->GetService('AudienceSegmentService', 'v201608');
+      $user->GetService('AudienceSegmentService', 'v201705');
 
   // Create a statement to only select a specified first party audience
   // segment.

diff --git a/...SegmentService/UpdateAudienceSegments.php → ...SegmentService/UpdateAudienceSegments.php b/...SegmentService/UpdateAudienceSegments.php → ...SegmentService/UpdateAudienceSegments.php
@@ -21,7 +21,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -36,7 +36,7 @@
 set_include_path(get_include_path() . PATH_SEPARATOR . $path);
 
 require_once 'Google/Api/Ads/Dfp/Lib/DfpUser.php';
-require_once 'Google/Api/Ads/Dfp/Util/v201608/StatementBuilder.php';
+require_once 'Google/Api/Ads/Dfp/Util/v201705/StatementBuilder.php';
 require_once dirname(__FILE__) . '/../../../Common/ExampleUtils.php';
 
 // Set the ID of the first party audience segment to update.
@@ -52,7 +52,7 @@
 
   // Get the AudienceSegmentService.
   $audienceSegmentService =
-      $user->GetService('AudienceSegmentService', 'v201608');
+      $user->GetService('AudienceSegmentService', 'v201705');
 
   // Create a statement to select a single first party audience segment by ID.
   $statementBuilder = new StatementBuilder();

diff --git a/...aseRateService/CreateProductBaseRates.php → ...aseRateService/CreateProductBaseRates.php b/...aseRateService/CreateProductBaseRates.php → ...aseRateService/CreateProductBaseRates.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -52,7 +52,7 @@
   $user->LogDefaults();
 
   // Get the BaseRateService.
-  $baseRateService = $user->GetService('BaseRateService', 'v201608');
+  $baseRateService = $user->GetService('BaseRateService', 'v201705');
 
   // Create a base rate for a product.
   $productBaseRate = new ProductBaseRate();

diff --git a/...ervice/CreateProductTemplateBaseRates.php → ...ervice/CreateProductTemplateBaseRates.php b/...ervice/CreateProductTemplateBaseRates.php → ...ervice/CreateProductTemplateBaseRates.php
@@ -20,7 +20,7 @@
  * limitations under the License.
  *
  * @package    GoogleApiAdsDfp
- * @subpackage v201608
+ * @subpackage v201705
  * @category   WebServices
  * @copyright  2014, Google Inc. All Rights Reserved.
  * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License,
@@ -52,7 +52,7 @@
   $user->LogDefaults();
 
   // Get the BaseRateService.
-  $baseRateService = $user->GetService('BaseRateService', 'v201608');
+  $baseRateService = $user->GetService('BaseRateService', 'v201705');
 
   // Create a base rate for a product template.
   $productTemplateBaseRate = new ProductTemplateBaseRate();