Google's API documentation are generally abysmal. I have learnt not to spend too much time on the docs but rather look at the samples and source code. But there are times like when beta testing the APIs when there are no samples / source code and you mostly sitting ducks unless someone from google helps you out.