Merge pull request #176 from BingAds/users/qitia/version13015

version 13.0.15

src/Auth/ServiceClient.php

@@ -242,7 +242,7 @@ private function RefreshServiceProxy()
 			'features' => SOAP_SINGLE_ELEMENT_ARRAYS,
 			// Disable keep_alive to avoid 'Process open FD table is full'
 			'keep_alive' => FALSE, 
-			'user_agent' => 'BingAdsSDKPHP ' . '13.0.14 ' . PHP_VERSION, 
+			'user_agent' => 'BingAdsSDKPHP ' . '13.0.15 ' . PHP_VERSION, 
 			'cache_wsdl' => 'WSDL_CACHE_NONE',
 
 			/** 

src/V13/AdInsight/BatchError.php

@@ -8,7 +8,9 @@
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/batcherror?view=bingads-13 BatchError Data Object
      * 
      * @used-by ApiFaultDetail
+     * @used-by GetTextAssetSuggestionsByFinalUrlsResponse
      * @used-by SetAutoApplyOptInStatusResponse
+     * @used-by TagRecommendationsResponse
      */
     final class BatchError
     {

src/V13/AdInsight/EntityDetail.php

@@ -4,21 +4,21 @@
 
 {
     /**
-     * Reserved.
+     * Defines an object that provides detail information for an entity for performance insights.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/entitydetail?view=bingads-13 EntityDetail Data Object
      * 
      * @used-by EntityParameter
      */
     final class EntityDetail
     {
         /**
-         * Reserved.
+         * For account, this is AccountId.
          * @var integer
          */
         public $EntityId;
 
         /**
-         * Reserved.
+         * For account/campaign/ad group, this is the name information.
          * @var string
          */
         public $EntityName;

src/V13/AdInsight/EntityParameter.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Defines an object that provides parameter information for an entity.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/entityparameter?view=bingads-13 EntityParameter Data Object
      * 
      * @uses EntityDetail
@@ -13,25 +13,25 @@
     final class EntityParameter extends PerformanceInsightsMessageParameter
     {
         /**
-         * Reserved.
+         * The number of entities.
          * @var integer
          */
         public $EntityCount;
 
         /**
-         * Reserved.
+         * The detail information for entities.
          * @var EntityDetail[]
          */
         public $EntityDetails;
 
         /**
-         * Reserved.
+         * The entity type.
          * @var PerformanceInsightsEntityType
          */
         public $EntityType;
 
         /**
-         * Reserved.
+         * The suggested string value to substitute for the message.
          * @var string
          */
         public $SuggestedText;

src/V13/AdInsight/GetPerformanceInsightsDetailDataByAccountIdRequest.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Gets the performance insights detail data for a single account.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/getperformanceinsightsdetaildatabyaccountid?view=bingads-13 GetPerformanceInsightsDetailDataByAccountId Request Object
      * 
      * @uses EntityType
@@ -14,19 +14,19 @@
     final class GetPerformanceInsightsDetailDataByAccountIdRequest
     {
         /**
-         * Reserved.
+         * The entity level that you want to request performance insights summary data from.
          * @var EntityType
          */
         public $EntityType;
 
         /**
-         * Reserved.
+         * The start date range for performance insights.
          * @var DayMonthAndYear
          */
         public $StartDate;
 
         /**
-         * Reserved.
+         * The end date range for performance insights.
          * @var DayMonthAndYear
          */
         public $EndDate;

src/V13/AdInsight/GetPerformanceInsightsDetailDataByAccountIdResponse.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Gets the performance insights detail data for a single account.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/getperformanceinsightsdetaildatabyaccountid?view=bingads-13 GetPerformanceInsightsDetailDataByAccountId Response Object
      * 
      * @uses PerformanceInsightsDetail
@@ -13,7 +13,7 @@
     final class GetPerformanceInsightsDetailDataByAccountIdResponse
     {
         /**
-         * Reserved.
+         * Defines the performance insight results from calling the GetPerformanceInsightsDetailDataByAccountId operation.
          * @var PerformanceInsightsDetail[]
          */
         public $Result;

src/V13/AdInsight/GetRecommendationsRequest.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Discover your recommendations.
+     * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/getrecommendations?view=bingads-13 GetRecommendations Request Object
+     * 
+     * @used-by BingAdsAdInsightService::GetRecommendations
+     */
+    final class GetRecommendationsRequest
+    {
+        /**
+         * The identifier of the campaign that owns the ad group specified in the AdGroupId element.
+         * @var integer
+         */
+        public $CampaignId;
+
+        /**
+         * The identifier of the ad group for which you want to determine responsive search ads opportunities.
+         * @var integer
+         */
+        public $AdGroupId;
+
+        /**
+         * The identifier of the recommendation type that you want to get.
+         * @var string
+         */
+        public $RecommendationType;
+    }
+}

src/V13/AdInsight/GetRecommendationsResponse.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Discover your recommendations.
+     * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/getrecommendations?view=bingads-13 GetRecommendations Response Object
+     * 
+     * @uses Recommendation
+     * @used-by BingAdsAdInsightService::GetRecommendations
+     */
+    final class GetRecommendationsResponse
+    {
+        /**
+         * An array of Recommendation objects.
+         * @var Recommendation[]
+         */
+        public $Recommendations;
+    }
+}

src/V13/AdInsight/GetTextAssetSuggestionsByFinalUrlsRequest.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Reserved.
+     * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/gettextassetsuggestionsbyfinalurls?view=bingads-13 GetTextAssetSuggestionsByFinalUrls Request Object
+     * 
+     * @used-by BingAdsAdInsightService::GetTextAssetSuggestionsByFinalUrls
+     */
+    final class GetTextAssetSuggestionsByFinalUrlsRequest
+    {
+        /**
+         * Reserved.
+         * @var string[]
+         */
+        public $FinalUrls;
+    }
+}

src/V13/AdInsight/GetTextAssetSuggestionsByFinalUrlsResponse.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Reserved.
+     * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/gettextassetsuggestionsbyfinalurls?view=bingads-13 GetTextAssetSuggestionsByFinalUrls Response Object
+     * 
+     * @uses TextAssetSuggestions
+     * @uses BatchError
+     * @used-by BingAdsAdInsightService::GetTextAssetSuggestionsByFinalUrls
+     */
+    final class GetTextAssetSuggestionsByFinalUrlsResponse
+    {
+        /**
+         * Reserved.
+         * @var TextAssetSuggestions[]
+         */
+        public $TextAssetSuggestions;
+
+        /**
+         * Reserved.
+         * @var BatchError[]
+         */
+        public $PartialErrors;
+    }
+}

src/V13/AdInsight/KPIType.php

@@ -4,23 +4,23 @@
 
 {
     /**
-     * Reserved.
+     * Defines the type of key performance indicator.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/kpitype?view=bingads-13 KPIType Value Set
      * 
      * @used-by PerformanceInsightsDetail
      */
     final class KPIType
     {
-        /** Reserved. */
+        /** Impression metrics. */
         const Impression = 'Impression';
 
-        /** Reserved. */
+        /** Click metrics. */
         const Click = 'Click';
 
-        /** Reserved. */
+        /** Spend metrics. */
         const Spend = 'Spend';
 
-        /** Reserved. */
+        /** Conversion metrics. */
         const Conversion = 'Conversion';
     }
 

src/V13/AdInsight/ParameterType.php

@@ -4,20 +4,20 @@
 
 {
     /**
-     * Reserved.
+     * Defines the type of parameter: string, URL, or a list of demand entities.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/parametertype?view=bingads-13 ParameterType Value Set
      * 
      * @used-by PerformanceInsightsMessageParameter
      */
     final class ParameterType
     {
-        /** Reserved. */
+        /** Indicates the parameter is a string. */
         const Text = 'Text';
 
-        /** Reserved. */
+        /** Indicate the parameter is a URL. */
         const Url = 'Url';
 
-        /** Reserved. */
+        /** Indicates the parameter is a list of demand entities. */
         const Entities = 'Entities';
     }
 

src/V13/AdInsight/PerformanceInsightsDetail.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Defines the details for performance insights.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/performanceinsightsdetail?view=bingads-13 PerformanceInsightsDetail Data Object
      * 
      * @uses EntityType
@@ -16,43 +16,43 @@
     final class PerformanceInsightsDetail
     {
         /**
-         * Reserved.
+         * For account level, this is AccountId.
          * @var integer
          */
         public $EntityId;
 
         /**
-         * Reserved.
+         * The supported types are account and campaign.
          * @var EntityType
          */
         public $EntityType;
 
         /**
-         * Reserved.
+         * Defines the type of key performance indicator.
          * @var KPIType
          */
         public $KPIType;
 
         /**
-         * Reserved.
+         * The date of the detected performance insights.
          * @var DayMonthAndYear
          */
         public $Date;
 
         /**
-         * Reserved.
+         * A message to describe the performance insights.
          * @var PerformanceInsightsMessage
          */
         public $Description;
 
         /**
-         * Reserved.
+         * Messages that describe the root causes in "What happened."
          * @var PerformanceInsightsMessage[]
          */
         public $RootCauses;
 
         /**
-         * Reserved.
+         * Messages that describe the actions in "What can I do."
          * @var PerformanceInsightsMessage[]
          */
         public $Actions;

src/V13/AdInsight/PerformanceInsightsEntityType.php

@@ -4,32 +4,32 @@
 
 {
     /**
-     * Reserved.
+     * Defines the entity types for retrieving performance insights.
      * @link https://docs.microsoft.com/en-us/advertising/ad-insight-service/performanceinsightsentitytype?view=bingads-13 PerformanceInsightsEntityType Value Set
      * 
      * @used-by EntityParameter
      */
     final class PerformanceInsightsEntityType
     {
-        /** Reserved. */
+        /** Account level data. */
         const Account = 'Account';
 
-        /** Reserved. */
+        /** Campaign level data. */
         const Campaign = 'Campaign';
 
-        /** Reserved. */
+        /** Ad group level data. */
         const AdGroup = 'AdGroup';
 
-        /** Reserved. */
+        /** Keyword level data. */
         const Keyword = 'Keyword';
 
-        /** Reserved. */
+        /** Product group level data. */
         const ProductGroup = 'ProductGroup';
 
-        /** Reserved. */
+        /** Search term level data. */
         const SearchTerm = 'SearchTerm';
 
-        /** Reserved. */
+        /** Website level data. */
         const Website = 'Website';
     }