What are the differences between gdata.docs.service.DocsService and gdata.docs.client.DocsClient?

Question

There are similarities (in authentication and several other operations, for example, both can get a list of documents), but what are the differences? Why both of us?

I am learning gdata api and I realized that I can log in using the OAuth access token this way (using DocsClient):

self.client = gdata.docs.client.DocsClient() self.client.auth_token = gdata.gauth.OAuthHmacToken(consumer.key, consumer.secret, user.access_token.key, user.access_token.secret, gdata.gauth.ACCESS_TOKEN) 

but I don’t know how to do the same with DocsService.

Answer 1

The file modification time in the source tree may contain some hints:

http://code.google.com/p/gdata-python-client/source/browse/#hg%2Fsrc%2Fgdata%2Fdocs

where service.py is 2 years, so I suspect this is for an older version of the API, while client.py is currently working with DocumentList API 3.0. I believe DocsService is version 1 and now depreciated?