rename Google API methods (e.g. delete) to createXXXRequest (e.g. createDeleteRequest)

[GoogleCodeExporter]

External references, such as a standards document, or specification?

https://google-api-client-libraries.appspot.com/documentation/calendar/v3/java/l
atest/com/google/api/services/calendar/Calendar.Calendars.html#delete(java.lang.
String)

Java environments (e.g. Java 6, Android 2.3, App Engine, or All)?

All

Please describe the feature requested.

For example (borrowed from CalendarSample.java):

    client.calendars().delete(calendar.getId()).execute();

Some users complain that it is unintuitive that you have to call execute().  
When you first try the library you intuitively guess that calling delete() 
should actually delete the Calendar.  We can hopefully make it more intuitive 
by renaming it createDeleteRequest, e.g.:

    client.calendars().createDeleteRequest(calendar.getId()).execute();

Original issue reported on code.google.com by yan...@google.com on 3 Jan 2013 at 7:14

[GoogleCodeExporter]

Actually newDeleteRequest() sounds better to me than createDeleteRequest().  
That said, at this point changing the name of the method is too large of a 
change for existing users, so I think we have to Won't Fix it for that reason.

Original comment by yan...@google.com on 9 Jan 2013 at 8:22

• Changed state: WontFix

[GoogleCodeExporter]

Original comment by yan...@google.com on 12 Jan 2013 at 4:23

• Removed labels: Milestone-Version1.14.0