Google Data API 使用体验 (1)-- Calendar篇

Google的API也出了有好久了..一直没用过..前段日子看到连GoogleCL这样的神器都出来了..想API应该已经比较完善了吧..就心痒痒一直想试试..咱有空也写个java版的GoogleCL出来..呵呵..一捱已经到了暑假..才研究了个calendar的简单使用..惭愧啊.

先上来记一笔..其实我个人一直很想先研究doc的..因为现有的客户端比较烂..想自己做个好用点的..但还是先搞了calendar..至于原因呢..在后面的几篇日志里应该会有个交代的..其实网上关于这些API研究的文已经很多了..写不写可能无所谓..但从我个人学习的经验总结下来..觉得弯路还是走的不少的..所以还是写一些心得出来比较好..(废话好多..)

以下为挑重点介绍下..原始的可以参看GoogleAPI..

例如:http://code.google.com/intl/zh-CN/apis/calendar/data/2.0/developers_guide_java.html

 

1.EventEntry元素

日历里的每个事件就是一个event..一般可以用一个EventEntry来表示..EventEntry主要有以下几个重要的属性:

1)PlainTextConstruct title

2)Person author

3)When time

4)Where location

5)PlainTextConstruct content

6)Recurrence recu

1)title顾名思义就是事件的名称或者说内容..可以是一个简单的String..

2)author是事件的作者..Person这个类中包含一个String的作者名字,还有Google帐号的username等信息..但实际上..我觉得可能是由于google服务本身的漏洞..这些信息都没有实际的作用..可以忽略不设也就是让他自动设置..

3)time也就是本次事件的起始时间.注意!:在一个Event里面只能有When或者Recurrence中的一个!如果是使用When..需要设置startTime和endTime这2个属性..他们都是DataTime类型的..也就是设置这个Event的起始和结束时间,并且这个Event显然是只执行一次的..如果你要添加的是一个周期性的Event..就不好用When了..需要使用Recurrence..这个后面再说..而这里的DataTime是需要这样形式的String来设置的:

例如:  2006-04-17T17:00:00-08:00

yyyy-MM-dd + "T" + hh:mm:ss + TimeZone

4)location即事件发生的地点..Where类也有rel/label/where三个String属性..同前所述..rel和label也不好用..可以不设..where就是你需要定义的地点..

5)content说明内容..即对本事件的补充信息..和title的使用方法相同.

6)recu...这是个好东西啊.花了我一个下午才大致研究出点眉目..说简单了..这就是用来设置事件的周期属性的..例如我每周一要上体育课..我只要生成一个上体育课的事件..然后设置Recurrence让他每周一都重复一次..还