Fixing problems with a DFA example

Author: Joseph DiLallo

ChangeLog

@@ -1,11 +1,24 @@
+1.0.3 - 04/02/2014
+==================
+* The common module's LoadFromStorage method now parses the yaml file with
+  safe_load rather than load.
+* Fixed a typo in examples/dfa/authentication/create_dfa_client_without_yaml.py
+  (the service was 'CampaignService' instead of 'campaign'). This resolves
+  issue #4.
+* Changed examples/dfa/authentication/create_dfa_client_without_yaml.py to run
+  against the DFA test environment in order to match all other DFA examples.
+* Changed common._PackForSuds to force suds to serialize empty objects into XML.
+  There are many use cases for this in Google's Ads APIs, such as passing empty
+  search criteria into DFA search methods in order to select everything.
+
 1.0.2 - 03/20/2014
 ==================
-- Fixed a typo in examples/dfp/auth/generate_refresh_token.py (there was a
-  trailing comma after the scope).
+* Fixed a typo in examples/dfp/authentication/generate_refresh_token.py (there
+  was a trailing comma after the scope).
 
 1.0.1 - 03/13/2014
 ==================
-- Fixed a bug with the AdWords ReportDownloader failing to decode unicode
+* Fixed a bug with the AdWords ReportDownloader failing to decode unicode
   characters in reports. This resolves issue #1.
 
 1.0.0 - 03/05/2014

README.md

@@ -37,6 +37,14 @@ in the fields for the API you plan to use. The library's `LoadFromStorage`
 methods default to looking for a file with this name in your home directory,
 but you can pass in a path to any file with the correct yaml contents.
 
+```python
+# Use the default location - your home directory:
+adwords_client = adwords.AdWordsClient.LoadFromStorage()
+
+# Alternatively, pass in the location of the file:
+dfp_client = dfp.DfpClient.LoadFromStorage('C:\My\Directory\googleads.yaml')
+```
+
 ##Where do I submit bug reports and/or feature requests?
 
 Use the issue tracker at:
@@ -93,7 +101,6 @@ suds_client.set_options(
 suds_client.service.mutate([operation])
 ```
 
-
 ##External Dependencies:
 
 

examples/adwords/v201402/account_management/create_account.py

@@ -21,6 +21,11 @@
 Note: this code example won't work with test accounts. See
 https://developers.google.com/adwords/api/docs/test-accounts
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: CreateAccountService.mutate
 Api: AdWordsOnly
 """

examples/adwords/v201402/account_management/get_account_alerts.py

@@ -21,6 +21,11 @@
 Note: this code example won't work with test accounts. See
 https://developers.google.com/adwords/api/docs/test-accounts
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: AlertService.get
 Api: AdWordsOnly
 """

examples/adwords/v201402/account_management/get_account_changes.py

@@ -16,6 +16,11 @@
 
 """This example gets the changes in the account during the last 24 hours.
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: CustomerSyncService.get
 """
 

examples/adwords/v201402/account_management/get_account_hierarchy.py

@@ -19,6 +19,11 @@
 Note: this code example won't work with test accounts. See
 https://developers.google.com/adwords/api/docs/test-accounts
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: ServicedAccountService.get
 Api: AdWordsOnly
 """

examples/adwords/v201402/advanced_operations/add_ad_group_bid_modifier.py

@@ -18,6 +18,11 @@
 
 To get your ad groups, run get_ad_groups.py.
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: AdGroupBidModifierService.mutate
 """
 

examples/adwords/v201402/advanced_operations/add_click_to_download_ad.py

@@ -19,6 +19,11 @@
 This type of ad is also known as an app promotion ad. To list ad groups, run
 get_ad_groups.py.
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: AdGroupAdService.mutate
 Api: AdWordsOnly
 """

examples/adwords/v201402/advanced_operations/add_places_location_extensions.py

@@ -19,6 +19,11 @@
 
 This example associates the feed with a customer.
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: CustomerFeedService.mutate, FeedService.mutate
 """
 

examples/adwords/v201402/advanced_operations/add_site_links.py

@@ -16,6 +16,11 @@
 
 """This example adds a sitelinks feed and associates it with a campaign.
 
+The LoadFromStorage method is pulling credentials and properties from a
+"googleads.yaml" file. By default, it looks for this file in your home
+directory. For more information, see the "Caching authentication information"
+section of our README.
+
 Tags: CampaignFeedService.mutate, FeedItemService.mutate
 Tags: FeedMappingService.mutate, FeedService.mutate
 Api: AdWordsOnly