Merge pull request #197 from BingAds/v13.0.19

v13.0.19

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
     {

src/V13/AdInsight/CampaignBudgetRecommendation.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Defines the CampaignBudgetRecommendation data object.
+     * @link https:/learn.microsoft.com/advertising/ad-insight-service/campaignbudgetrecommendation?view=bingads-13 CampaignBudgetRecommendation Data Object
+     * 
+     * @uses BudgetPoint
+     * @uses BudgetLimitType
+     */
+    final class CampaignBudgetRecommendation extends RecommendationBase
+    {
+        /**
+         * The list of budget points with weekly impressions, clicks and cost estimates for the given budget amount.
+         * @var BudgetPoint[]
+         */
+        public $BudgetPoints;
+
+        /**
+         * The type of budget that the campaign uses.
+         * @var BudgetLimitType
+         */
+        public $BudgetType;
+
+        /**
+         * The current budget amount.
+         * @var double
+         */
+        public $CurrentBudget;
+
+        /**
+         * The recommended budget amount based on the last 15 days of performance history for the corresponding campaign.
+         * @var double
+         */
+        public $RecommendedBudget;
+    }
+
+}

src/V13/AdInsight/Currency.php

@@ -0,0 +1,148 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Reserved.
+     * @link https:/learn.microsoft.com/advertising/ad-insight-service/currency?view=bingads-13 Currency Value Set
+     * 
+     * @used-by GetAudienceFullEstimationRequest
+     * @used-by GetAudienceFullEstimationResponse
+     */
+    final class Currency
+    {
+        /** Reserved. */
+        const UnSpecify = 'UnSpecify';
+
+        /** Reserved. */
+        const AlgerianDinar = 'AlgerianDinar';
+
+        /** Reserved. */
+        const ArgentinePeso = 'ArgentinePeso';
+
+        /** Reserved. */
+        const AustralianDollar = 'AustralianDollar';
+
+        /** Reserved. */
+        const Baht = 'Baht';
+
+        /** Reserved. */
+        const Bolivar = 'Bolivar';
+
+        /** Reserved. */
+        const BrazilianReal = 'BrazilianReal';
+
+        /** Reserved. */
+        const CanadianDollar = 'CanadianDollar';
+
+        /** Reserved. */
+        const ChileanPeso = 'ChileanPeso';
+
+        /** Reserved. */
+        const ColombianPeso = 'ColombianPeso';
+
+        /** Reserved. */
+        const CzechKoruna = 'CzechKoruna';
+
+        /** Reserved. */
+        const DanishKrone = 'DanishKrone';
+
+        /** Reserved. */
+        const Dong = 'Dong';
+
+        /** Reserved. */
+        const EgyptianPound = 'EgyptianPound';
+
+        /** Reserved. */
+        const EURO = 'EURO';
+
+        /** Reserved. */
+        const Forint = 'Forint';
+
+        /** Reserved. */
+        const HongKongDollar = 'HongKongDollar';
+
+        /** Reserved. */
+        const IndianRupee = 'IndianRupee';
+
+        /** Reserved. */
+        const JapaneseYen = 'JapaneseYen';
+
+        /** Reserved. */
+        const LebanesePound = 'LebanesePound';
+
+        /** Reserved. */
+        const MalaysianRinggit = 'MalaysianRinggit';
+
+        /** Reserved. */
+        const MexicanPeso = 'MexicanPeso';
+
+        /** Reserved. */
+        const MoroccanDirham = 'MoroccanDirham';
+
+        /** Reserved. */
+        const NewTaiwanDollar = 'NewTaiwanDollar';
+
+        /** Reserved. */
+        const NewZealandDollar = 'NewZealandDollar';
+
+        /** Reserved. */
+        const NorwegianKrone = 'NorwegianKrone';
+
+        /** Reserved. */
+        const NuevoSol = 'NuevoSol';
+
+        /** Reserved. */
+        const PhilippinePeso = 'PhilippinePeso';
+
+        /** Reserved. */
+        const QatariRial = 'QatariRial';
+
+        /** Reserved. */
+        const Rupiah = 'Rupiah';
+
+        /** Reserved. */
+        const SaudiRiyal = 'SaudiRiyal';
+
+        /** Reserved. */
+        const SingaporeDollar = 'SingaporeDollar';
+
+        /** Reserved. */
+        const SouthAfricanRand = 'SouthAfricanRand';
+
+        /** Reserved. */
+        const SwedishKrona = 'SwedishKrona';
+
+        /** Reserved. */
+        const SwissFranc = 'SwissFranc';
+
+        /** Reserved. */
+        const TurkishLira = 'TurkishLira';
+
+        /** Reserved. */
+        const UKPound = 'UKPound';
+
+        /** Reserved. */
+        const USDollar = 'USDollar';
+
+        /** Reserved. */
+        const Won = 'Won';
+
+        /** Reserved. */
+        const YuanRenminbi = 'YuanRenminbi';
+
+        /** Reserved. */
+        const PolishZloty = 'PolishZloty';
+
+        /** Reserved. */
+        const UAEDirham = 'UAEDirham';
+
+        /** Reserved. */
+        const IsraeliSheqel = 'IsraeliSheqel';
+
+        /** Reserved. */
+        const NigerianNaira = 'NigerianNaira';
+    }
+
+}

src/V13/AdInsight/DecimalRoundedResult.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Microsoft\BingAds\V13\AdInsight;
+
+{
+    /**
+     * Reserved.
+     * @link https:/learn.microsoft.com/advertising/ad-insight-service/decimalroundedresult?view=bingads-13 DecimalRoundedResult Data Object
+     * 
+     * @uses ScaleUnit
+     * @used-by RangeResultOfDecimalRoundedResult
+     * @used-by GetAudienceFullEstimationResponse
+     */
+    final class DecimalRoundedResult
+    {
+        /**
+         * Reserved.
+         * @var double
+         */
+        public $Value;
+
+        /**
+         * Reserved.
+         * @var ScaleUnit
+         */
+        public $Unit;
+    }
+
+}