And remain sane and alive ------------------------------------+++
Here's the deal, the Google docs API is really neat, if you can dance oauth. But, by allowing to do all that crazy stuff with documents is bound to be really complicated -just read that xml, is like something only robots should ever gaze at!. But the nice guys over at google have developed some client libraries, and one of those is the gdata python client library. Which combines all that power with the python inherent simplicity.
But there's a caveat: there's so much stuff that the documentation is sometimes outdated or just plain wrong, as is the case with pdf uploads via the version 1.0 of the API. They would swear that you can upload pdf files. But no, you can't, not with old versions of the client nor with the latest release (at least as of the writing of this post, the version 2.0.11).
So, let's just show our users a message that says "oops, bummer, no can do".
We're working on a project that integrates with google docs were possibly 90% of the user document uploads will surely be pdf files. So something had to be done.
After a couple of days of swearing and trying kinda hard, we found a solution, or something like that.
First, there was this thread in google groups that says you should alter the code to force it to use the version 3 of the api (instead of the default, which is the version 1). but that resulted in a
invalid request uri error, which we solved with this somewhat hacky hack which basically consists of changing the URIs of the docs to adhere to the standard in the new API version.
And voilà, like a hacked up frankenstein, we got pdf uploads working in the gdata python client. And a little grudge against google, because that bug has been there for like two and a half years! (so we suspect that it can't be that easy to solve, so expect a future post on how everything went to hell, I guess).
So that was it, a line to add the API version header and another to change the folder URI and life shone again.
UPDATE: here's a gist with the patch: https://gist.github.com/759173