Removing support for AdWords v201509

Author: msaniscalchi

ChangeLog

@@ -1,3 +1,16 @@
+4.2.0 -- 6/13/2016
+* Removed support and examples for AdWords v201509.
+* The AdWords ReportDownloader now accepts a "client_customer_id" keyword
+  argument that overrides the default client customer ID.
+* For utilities such as the ReportDownloader or BatchJobHelper, data points
+  about usage are now sent in the user-agent of API requests by default. This
+  can be disabled with the new include_utilities_in_user_agent configuration in
+  the googleads.yaml file.
+* Added a new parallel_report_download.py example.
+* Resolved issues:
+  Issue #122: https://github.com/googleads/googleads-python-lib/issues/122
+  Issue #123: https://github.com/googleads/googleads-python-lib/issues/123
+
 4.1.0 -- 5/26/2016
 * Added support for AdWords v201605.
 * Added new use_raw_enum_values keyword argument to the AdWords ReportDownloader

README.md

@@ -9,6 +9,9 @@ code to help you get started integrating with our APIs.
 ##Getting started
 1. Download and install the library
 
+   *[setuptools](https://pypi.python.org/pypi/setuptools) is a pre-requisite
+   for installing the googleads library*
+
    It is recommended that you install the library and its dependencies from
    PyPI using [pip](https://pip.pypa.io/en/stable/installing/). This can be
    accomplished with a single command:
@@ -144,6 +147,17 @@ suds_client.set_options(
 suds_client.service.mutate([operation])
 ```
 
+##Timeout Tips
+The requests sent by this library are sent via urllib, which is consequently
+where the timeout is set. If you set a system timeout elsewhere, the googleads
+library will respect it.
+
+You can do the following if you wish to override the timeout:
+
+```python
+import socket
+socket.setdefaulttimeout(15 * 60)
+```
 
 ##External Dependencies: