Preparing src for release 5.8.0

Author: Vincent Tsao

ChangeLog.md

@@ -1,3 +1,16 @@
+### 5.8.0
+
+AdWords:
+  - Improved targetAll comments in the AddAdGroups.php examples.
+  - Added code examples for upgraded URLs.
+
+DFP:
+  - Added support for v201502.
+  - Removed support for v201311, v201308, and v201306.
+  - Removed examples for v201403.
+  - Updated ForecastService examples.
+  - Removed support for ClientLogin with the removal of v201311 and earlier.
+
 ### 5.7.1
 
 AdWords:

examples/AdWords/v201406/AdvancedOperations/AddTextAdWithUpgradedUrls.php

@@ -63,7 +63,7 @@ function AddTextAdWithUpgradedUrlsExample(AdWordsUser $user, $adGroupId) {
     // specify one at customer, campaign, ad group, ad, criterion or
     // feed item levels.
     $textAd->trackingUrlTemplate =
-        'http://tracker.example.com/?cid={_season}&promocode={_promocode}' .
+        'http://tracker.example.com/?season={_season}&promocode={_promocode}' .
         '&u={lpurl}';
 
     // Since your tracking url has two custom parameters, provide their

examples/AdWords/v201406/BasicOperations/AddAdGroups.php

@@ -61,15 +61,17 @@ function AddAdGroupsExample(AdWordsUser $user, $campaignId) {
     // Set additional settings (optional).
     $adGroup->status = 'ENABLED';
 
-    // Targetting restriction settings - these setting only affect serving
+    // Targeting restriction settings - these settings only affect serving
     // for the Display Network.
     $targetingSetting = new TargetingSetting();
     // Restricting to serve ads that match your ad group placements.
+    // This is equivalent to choosing "Target and bid" in the UI.
     $targetingSetting->details[] =
-        new TargetingSettingDetail('PLACEMENT', TRUE);
-    // Using your ad group verticals only for bidding.
+        new TargetingSettingDetail('PLACEMENT', FALSE);
+    // Using your ad group verticals only for bidding. This is equivalent
+    // to choosing "Bid only" in the UI.
     $targetingSetting->details[] =
-        new TargetingSettingDetail('VERTICAL', FALSE);
+        new TargetingSettingDetail('VERTICAL', TRUE);
     $adGroup->settings[] = $targetingSetting;
 
     // Create operation.

examples/AdWords/v201409/AdvancedOperations/AddAdCustomizer.php

@@ -304,7 +304,7 @@ function CreateAdsWithCustomizations(AdWordsUser $user, $adGroupIds) {
   $textAd->headline = 'Luxury Cruise to {=CustomizerFeed.Name}';
   $textAd->description1 = 'Only {=CustomizerFeed.Price}';
   $textAd->description2 = 'Offer ends in {=countdown(CustomizerFeed.Date)}!';
-  $textAd->url = 'http://www.example.com';
+  $textAd->finalUrls = array('http://www.example.com');
   $textAd->displayUrl = 'www.example.com';
 
   // We add the same ad to both ad groups. When they serve, they will show

examples/AdWords/v201409/AdvancedOperations/AddClickToDownloadAd.php

@@ -50,8 +50,8 @@ function AddClickToDownloadAd(AdWordsUser $user, $adGroupId) {
 
   $clickToDownloadAppAd->name = 'Ad for demo game';
   $clickToDownloadAppAd->templateId = 353;
-  $clickToDownloadAppAd->url =
-      'http://play.google.com/store/apps/details?id=com.example.demogame';
+  $clickToDownloadAppAd->finalUrls = array(
+      'http://play.google.com/store/apps/details?id=com.example.demogame');
   $clickToDownloadAppAd->displayUrl = 'play.google.com';
 
   // Create the template elements for the ad. You can refer to
@@ -109,7 +109,7 @@ function AddClickToDownloadAd(AdWordsUser $user, $adGroupId) {
 
   foreach ($result->value as $adGroupAd) {
     printf('New click-to-download ad with ID = %d and URL = "%s" ' .
-        "was created.\n", $adGroupAd->ad->id, $adGroupAd->ad->url);
+        "was created.\n", $adGroupAd->ad->id, $adGroupAd->ad->finalUrls[0]);
   }
 }
 

examples/AdWords/v201409/AdvancedOperations/AddTextAdWithUpgradedUrls.php

@@ -1,8 +1,6 @@
 <?php
 /**
  * This example adds text ads to an ad group that uses upgraded URLs.
- * This example will only work if your account is a test account or is
- * whitelisted for this feature.
  *
  * To get ad groups, run GetAdGroups.php.
  *
@@ -63,7 +61,7 @@ function AddTextAdWithUpgradedUrlsExample(AdWordsUser $user, $adGroupId) {
     // specify one at customer, campaign, ad group, ad, criterion or
     // feed item levels.
     $textAd->trackingUrlTemplate =
-        'http://tracker.example.com/?cid={_season}&promocode={_promocode}' .
+        'http://tracker.example.com/?season={_season}&promocode={_promocode}' .
         '&u={lpurl}';
 
     // Since your tracking url has two custom parameters, provide their

examples/AdWords/v201409/BasicOperations/AddAdGroups.php

@@ -61,15 +61,17 @@ function AddAdGroupsExample(AdWordsUser $user, $campaignId) {
     // Set additional settings (optional).
     $adGroup->status = 'ENABLED';
 
-    // Targetting restriction settings - these setting only affect serving
+    // Targeting restriction settings - these settings only affect serving
     // for the Display Network.
     $targetingSetting = new TargetingSetting();
     // Restricting to serve ads that match your ad group placements.
+    // This is equivalent to choosing "Target and bid" in the UI.
     $targetingSetting->details[] =
-        new TargetingSettingDetail('PLACEMENT', TRUE);
-    // Using your ad group verticals only for bidding.
+        new TargetingSettingDetail('PLACEMENT', FALSE);
+    // Using your ad group verticals only for bidding. This is equivalent
+    // to choosing "Bid only" in the UI.
     $targetingSetting->details[] =
-        new TargetingSettingDetail('VERTICAL', FALSE);
+        new TargetingSettingDetail('VERTICAL', TRUE);
     $adGroup->settings[] = $targetingSetting;
 
     // Create operation.

examples/AdWords/v201409/BasicOperations/AddKeywords.php

@@ -60,14 +60,15 @@ function AddKeywordsExample(AdWordsUser $user, $adGroupId) {
 
     // Set additional settings (optional).
     $adGroupCriterion->userStatus = 'PAUSED';
-    $adGroupCriterion->destinationUrl = 'http://www.example.com/mars';
+    $adGroupCriterion->finalUrls = array('http://www.example.com/mars');
 
     // Set bids (optional).
     $bid = new CpcBid();
     $bid->bid =  new Money(500000);
     $biddingStrategyConfiguration = new BiddingStrategyConfiguration();
     $biddingStrategyConfiguration->bids[] = $bid;
-    $adGroupCriterion->biddingStrategyConfiguration = $biddingStrategyConfiguration;
+    $adGroupCriterion->biddingStrategyConfiguration =
+        $biddingStrategyConfiguration;
 
     $adGroupCriteria[] = $adGroupCriterion;
 

examples/AdWords/v201409/BasicOperations/AddTextAds.php

@@ -55,7 +55,7 @@ function AddTextAdsExample(AdWordsUser $user, $adGroupId) {
     $textAd->description1 = 'Visit the Red Planet in style.';
     $textAd->description2 = 'Low-gravity fun for everyone!';
     $textAd->displayUrl = 'www.example.com';
-    $textAd->url = 'http://www.example.com';
+    $textAd->finalUrls = array('http://www.example.com');
 
     // Create ad group ad.
     $adGroupAd = new AdGroupAd();

examples/AdWords/v201409/BasicOperations/UpdateKeyword.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * This example updates the destination URL of a keyword. To get keywords, run
+ * This example updates the final URL of a keyword. To get keywords, run
  * GetKeywords.php.
  *
  * Tags: AdGroupCriterionService.mutate
@@ -54,8 +54,8 @@ function UpdateKeywordExample(AdWordsUser $user, $adGroupId, $criterionId) {
   // instead of Keyword to avoid having to set keyword-specific fields.
   $adGroupCriterion->criterion = new Criterion($criterionId);
 
-  // Update destination URL.
-  $adGroupCriterion->destinationUrl = 'http://www.example.com/new';
+  // Update final URL.
+  $adGroupCriterion->finalUrls = array('http://www.example.com/new');
 
   // Create operation.
   $operation = new AdGroupCriterionOperation();