Merge pull request #150 from BingAds/jianyun/13.0.9

sdk 13.0.9

Author: JianyunZhao

samples/V13/AuthHelper.php

@@ -78,10 +78,6 @@ final class AuthHelper {
 
     static function Authenticate() 
     {   
-        // Disable WSDL caching.
-        ini_set("soap.wsdl_cache_enabled", "0");
-        ini_set("soap.wsdl_cache_ttl", "0");
-
         // Authenticate with a Microsoft Account.
         AuthHelper::AuthenticateWithOAuth();
 

src/Auth/ServiceClient.php

@@ -31,6 +31,7 @@ class ServiceClient
 	private $service;
 	private $namespace;
 	private $apiEnvironment;
+	private $options;
 
 	private $sandboxServiceClientEndpoints = array(
 		ServiceClientType::AdInsightVersion13 => AdInsightServiceSettingsVersion13::SandboxEndpoint,
@@ -83,7 +84,7 @@ private function to_long_xml($longVal)
 		return '<long>' . $longVal . '</long>';
 	}
 
-	public function __construct($serviceClientType, $authorizationData, $apiEnvironment)
+	public function __construct($serviceClientType, $authorizationData, $apiEnvironment, $options = array())
 	{
 		// The sandbox environment is used unless the Production environment is explicitly set.
 
@@ -102,6 +103,7 @@ public function __construct($serviceClientType, $authorizationData, $apiEnvironm
 
         $this->apiEnvironment = $apiEnvironment;
 		$this->namespace = $this->serviceClientNamespaces[$serviceClientType];
+		$this->options = $options;
 
 		$this->SetAuthorizationData($authorizationData);
 
@@ -234,13 +236,14 @@ private function RefreshServiceProxy()
 		 * To force PHP to always return an array for an array type in the
 		 * response, specify the SOAP_SINGLE_ELEMENT_ARRAYS feature.
          */ 
-		$options = array(
+		$default_options = array(
 			'trace' => TRUE,
 			'exceptions' => TRUE,
 			'features' => SOAP_SINGLE_ELEMENT_ARRAYS,
 			// Disable keep_alive to avoid 'Process open FD table is full'
 			'keep_alive' => FALSE, 
-			'user_agent' => 'BingAdsSDKPHP ' . '13.0.1 ' . PHP_VERSION, 
+			'user_agent' => 'BingAdsSDKPHP ' . '13.0.9 ' . PHP_VERSION, 
+			'cache_wsdl' => 'WSDL_CACHE_NONE',
 
 			/** 
 			 * Map long type to string type. For details, see
@@ -256,7 +259,9 @@ private function RefreshServiceProxy()
 			)
 		);
 
-		$proxy = @new SOAPClient($this->wsdlUrl, $options);
+		$mergedOptions = array_merge($default_options, $this->options);
+
+		$proxy = @new SOAPClient($this->wsdlUrl, $mergedOptions);
 
 		$proxy->__setSoapHeaders($headers);
 

src/V13/Bulk/DownloadEntity.php

@@ -405,8 +405,20 @@ final class DownloadEntity
         /** Include Ad Group Flyer Ad Extension records in the download that each represent the association relationship between an ad group and a flyer ad extension. */
         const AdGroupFlyerAdExtensions = 'AdGroupFlyerAdExtensions';
 
-        /** Reserved. */
+        /** Include Bid Strategy records in the download data. */
         const BidStrategies = 'BidStrategies';
+
+        /** Reserved. */
+        const VideoAdExtensions = 'VideoAdExtensions';
+
+        /** Reserved. */
+        const AccountVideoAdExtensions = 'AccountVideoAdExtensions';
+
+        /** Reserved. */
+        const CampaignVideoAdExtensions = 'CampaignVideoAdExtensions';
+
+        /** Reserved. */
+        const AdGroupVideoAdExtensions = 'AdGroupVideoAdExtensions';
     }
 
 }

src/V13/CampaignManagement/AccountPropertyName.php

@@ -32,6 +32,9 @@ final class AccountPropertyName
 
         /** Used to get or set the property that determines whether LinkedIn profile targeting expansion is enabled for the account. */
         const ProfileExpansionEnabled = 'ProfileExpansionEnabled';
+
+        /** Reserved. */
+        const AllowCrawlImagesFromLandingPage = 'AllowCrawlImagesFromLandingPage';
     }
 
 }

src/V13/CampaignManagement/AdAdditionalField.php

@@ -15,6 +15,9 @@ final class AdAdditionalField
     {
         /** Request that the ImpressionTrackingUrls element be included within each returned ResponsiveAd object. */
         const ImpressionTrackingUrls = 'ImpressionTrackingUrls';
+
+        /** Reserved. */
+        const Videos = 'Videos';
     }
 
 }

src/V13/CampaignManagement/AdExtensionsTypeFilter.php

@@ -51,6 +51,9 @@ final class AdExtensionsTypeFilter
 
         /** An ad extension that enables advertisers to distribute product or store catalogues (flyers) to potential customers. */
         const FlyerAdExtension = 'FlyerAdExtension';
+
+        /** Reserved. */
+        const VideoAdExtension = 'VideoAdExtension';
     }
 
 }

src/V13/CampaignManagement/AdGroup.php

@@ -137,6 +137,18 @@ final class AdGroup
          * @var string
          */
         public $AdGroupType;
+
+        /**
+         * Reserved.
+         * @var Bid
+         */
+        public $CpvBid;
+
+        /**
+         * Reserved.
+         * @var Bid
+         */
+        public $CpmBid;
     }
 
 }

src/V13/CampaignManagement/AdGroupAdditionalField.php

@@ -17,6 +17,12 @@ final class AdGroupAdditionalField
 
         /** Request that the AdGroupType element be included within each returned AdGroup object. */
         const AdGroupType = 'AdGroupType';
+
+        /** Reserved. */
+        const CpvBid = 'CpvBid';
+
+        /** Reserved. */
+        const CpmBid = 'CpmBid';
     }
 
 }

src/V13/CampaignManagement/AddBidStrategiesRequest.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Defines the AddBidStrategies Service Operation.
+     * Adds bid strategies to an account's portfolio bid strategy library.
      * @link https://docs.microsoft.com/en-us/advertising/campaign-management-service/addbidstrategies?view=bingads-13 AddBidStrategies Request Object
      * 
      * @uses BidStrategy
@@ -13,7 +13,7 @@
     final class AddBidStrategiesRequest
     {
         /**
-         * Reserved.
+         * An array of BidStrategy objects to add to the account's portfolio bid strategy library.
          * @var BidStrategy[]
          */
         public $BidStrategies;

src/V13/CampaignManagement/AddBidStrategiesResponse.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Defines the AddBidStrategies Service Operation.
+     * Adds bid strategies to an account's portfolio bid strategy library.
      * @link https://docs.microsoft.com/en-us/advertising/campaign-management-service/addbidstrategies?view=bingads-13 AddBidStrategies Response Object
      * 
      * @uses BatchError
@@ -13,13 +13,13 @@
     final class AddBidStrategiesResponse
     {
         /**
-         * Reserved.
+         * A list of unique system identifiers corresponding to the bid strategies that were added.
          * @var integer[]
          */
         public $BidStrategyIds;
 
         /**
-         * Reserved.
+         * An array of BatchError objects that contain details for any request items that were not successful.
          * @var BatchError[]
          */
         public $PartialErrors;