Removing AdWords v201502 and adding Batch Job Incremental Upload Support.

Author: msaniscalchi

ChangeLog

@@ -1,3 +1,15 @@
+3.11.0 -- 11/24/2015
+* Removed support for AdWords v201502.
+* Added incremental upload support to BatchJobHelper.
+* Added the add_keywords_using_incremental_batch_job.py to advanced_operations
+  examples.
+* Moved add_complete_campaigns_using_batch_job.py to advanced_operations.
+* The BatchJobHelper can now be used to parse the BatchJob response. Examples
+  have been updated to demonstrate this.
+* The xmltodict library has been added as a new dependency.
+* Added option to set additional scopes in generate_refresh_token.py for
+  AdWords and DFP.
+
 3.10.0 - 11/17/2015
 * Removed support for DFP v201405 and v201408.
 * Removed examples for v201411.

examples/adwords/authentication/generate_refresh_token.py

@@ -17,6 +17,7 @@
 """Generates refresh token for AdWords using the Installed Application flow."""
 
 
+import argparse
 import sys
 
 from oauth2client import client
@@ -29,13 +30,24 @@
 # The AdWords API OAuth 2.0 scope.
 SCOPE = u'https://www.googleapis.com/auth/adwords'
 
+parser = argparse.ArgumentParser(description='Generates a refresh token with '
+                                 'the provided credentials.')
+parser.add_argument('--client_id', default=CLIENT_ID,
+                    help='Client Id retrieved from the Developer\'s Console.')
+parser.add_argument('--client_secret', default=CLIENT_SECRET,
+                    help='Client Secret retrieved from the Developer\'s '
+                    'Console.')
+parser.add_argument('--additional_scopes', default=None,
+                    help='Additional scopes to apply when generating the '
+                    'refresh token. Each scope should be separated by a comma.')
 
-def main():
+
+def main(client_id, client_secret, scopes):
   """Retrieve and display the access and refresh token."""
   flow = client.OAuth2WebServerFlow(
-      client_id=CLIENT_ID,
-      client_secret=CLIENT_SECRET,
-      scope=[SCOPE],
+      client_id=client_id,
+      client_secret=client_secret,
+      scope=scopes,
       user_agent='Ads Python Client Library',
       redirect_uri='urn:ietf:wg:oauth:2.0:oob')
 
@@ -58,4 +70,10 @@ def main():
 
 
 if __name__ == '__main__':
-  main()
+  args = parser.parse_args()
+  configured_scopes = [SCOPE]
+  if args.client_id == CLIENT_ID or args.client_secret == CLIENT_SECRET:
+    raise AttributeError('No client_id or client_secret specified.')
+  if args.additional_scopes:
+    configured_scopes.extend(args.additional_scopes.replace(' ', '').split(','))
+  main(args.client_id, args.client_secret, configured_scopes)