Merge pull request #98 from BingAds/v12-0-4-dev

proxy refresh and min php version

Author: eric-urban

composer.json

@@ -6,7 +6,7 @@
     "type": "library",
     "homepage": "https://github.com/BingAds/BingAds-PHP-SDK",
     "require": {
-        "php": ">=5.6",
+        "php": ">=7.1",
         "ext-curl": "*",
         "ext-openssl": "*",
         "ext-soap": "*"

src/V12/Bulk/GetBulkUploadUrlResponse.php

@@ -18,7 +18,7 @@ final class GetBulkUploadUrlResponse
         public $RequestId;
 
         /**
-         * The URL where you may submit your bulk upload file with  HTTP POST.
+         * The URL where you may submit your bulk upload file via HTTP POST.
          * @var string
          */
         public $UploadUrl;

src/V12/CampaignManagement/AccountPropertyName.php

@@ -23,6 +23,9 @@ final class AccountPropertyName
 
         /** Used to get or set the property that determines whether you want to send customers directly to your final URL while click measurement runs in the background. */
         const AdClickParallelTracking = 'AdClickParallelTracking';
+
+        /** Used to get or set the account's Final URL Suffix. */
+        const FinalUrlSuffix = 'FinalUrlSuffix';
     }
 
 }

src/V12/CampaignManagement/ActionAdExtension.php

@@ -13,7 +13,7 @@
     final class ActionAdExtension extends AdExtension
     {
         /**
-         * The text you choose here is what is displayed on your call-to-action button.
+         * The action type that you choose here, as well as the Language that you set, determines the text that is displayed on your call-to-action button.
          * @var ActionAdExtensionActionType
          */
         public $ActionType;
@@ -24,6 +24,12 @@ final class ActionAdExtension extends AdExtension
          */
         public $FinalMobileUrls;
 
+        /**
+         * The final URL suffix can include tracking parameters that will be appended to the end of your landing page URL.
+         * @var string
+         */
+        public $FinalUrlSuffix;
+
         /**
          * This is the link to your specific web page or form that corresponds to the action text.
          * @var string[]

src/V12/CampaignManagement/Ad.php

@@ -51,6 +51,12 @@ class Ad
          */
         public $FinalMobileUrls;
 
+        /**
+         * The final URL suffix can include tracking parameters that will be appended to the end of your landing page URL.
+         * @var string
+         */
+        public $FinalUrlSuffix;
+
         /**
          * The last or final URL where a user is ultimately taken, whether or not the click to final URL path included any redirects.
          * @var string[]

src/V12/CampaignManagement/AdAdditionalField.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Defines a list of optional Ad properties that you can request when calling GetAdsByAdGroupId, GetAdsByEditorialStatus, and GetAdsByIds.
+     * Defines a list of optional ad properties that you can request when calling GetAdsByAdGroupId, GetAdsByEditorialStatus, and GetAdsByIds.
      * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/adadditionalfield?view=bingads-12 AdAdditionalField Value Set
      * 
      * @used-by GetAdsByAdGroupIdRequest
@@ -21,6 +21,9 @@ final class AdAdditionalField
 
         /** Request that the Images element be included within each returned ResponsiveAd object. */
         const Images = 'Images';
+
+        /** Request that the FinalUrlSuffix element be included within each returned Ad object. */
+        const FinalUrlSuffix = 'FinalUrlSuffix';
     }
 
 }

src/V12/CampaignManagement/AdExtensionAdditionalField.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Microsoft\BingAds\V12\CampaignManagement;
+
+{
+    /**
+     * Defines a list of optional ad extension properties that you can request when calling GetAdExtensionsAssociations and GetAdExtensionsByIds.
+     * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/adextensionadditionalfield?view=bingads-12 AdExtensionAdditionalField Value Set
+     * 
+     * @used-by GetAdExtensionsAssociationsRequest
+     * @used-by GetAdExtensionsByIdsRequest
+     */
+    final class AdExtensionAdditionalField
+    {
+        /** Request that the FinalUrlSuffix element be included within each returned ActionAdExtension, AppAdExtension, ImageAdExtension, PriceAdExtension, and SitelinkAdExtension object. */
+        const FinalUrlSuffix = 'FinalUrlSuffix';
+    }
+
+}

src/V12/CampaignManagement/AdGroup.php

@@ -54,6 +54,12 @@ final class AdGroup
          */
         public $EndDate;
 
+        /**
+         * The final URL suffix can include tracking parameters that will be appended to the end of your landing page URL.
+         * @var string
+         */
+        public $FinalUrlSuffix;
+
         /**
          * The list of key and value strings for forward compatibility to avoid otherwise breaking changes when new elements are added in the current API version.
          * @var KeyValuePairOfstringstring[]

src/V12/CampaignManagement/AdGroupAdditionalField.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Microsoft\BingAds\V12\CampaignManagement;
+
+{
+    /**
+     * Defines a list of optional ad group properties that you can request when calling GetAdGroupsByCampaignId and GetAdGroupsByIds.
+     * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/adgroupadditionalfield?view=bingads-12 AdGroupAdditionalField Value Set
+     * 
+     * @used-by GetAdGroupsByCampaignIdRequest
+     * @used-by GetAdGroupsByIdsRequest
+     */
+    final class AdGroupAdditionalField
+    {
+        /** Request that the FinalUrlSuffix element be included within each returned AdGroup object. */
+        const FinalUrlSuffix = 'FinalUrlSuffix';
+    }
+
+}

src/V12/CampaignManagement/AdGroupCriterionAdditionalField.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Microsoft\BingAds\V12\CampaignManagement;
+
+{
+    /**
+     * Defines a list of optional ad group criterion properties that you can request when calling GetAdGroupCriterionsByIds.
+     * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/adgroupcriterionadditionalfield?view=bingads-12 AdGroupCriterionAdditionalField Value Set
+     * 
+     * @used-by GetAdGroupCriterionsByIdsRequest
+     */
+    final class AdGroupCriterionAdditionalField
+    {
+        /** Request that the FinalUrlSuffix element be included within each returned BiddableAdGroupCriterion object. */
+        const FinalUrlSuffix = 'FinalUrlSuffix';
+    }
+
+}