Thursday, June 4, 2009

Making a Google Calendar link

There is a handy form available under Google help to create a website button for a calendar event (http://www.google.com/googlecalendar/event_publisher_guide.html). It is pretty useful but I needed to decode the parameters in order to get some javascript to create a particular link on demand. Here's my notes about the parameters you can play with.

anchor address
  • http://www .google.com/calendar/event?
  • This is the base of the address before the parameters below.
action
  • action=TEMPLATE
  • A default required parameter.
src
  • Example: src=default%40gmail.com
  • Format: src=text
  • This is not covered by Google help but is an optional parameter in order to add an event to a shared calendar rather than a user's default.
text
  • Example: text=Garden%20Waste%20Collection
  • Format: text=text
  • This is a required parameter giving the event title.
dates
  • Example: dates=20090621T063000Z/20090621T080000Z (i.e. an event on 21 June 2009 from 7.30am to 9.0am British Summer Time (=GMT+1)).
  • Format: dates=YYYYMMDDToHHMMSSZ/YYYYMMDDToHHMMSSZ
  • This required parameter gives the start and end dates and times (in Greenwich Mean Time) for the event.
location
  • Example: location=Home
  • Format: location=text
  • The obvious location field.
trp
  • Example: trp=false
  • Format: trp=true/false
  • Show event as busy (true) or available (false)
sprop
  • Example: sprop=http%3A%2F%2Fwww.me.org
  • Example: sprop=name:Home%20Page
  • Format: sprop=website and/or sprop=name:website_name