Merge pull request #22 from BingAds/august-refresh

add service proxy chnages

src/V11/CampaignManagement/AdGroupAdditionalField.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Microsoft\BingAds\V11\CampaignManagement;
+
+{
+    /**
+     * Defines a list of optional AdGroup properties that you can request when calling GetAdGroupsByCampaignId and GetAdGroupsByIds.
+     * @link http://msdn.microsoft.com/en-us/library/mt709095(v=msads.110).aspx AdGroupAdditionalField Value Set
+     * 
+     * @used-by GetAdGroupsByCampaignIdRequest
+     * @used-by GetAdGroupsByIdsRequest
+     */
+    final class AdGroupAdditionalField
+    {
+        /** Includes the InheritedBidStrategyType element that can be nested within the BiddingScheme element of an AdGroup object. */
+        const InheritedBidStrategyType = 'InheritedBidStrategyType';
+    }
+
+}

src/V11/CampaignManagement/ConversionGoalType.php

@@ -28,8 +28,11 @@ final class ConversionGoalType
         /** Refers to an AppInstallGoal */
         const AppInstall = 'AppInstall';
 
-        /** Refers to an OfflineConversion */
+        /** Refers to an OfflineConversionGoal */
         const OfflineConversion = 'OfflineConversion';
+
+        /** Refers to an InStoreTransactionGoal */
+        const InStoreTransaction = 'InStoreTransaction';
     }
 
 }

src/V11/CampaignManagement/GetAdGroupsByCampaignIdRequest.php

@@ -7,6 +7,7 @@
      * Gets the ad groups within the specified campaign.
      * @link http://msdn.microsoft.com/en-us/library/dn277524(v=msads.110).aspx GetAdGroupsByCampaignId Request Object
      * 
+     * @uses AdGroupAdditionalField
      * @used-by BingAdsCampaignManagementService::GetAdGroupsByCampaignId
      */
     final class GetAdGroupsByCampaignIdRequest
@@ -16,5 +17,11 @@ final class GetAdGroupsByCampaignIdRequest
          * @var integer
          */
         public $CampaignId;
+
+        /**
+         * The list of additional properties that you want included within each returned AdGroup object.
+         * @var AdGroupAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V11/CampaignManagement/GetAdGroupsByIdsRequest.php

@@ -7,6 +7,7 @@
      * Gets the specified ad groups within the specified campaign.
      * @link http://msdn.microsoft.com/en-us/library/dn277529(v=msads.110).aspx GetAdGroupsByIds Request Object
      * 
+     * @uses AdGroupAdditionalField
      * @used-by BingAdsCampaignManagementService::GetAdGroupsByIds
      */
     final class GetAdGroupsByIdsRequest
@@ -22,5 +23,11 @@ final class GetAdGroupsByIdsRequest
          * @var integer[]
          */
         public $AdGroupIds;
+
+        /**
+         * The list of additional properties that you want included within each returned AdGroup object.
+         * @var AdGroupAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V11/CampaignManagement/GetKeywordsByAdGroupIdRequest.php

@@ -7,6 +7,7 @@
      * Gets the keywords within an ad group.
      * @link http://msdn.microsoft.com/en-us/library/dn236311(v=msads.110).aspx GetKeywordsByAdGroupId Request Object
      * 
+     * @uses KeywordAdditionalField
      * @used-by BingAdsCampaignManagementService::GetKeywordsByAdGroupId
      */
     final class GetKeywordsByAdGroupIdRequest
@@ -16,5 +17,11 @@ final class GetKeywordsByAdGroupIdRequest
          * @var integer
          */
         public $AdGroupId;
+
+        /**
+         * The list of additional properties that you want included within each returned Keyword object.
+         * @var KeywordAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V11/CampaignManagement/GetKeywordsByEditorialStatusRequest.php

@@ -8,6 +8,7 @@
      * @link http://msdn.microsoft.com/en-us/library/dn277501(v=msads.110).aspx GetKeywordsByEditorialStatus Request Object
      * 
      * @uses KeywordEditorialStatus
+     * @uses KeywordAdditionalField
      * @used-by BingAdsCampaignManagementService::GetKeywordsByEditorialStatus
      */
     final class GetKeywordsByEditorialStatusRequest
@@ -23,5 +24,11 @@ final class GetKeywordsByEditorialStatusRequest
          * @var KeywordEditorialStatus
          */
         public $EditorialStatus;
+
+        /**
+         * The list of additional properties that you want included within each returned Keyword object.
+         * @var KeywordAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V11/CampaignManagement/GetKeywordsByIdsRequest.php

@@ -7,6 +7,7 @@
      * Retrieves the specified keywords.
      * @link http://msdn.microsoft.com/en-us/library/dn277505(v=msads.110).aspx GetKeywordsByIds Request Object
      * 
+     * @uses KeywordAdditionalField
      * @used-by BingAdsCampaignManagementService::GetKeywordsByIds
      */
     final class GetKeywordsByIdsRequest
@@ -22,5 +23,11 @@ final class GetKeywordsByIdsRequest
          * @var integer[]
          */
         public $KeywordIds;
+
+        /**
+         * The list of additional properties that you want included within each returned Keyword object.
+         * @var KeywordAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V11/CampaignManagement/InStoreTransactionGoal.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Microsoft\BingAds\V11\CampaignManagement;
+
+{
+    /**
+     * Defines an in-store transaction goal.
+     * @link http://msdn.microsoft.com/en-us/library/mt493294(v=msads.110).aspx InStoreTransactionGoal Data Object
+     */
+    final class InStoreTransactionGoal extends ConversionGoal
+    {
+    }
+
+}

src/V11/CampaignManagement/InheritFromParentBiddingScheme.php

@@ -9,6 +9,11 @@
      */
     final class InheritFromParentBiddingScheme extends BiddingScheme
     {
+        /**
+         * The type of bidding scheme (a.
+         * @var string
+         */
+        public $InheritedBidStrategyType;
     }
 
 }

src/V11/CampaignManagement/KeywordAdditionalField.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Microsoft\BingAds\V11\CampaignManagement;
+
+{
+    /**
+     * Defines a list of optional Keyword properties that you can request when calling GetKeywordsByAdGroupId, GetKeywordsByEditorialStatus, and GetKeywordsByIds.
+     * @link http://msdn.microsoft.com/en-us/library/mt709096(v=msads.110).aspx KeywordAdditionalField Value Set
+     * 
+     * @used-by GetKeywordsByAdGroupIdRequest
+     * @used-by GetKeywordsByEditorialStatusRequest
+     * @used-by GetKeywordsByIdsRequest
+     */
+    final class KeywordAdditionalField
+    {
+        /** Includes the InheritedBidStrategyType element that can be nested within the BiddingScheme element of an Keyword object. */
+        const InheritedBidStrategyType = 'InheritedBidStrategyType';
+    }
+
+}

src/V11/Reporting/GoalsAndFunnelsReportColumn.php

@@ -73,6 +73,9 @@ final class GoalsAndFunnelsReportColumn
 
         /** The keyword status. */
         const KeywordStatus = 'KeywordStatus';
+
+        /** The goal type. */
+        const GoalType = 'GoalType';
     }
 
 }

src/V11/Reporting/ProductDimensionPerformanceReportColumn.php

@@ -178,13 +178,21 @@ final class ProductDimensionPerformanceReportColumn
 
         /** The click type ID. */
         const ClickTypeId = 'ClickTypeId';
+
+        /** The number of clicks when this ad element was present in the ad copy, whether this or another ad element was clicked on. */
         const TotalClicksOnAdElements = 'TotalClicksOnAdElements';
 
         /** Click type refers to each component of an ad that a customer can click. */
         const ClickType = 'ClickType';
         const ReturnOnAdSpend = 'ReturnOnAdSpend';
+
+        /** The bid strategy type. */
         const BidStrategyType = 'BidStrategyType';
+
+        /** An alphanumeric identifier defined by the merchant to uniquely identify each local store. */
         const LocalStoreCode = 'LocalStoreCode';
+
+        /** The unique identifier for the Bing Merchant Center store. */
         const StoreId = 'StoreId';
     }
 

src/V11/Reporting/ProductPartitionPerformanceReportColumn.php

@@ -157,12 +157,20 @@ final class ProductPartitionPerformanceReportColumn
 
         /** The click type ID. */
         const ClickTypeId = 'ClickTypeId';
+
+        /** The number of clicks when this ad element was present in the ad copy, whether this or another ad element was clicked on. */
         const TotalClicksOnAdElements = 'TotalClicksOnAdElements';
 
         /** Click type refers to each component of an ad that a customer can click. */
         const ClickType = 'ClickType';
+
+        /** The return on ad spend (ROAS). */
         const ReturnOnAdSpend = 'ReturnOnAdSpend';
+
+        /** The bid strategy type. */
         const BidStrategyType = 'BidStrategyType';
+
+        /** An alphanumeric identifier defined by the merchant to uniquely identify each local store. */
         const LocalStoreCode = 'LocalStoreCode';
     }
 

src/V11/Reporting/ProductPartitionUnitPerformanceReportColumn.php

@@ -127,8 +127,14 @@ final class ProductPartitionUnitPerformanceReportColumn
 
         /** The current custom parameter set of the criterion. */
         const CustomParameters = 'CustomParameters';
+
+        /** The return on ad spend (ROAS). */
         const ReturnOnAdSpend = 'ReturnOnAdSpend';
+
+        /** The bid strategy type. */
         const BidStrategyType = 'BidStrategyType';
+
+        /** An alphanumeric identifier defined by the merchant to uniquely identify each local store. */
         const LocalStoreCode = 'LocalStoreCode';
     }
 

src/V11/Reporting/ShareOfVoiceReportColumn.php

@@ -113,6 +113,8 @@ final class ShareOfVoiceReportColumn
 
         /** The ad distribution attribute of an ad group. */
         const AdDistribution = 'AdDistribution';
+
+        /** The percentage of clicks that went to your ads. */
         const ClickSharePercent = 'ClickSharePercent';
 
         /** The device name attribute of a device OS target bid. */