vanderkerkoff wrote:

OK, first "Calendar ID." Calendar ID is the term that is used in the UI and in my opinion should be used exclusively in the calendar protocol documentation. To understand Calendar ID, explore some Calendar IDs through the UI. Open the UI. (You need several calendars already set up if you are going to see this, so if you need to, set up another and subscribe to a few random public feeds.) Then click on the little drop down to the left of your primary calendar's name, go to the calendar settings page, and scroll down to the area for calendar address. There you will see something like:

Calendar XML ICAL HTML (Calendar ID: username@domain) Address:

The calendar ID of this calendar is username@domain. Check several calendars, there is a pattern. For a user's primary calendar, the Calendar ID is the same as their e-mail address, so my primary calendar's Calendar ID is "myn...@gmail.com".

For a user's secondary calendars, the Calendar ID is a string that resembles an e-mail address. It is a 26 character string of a-z0-9, followed by an "@" followed by what appears to be a fully qualified domain name. For instance, the calendar IDs of some of my other calendars are: pjl4...@group.calendar.google.com 1dur...@group.calendar.google.com td3s...@group.calendar.google.com

Then there are the Calendar IDs for other calendars that I have subscribed to: some...@gmail.com a08i...@import.calendar.google.com

That first one, some...@gmail.com, is her primary calendar, so it has her e-mail address as the Calendar ID. The second is a public calendar for the weather in my area. (The calendars in the domain import.calendar.google.com appear to be automatically generated from other data sources and contain be named with 32 character strings.) There may be other similar forms of Calendar ID and in particular if you have Google Apps for your domain, these addresses probably look like your...@yourdomain.com, etc. I'd appreciate any confirmation of that fact, or any sightings of other forms of Calendar ID.

So with this clearer definition of Calendar ID (let's call it calendarID) in hand and head, if you go to this page of the Google Documentation, http://code.google.com/apis/calendar/developers_guide_protocol.html you can mentally substitute calendarID for every occurrence of userID. There are currently 9 occurrences of calendarID on that page and 5 of userID. All 14 refer to exactly the same thing, the calendarID.

Hope that helps,

Ray