Document and fix com.google.api.services.calendar.CalendarRequest.setFields(String)

Version of google-api-java-client: All versions that I've seen of the Calendar 
API.

I'm using google-api-services-calendar-v3-1.3.1-beta.jar.

Describe the problem.

There is no documentation for how to build a string that represents the fields 
you want to retrieve. I've searched the internet for days.

The current documentation is useless. You may find it here:
http://javadoc.google-api-java-client.googlecode.com/hg/apis/calendar/v3/com/goo
gle/api/services/calendar/CalendarRequest.html#setFields(java.lang.String)

How would you expect it to be fixed?
Google needs to provide a mapping from 
com.google.api.services.calendar.model.Event properties to the fields String. 
As well as for all the other retrievable objects that you can specify fields 
for.

In my experimentation, I've tried setting fields to "summary". You would think 
that would limit the content of returned events to just the summary. Actually, 
it prevents any events from being returned at all.

I'm flabbergasted at this omission. We all want to improve performance and 
Google recommends using setFields to do it. So let us know how.

Original issue reported on code.google.com by quantime...@cox.net on 9 May 2012 at 11:55

fer626 / google-api-java-client

Document and fix com.google.api.services.calendar.CalendarRequest.setFields(String) #485