vanderkerkoff wrote: > My attempt. > > In the Documentation they sometimes use the phrase "user id" when they > are describing how to access a users primary calendar. What they > actually are reffering to is the Calendar ID. > > This is not the case for secondary calendars, as in secondary > calendars the user id is the user id. > > See, that makes no sense, can you please try to clarify for me, and > for others it would seem. >
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: [EMAIL PROTECTED]) Address: The calendar ID of this calendar is [EMAIL PROTECTED] 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 "[EMAIL PROTECTED]". 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: [EMAIL PROTECTED] [EMAIL PROTECTED] [EMAIL PROTECTED] Then there are the Calendar IDs for other calendars that I have subscribed to: [EMAIL PROTECTED] [EMAIL PROTECTED] That first one, [EMAIL PROTECTED], 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 [EMAIL PROTECTED], 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 > Hi Ray > > There is a problem > that the phrase user id is used often in the documentation and > examples when what is actually meant is calendar id. The user id is > the calendar id of the user's primary calendar, but not for secondary > calendars. > > Can you do me a favour and write some lines here that adequately > descirbe what you mean by that sentence above with examples please > mate? > > It's as confusing as all hell in the documentation and really needs to > be addressed. > > Can you have a go here? > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Google Calendar Data API" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/google-calendar-help-dataapi?hl=en -~----------~----~----~----~------~----~------~--~---
