Merge pull request #197 from BingAds/v13.0.19

v13.0.19

Author: xinyuwen2

src/Auth/OAuthAuthorization.php

@@ -81,7 +81,7 @@ public function withRefreshToken($refreshToken) {
     /** 
      * Includes the OAuth tokens. 
      *
-     * @param OAuthTokens $oauthTokens
+     * @param string $oauthTokens
      * @return OAuthAuthorization this builder
      */
     public function withOAuthTokens($oauthTokens) {

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.18 ' . PHP_VERSION, 
+			'user_agent' => 'BingAdsSDKPHP ' . '13.0.19 ' . PHP_VERSION, 
 			'cache_wsdl' => 'WSDL_CACHE_NONE',
 
 			/** 

src/Auth/UriOAuthService.php

@@ -222,4 +222,4 @@ public static function GetAuthorizeUrl($environment, $oauthScope, $tenant) {
 
         return $authorizationEndpointUrl;
     }
-}
+}

src/V13/AdInsight/AgeEnum.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Reserved.
+     * @link https:/learn.microsoft.com/advertising/ad-insight-service/ageenum?view=bingads-13 AgeEnum Value Set
+     * 
+     * @used-by SelectionOfAgeEnum
+     */
+    final class AgeEnum
+    {
+        /** Reserved. */
+        const Unknown = 'Unknown';
+
+        /** Reserved. */
+        const ZeroToTwelve = 'ZeroToTwelve';
+
+        /** Reserved. */
+        const ThirteenToSevenTeen = 'ThirteenToSevenTeen';
+
+        /** Reserved. */
+        const EighteenToTwentyFour = 'EighteenToTwentyFour';
+
+        /** Reserved. */
+        const TwentyFiveToThirtyFour = 'TwentyFiveToThirtyFour';
+
+        /** Reserved. */
+        const ThirtyFiveToFourtyNine = 'ThirtyFiveToFourtyNine';
+
+        /** Reserved. */
+        const FiftyToSixtyFour = 'FiftyToSixtyFour';
+
+        /** Reserved. */
+        const SixtyFiveAndAbove = 'SixtyFiveAndAbove';
+    }
+
+}

src/V13/AdInsight/ApplyRecommendationEntity.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Apply a recommendation.
+     * @link https:/learn.microsoft.com/advertising/ad-insight-service/applyrecommendationentity?view=bingads-13 ApplyRecommendationEntity Data Object
+     * 
+     * @used-by ApplyRecommendationsRequest
+     */
+    final class ApplyRecommendationEntity
+    {
+        /**
+         * The identifier of the recommendation.
+         * @var string
+         */
+        public $RecommendationId;
+
+        /**
+         * The type of recommendation: CAMPAIGN_BUDGET, KEYWORD or RESPONSIVE_SEARCH_AD.
+         * @var string
+         */
+        public $RecommendationType;
+    }
+
+}

src/V13/AdInsight/ApplyRecommendationsRequest.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Apply one or more recommendations.
+     * @link https:/learn.microsoft.com/advertising/ad-insight-service/applyrecommendations?view=bingads-13 ApplyRecommendations Request Object
+     * 
+     * @uses ApplyRecommendationEntity
+     * @used-by BingAdsAdInsightService::ApplyRecommendations
+     */
+    final class ApplyRecommendationsRequest
+    {
+        /**
+         * The list of operations to apply recommendations.
+         * @var ApplyRecommendationEntity[]
+         */
+        public $Entities;
+    }
+}

src/V13/AdInsight/ApplyRecommendationsResponse.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Apply one or more recommendations.
+     * @link https:/learn.microsoft.com/advertising/ad-insight-service/applyrecommendations?view=bingads-13 ApplyRecommendations Response Object
+     * 
+     * @uses BatchError
+     * @used-by BingAdsAdInsightService::ApplyRecommendations
+     */
+    final class ApplyRecommendationsResponse
+    {
+        /**
+         * An array BatchError that contains details for any request items that were not successful.
+         * @var BatchError[]
+         */
+        public $PartialErrors;
+    }
+}

src/V13/AdInsight/BatchError.php

@@ -8,6 +8,8 @@
      * @link https:/learn.microsoft.com/advertising/ad-insight-service/batcherror?view=bingads-13 BatchError Data Object
      * 
      * @used-by ApiFaultDetail
+     * @used-by ApplyRecommendationsResponse
+     * @used-by DismissRecommendationsResponse
      * @used-by GetTextAssetSuggestionsByFinalUrlsResponse
      * @used-by SetAutoApplyOptInStatusResponse
      * @used-by TagRecommendationsResponse

src/V13/AdInsight/BudgetLimitType.php

@@ -8,6 +8,7 @@
      * @link https:/learn.microsoft.com/advertising/ad-insight-service/budgetlimittype?view=bingads-13 BudgetLimitType Value Set
      * 
      * @used-by BudgetOpportunity
+     * @used-by CampaignBudgetRecommendation
      */
     final class BudgetLimitType
     {

src/V13/AdInsight/BudgetPoint.php

@@ -9,6 +9,7 @@
      * 
      * @uses BudgetPointType
      * @used-by BudgetOpportunity
+     * @used-by CampaignBudgetRecommendation
      */
     final class BudgetPoint
     {