Bing Ads Python SDK version 10.4.3 release

HISTORY.rst

@@ -3,6 +3,14 @@
 Release History
 ---------------
 
+10.4.3(2016-04-30)
+++++++++++++++++++
+
+* Changed condition to write delete value for Keyword Bid in bulk
+* Support suds option in BulkServiceManager and ReportingServiceManager
+* Updated wsdl proxy to latest version
+* Bug fixes
+
 10.4.2(2016-03-30)
 ++++++++++++++++++
 

bingads/bulk/bulk_service_manager.py

@@ -52,6 +52,7 @@ def __init__(self, authorization_data, poll_interval_in_milliseconds=5000, envir
         # make sure the working directory exists or create it.
         if not os.path.exists(self._working_directory):
             os.makedirs(self._working_directory)
+        self._suds_options = suds_options
 
     def download_file(self, download_parameters, progress=None):
         """ Downloads the specified Bulk entities to a local file.
@@ -225,7 +226,7 @@ def submit_download(self, submit_download_parameters):
             authorization_data=self._authorization_data,
             poll_interval_in_milliseconds=self._poll_interval_in_milliseconds,
             environment=self._environment,
-            location=self.service_client.service_url,
+            **self.suds_options
         )
         return operation
 
@@ -256,7 +257,7 @@ def submit_upload(self, submit_upload_parameters):
             authorization_data=self._authorization_data,
             poll_interval_in_milliseconds=self._poll_interval_in_milliseconds,
             environment=self._environment,
-            location=self.service_client.service_url,
+            **self.suds_options
         )
         return operation
 
@@ -351,3 +352,15 @@ def working_directory(self):
     def working_directory(self, value):
         self._working_directory = value
 
+    @property
+    def suds_options(self):
+        """ suds option parameters
+
+        :return: dict
+        """
+        return self._suds_options
+
+    @suds_options.setter
+    def suds_options(self, value):
+        self._suds_options = value
+

bingads/bulk/entities/ad_extensions/bulk_site_links_ad_extensions.py

@@ -37,9 +37,9 @@ class BulkAdGroupSiteLinkAdExtension(_BulkAdGroupAdExtensionAssociation):
     """ Represents an ad group level sitelink ad extension.
 
     This class exposes properties that can be read and written
-    as fields of the Ad Group Sitelink Ad Extension record in a bulk file.
+    as fields of the AdGroup Sitelink Ad Extension record in a bulk file.
 
-    For more information, see Ad Group Sitelink Ad Extension at http://go.microsoft.com/fwlink/?LinkID=511552.
+    For more information, see AdGroup Sitelink Ad Extension at http://go.microsoft.com/fwlink/?LinkID=511552.
 
     *See also:*
 
@@ -201,7 +201,7 @@ def version(self, value):
         _SimpleBulkMapping(
             header=_StringTable.SiteLinkExtensionOrder,
             field_to_csv=lambda c: bulk_str(c.order),
-            csv_to_field=lambda c, v: setattr(c, 'order', int(v))
+            csv_to_field=lambda c, v: setattr(c, 'order', int(v) if v else None)
         ),
         _SimpleBulkMapping(
             header=_StringTable.SiteLinkDisplayText,

bingads/bulk/file_reader.py

@@ -88,7 +88,7 @@ def _read_next_batch(self):
         Batch means a set of related entities.
         It can be one :class:`._SingleRecordBulkEntity`, one :class:`._MultiRecordBulkEntity` containing its child
         entities or a set of related child entities (for example several :class:`.BulkSiteLink`s logically belonging
-        to the same SiteLink AdExtension.
+        to the same SiteLink Ad Extension.
 
         :return: Next batch of entities
         :rtype: _SingleRecordBulkEntity or _MultiRecordBulkEntity

bingads/internal/bulk/string_table.py

@@ -86,7 +86,7 @@ class _StringTable:
     SocialNetworkAdExtension = "Social Network Ad Extension"
     Version = "Version"
 
-    # Image AdExtension
+    # Image Ad Extension
     AltText = "Alternative Text"
     MediaId = "Media Id"
     CampaignImageAdExtension = "Campaign Image Ad Extension"
@@ -137,7 +137,7 @@ class _StringTable:
     KeywordMainLineBidType = "Keyword Main Line Bid"
     KeywordBestPositionBidType = "Keyword Best Position Bid"
 
-    # Product AdExtension
+    # Product Ad Extension
     CampaignProductAdExtension = "Campaign Product Ad Extension"
     ProductCondition4 = "Product Condition 4"
     ProductCondition5 = "Product Condition 5"

bingads/internal/extensions.py

@@ -280,9 +280,9 @@ def ad_group_bid_bulk_str(value):
 
 def keyword_bid_bulk_str(value):
     if value is None:
-        return None
-    if value.Amount is None:
         return DELETE_VALUE
+    if value.Amount is None:
+        return None
     return bulk_str(value.Amount)
 
 

bingads/manifest.py

@@ -1,4 +1,4 @@
-VERSION = '10.4.2'
+VERSION = '10.4.3'
 BULK_FORMAT_VERSION = '3.0'
 BULK_FORMAT_VERSION_4 = '4.0'
 WORKING_NAME = 'BingAdsSDKPython'

bingads/reporting/reporting_service_manager.py

@@ -45,6 +45,7 @@ def __init__(self, authorization_data, poll_interval_in_milliseconds=5000, envir
         # make sure the working directory exists or create it.
         if not os.path.exists(self._working_directory):
             os.makedirs(self._working_directory)
+        self._suds_options = suds_options
 
     def download_file(self, download_parameters):
         """ Downloads the specified reporting to a local file.
@@ -88,7 +89,7 @@ def submit_download(self, report_request):
             authorization_data=self._authorization_data,
             poll_interval_in_milliseconds=self._poll_interval_in_milliseconds,
             environment=self._environment,
-            location=self.service_client.service_url
+            **self.suds_options
         )
         return operation
 
@@ -127,3 +128,15 @@ def working_directory(self):
     @working_directory.setter
     def working_directory(self, value):
         self._working_directory = value
+
+    @property
+    def suds_options(self):
+        """ suds option parameters
+
+        :return: dict
+        """
+        return self._suds_options
+
+    @suds_options.setter
+    def suds_options(self, value):
+        self._suds_options = value

bingads/v10/bulk/bulk_service_manager.py

@@ -52,6 +52,7 @@ def __init__(self, authorization_data, poll_interval_in_milliseconds=5000, envir
         # make sure the working directory exists or create it.
         if not os.path.exists(self._working_directory):
             os.makedirs(self._working_directory)
+        self._suds_options = suds_options
 
     def download_file(self, download_parameters, progress=None):
         """ Downloads the specified Bulk entities to a local file.
@@ -221,7 +222,7 @@ def submit_download(self, submit_download_parameters):
             authorization_data=self._authorization_data,
             poll_interval_in_milliseconds=self._poll_interval_in_milliseconds,
             environment=self._environment,
-            location=self.service_client.service_url,
+            **self.suds_options
         )
         return operation
 
@@ -251,7 +252,7 @@ def submit_upload(self, submit_upload_parameters):
             authorization_data=self._authorization_data,
             poll_interval_in_milliseconds=self._poll_interval_in_milliseconds,
             environment=self._environment,
-            location=self.service_client.service_url,
+            **self.suds_options
         )
         return operation
 
@@ -343,3 +344,15 @@ def working_directory(self):
     @working_directory.setter
     def working_directory(self, value):
         self._working_directory = value
+
+    @property
+    def suds_options(self):
+        """ suds option parameters
+
+        :return: dict
+        """
+        return self._suds_options
+
+    @suds_options.setter
+    def suds_options(self, value):
+        self._suds_options = value

bingads/v10/bulk/entities/ad_extensions/bulk_site_links_ad_extensions.py

@@ -38,9 +38,9 @@ class BulkAdGroupSiteLinkAdExtension(_BulkAdGroupAdExtensionAssociation):
     """ Represents an ad group level sitelink ad extension.
 
     This class exposes properties that can be read and written
-    as fields of the Ad Group Sitelink Ad Extension record in a bulk file.
+    as fields of the AdGroup Sitelink Ad Extension record in a bulk file.
 
-    For more information, see Ad Group Sitelink Ad Extension at http://go.microsoft.com/fwlink/?LinkID=620262.
+    For more information, see AdGroup Sitelink Ad Extension at http://go.microsoft.com/fwlink/?LinkID=620262.
 
     *See also:*
 
@@ -202,7 +202,7 @@ def version(self, value):
         _SimpleBulkMapping(
             header=_StringTable.SiteLinkExtensionOrder,
             field_to_csv=lambda c: bulk_str(c.order),
-            csv_to_field=lambda c, v: setattr(c, 'order', int(v))
+            csv_to_field=lambda c, v: setattr(c, 'order', int(v) if v else None)
         ),
         _SimpleBulkMapping(
             header=_StringTable.SiteLinkDisplayText,

bingads/v10/bulk/entities/bulk_ads.py

@@ -234,7 +234,7 @@ def process_mappings_to_row_values(self, row_values, exclude_readonly_data):
 
 
 class BulkTextAd(_BulkAd):
-    """ Represents a product ad.
+    """ Represents a Text Ad.
 
     This class exposes the :attr:`text_ad` property that can be read and written as fields of the Text Ad record in a bulk file.
 

bingads/v10/bulk/file_reader.py

@@ -90,7 +90,7 @@ def _read_next_batch(self):
         Batch means a set of related entities.
         It can be one :class:`._SingleRecordBulkEntity`, one :class:`._MultiRecordBulkEntity` containing its child
         entities or a set of related child entities (for example several :class:`.BulkSiteLink`s logically belonging
-        to the same SiteLink AdExtension.
+        to the same SiteLink Ad Extension.
 
         :return: Next batch of entities
         :rtype: _SingleRecordBulkEntity or _MultiRecordBulkEntity

bingads/v10/internal/bulk/string_table.py

@@ -82,13 +82,13 @@ class _StringTable:
     SocialNetworkAdExtension = "Social Network Ad Extension"
     Version = "Version"
 
-    # Image AdExtension
+    # Image Ad Extension
     AltText = "Alternative Text"
     MediaIds = "Media Ids"
     CampaignImageAdExtension = "Campaign Image Ad Extension"
     AdGroupImageAdExtension = "Ad Group Image Ad Extension"
 
-    # SiteLink AdExtensions
+    # SiteLink Ad Extensions
     SiteLinkExtensionOrder = "Sitelink Extension Order"
     SiteLinkDisplayText = "Sitelink Extension Link Text"
     SiteLinkDestinationUrl = "Sitelink Extension Destination Url"
@@ -97,7 +97,7 @@ class _StringTable:
     CampaignSiteLinksAdExtension = "Campaign Sitelink Ad Extension"
     AdGroupSiteLinksAdExtension = "AdGroup Sitelink Ad Extension"
 
-    # Location AdExtensions
+    # Location Ad Extensions
     AddressLine1 = "Address Line 1"
     AddressLine2 = "Address Line 2"
     PostalCode = "Postal Code"
@@ -109,7 +109,7 @@ class _StringTable:
     ImageMediaId = "Business Icon"
     CampaignLocationAdExtension = "Campaign Location Ad Extension"
 
-    # Call AdExtensions
+    # Call Ad Extensions
     CountryCode = "Country Code"
     IsCallOnly = "Call Only"
     CampaignCallAdExtension = "Campaign Call Ad Extension"
@@ -119,31 +119,28 @@ class _StringTable:
     # Editorial Rejection Reasons
     PublisherCountries = "Publisher Countries"
 
-    # Product Target
-    ProductTargetType = "Ad Group Product Target"
-    ProductCondition1 = "Product Condition 1"
-    ProductCondition2 = "Product Condition 2"
-    ProductCondition3 = "Product Condition 3"
-    ProductValue1 = "Product Value 1"
-    ProductValue2 = "Product Value 2"
-    ProductValue3 = "Product Value 3"
-
     # BTE Types
     KeywordFirstPageBidType = "Keyword First Page Bid"
     KeywordMainLineBidType = "Keyword Main Line Bid"
     KeywordBestPositionBidType = "Keyword Best Position Bid"
 
-    # Product AdExtension
+    ProductCondition1 = "Product Condition 1"
+    ProductCondition2 = "Product Condition 2"
+    ProductCondition3 = "Product Condition 3"
     ProductCondition4 = "Product Condition 4"
     ProductCondition5 = "Product Condition 5"
     ProductCondition6 = "Product Condition 6"
     ProductCondition7 = "Product Condition 7"
     ProductCondition8 = "Product Condition 8"
+    ProductValue1 = "Product Value 1"
+    ProductValue2 = "Product Value 2"
+    ProductValue3 = "Product Value 3"
     ProductValue4 = "Product Value 4"
     ProductValue5 = "Product Value 5"
     ProductValue6 = "Product Value 6"
     ProductValue7 = "Product Value 7"
     ProductValue8 = "Product Value 8"
+
     BingMerchantCenterId = "Store Id"
     BingMerchantCenterName = "Store Name"
 

setup.py

@@ -3,7 +3,7 @@
 except ImportError:
     from distutils.core import setup
 
-VERSION = '10.4.2'
+VERSION = '10.4.3'
 
 with open('README.rst', 'r') as f:
     readme = f.read()