update to version 11.12.4

Author: qitia

HISTORY.rst

@@ -1,11 +1,16 @@
 .. :changelog:
 
 Release History
+-----------
+11.12.4(2018-07-10)
+* Added a mapping for the Domain column in the Bulk file to the BulkExpandedTextAd object.
+* Limited the scope to bingads.manage for access token requests. Previously the default scope was used, which can vary if a user granted your app permissions to multiple scopes. The Bing Ads SDKs only support the bingads.manage scope. 
+* Updated the Customer Management proxies to support LinkedAccountIds for agencies. For agency users the customer role can contain a list of linked accounts that the user can access as an agency on behalf of another customer. 
+
 -----------
 11.12.3(2018-06-10)
-Added support for Cooperative bidding e.g., added mappings for "Bid Boost Value", "Bid Option" and "Maximum Bid" fields via the BulkAdGroup. 
- 
-Added mappings for the 'MSCLKID Auto Tagging Enabled" and "Tracking Tempalte" fields via the BulkAccount.
+* Added support for Cooperative bidding e.g., added mappings for "Bid Boost Value", "Bid Option" and "Maximum Bid" fields via the BulkAdGroup. 
+* Added mappings for the 'MSCLKID Auto Tagging Enabled" and "Tracking Tempalte" fields via the BulkAccount.
 
 -----------
 11.12.2(2018-05-15)

bingads/authorization.py

@@ -431,6 +431,7 @@ def request_oauth_tokens_by_refresh_token(self, refresh_token):
             grant_type='refresh_token',
             refresh_token=refresh_token,
             environment=self.environment,
+            scope='bingads.manage',
         )
         if self.token_refreshed_callback is not None:
             self.token_refreshed_callback(self.oauth_tokens)  # invoke the callback when token refreshed.

bingads/manifest.py

@@ -1,5 +1,5 @@
 import sys
-VERSION = '11.12.3'
+VERSION = '11.12.4'
 BULK_FORMAT_VERSION_5 = '5.0'
 BULK_FORMAT_VERSION_6 = '6.0'
 WORKING_NAME = 'BingAdsSDKPython'

bingads/v11/bulk/bulk_service_manager.py

@@ -250,6 +250,13 @@ def submit_upload(self, submit_upload_parameters):
         request_id = response.RequestId
         upload_url = response.UploadUrl
 
+        if  submit_upload_parameters.rename_upload_file_to_match_request_id:
+            import os
+            dir = os.path.dirname(submit_upload_parameters.upload_file_path)
+            new_file_to_upload = os.path.join(dir, 'upload_' + request_id + '.csv')
+            os.rename(submit_upload_parameters.upload_file_path, new_file_to_upload)
+            submit_upload_parameters.upload_file_path = new_file_to_upload
+
         self._upload_file_by_url(
             url=upload_url,
             upload_file_path=submit_upload_parameters.upload_file_path,

bingads/v11/bulk/entities/bulk_ads.py

@@ -462,14 +462,19 @@ def expanded_text_ad(self, expanded_text_ad):
         ),
         _SimpleBulkMapping(
             header=_StringTable.Path1,
-            field_to_csv=lambda c: c.expanded_text_ad.Path1,
+            field_to_csv=lambda c: bulk_optional_str(c.expanded_text_ad.Path1),
             csv_to_field=lambda c, v: setattr(c.expanded_text_ad, 'Path1', v)
         ),
         _SimpleBulkMapping(
             header=_StringTable.Path2,
-            field_to_csv=lambda c: c.expanded_text_ad.Path2,
+            field_to_csv=lambda c: bulk_optional_str(c.expanded_text_ad.Path2),
             csv_to_field=lambda c, v: setattr(c.expanded_text_ad, 'Path2', v)
         ),
+        _SimpleBulkMapping(
+            header=_StringTable.DisplayUrl,
+            field_to_csv=lambda c: bulk_optional_str(c.expanded_text_ad.DisplayUrl),
+            csv_to_field=lambda c, v: setattr(c.expanded_text_ad, 'DisplayUrl', v)
+        ),
     ]
 
     def process_mappings_from_row_values(self, row_values):

bingads/v11/bulk/upload_parameters.py

@@ -11,7 +11,8 @@ def __init__(self,
                  overwrite_result_file=False,
                  compress_upload_file=True,
                  response_mode='ErrorsAndResults',
-                 timeout_in_milliseconds=None):
+                 timeout_in_milliseconds=None,
+                 rename_upload_file_to_match_request_id=True):
         """ Initialize a new instance of this class.
 
         :param result_file_directory: The directory where the file will be downloaded.
@@ -43,6 +44,7 @@ def __init__(self,
             upload_file_path=upload_file_path,
             compress_upload_file=compress_upload_file,
             response_mode=response_mode,
+            rename_upload_file_to_match_request_id=rename_upload_file_to_match_request_id
         )
         self._timeout_in_milliseconds=timeout_in_milliseconds
 
@@ -142,7 +144,8 @@ def __init__(self,
                  upload_file_path,
                  compress_upload_file=True,
                  response_mode='ErrorsAndResults',
-                 timeout_in_milliseconds=None):
+                 timeout_in_milliseconds=None,
+                 rename_upload_file_to_match_request_id=True):
         """ Initialize a new instance of this class.
 
         :param upload_file_path: The fully qualified local path of the upload file.
@@ -160,6 +163,15 @@ def __init__(self,
         self._compress_upload_file = compress_upload_file
         self._response_mode = response_mode
         self._timeout_in_milliseconds = timeout_in_milliseconds
+        self._rename_upload_file_to_match_request_id=rename_upload_file_to_match_request_id
+
+    @property
+    def rename_upload_file_to_match_request_id(self):
+        """ rename the upload file to request id or not.
+
+        :rtype: boolean
+        """
+        return self._rename_upload_file_to_match_request_id
 
     @property
     def upload_file_path(self):