Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 308bcad0fce251c3f9e4ddc863f96238445edfe2 / . / docs / dyn / calendar.v3.events.html
blob: 5bb1a2d1e99bb1acc9021525445f9fa2e1288d8f [file] [log] [blame]
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
3<html><head><title>Python: class Resource</title>
4</head><body bgcolor="#f0f0f8">
5<p>
6<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
7<tr bgcolor="#ffc8d8">
8<td colspan=3 valign=bottom>&nbsp;<br>
9<font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
10
11<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
12<td colspan=2><tt>A&nbsp;class&nbsp;for&nbsp;interacting&nbsp;with&nbsp;a&nbsp;resource.<br>&nbsp;</tt></td></tr>
13<tr><td>&nbsp;</td>
14<td width="100%">Methods defined here:<br>
15<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>
16
17<dl><dt><a name="Resource-delete"><strong>delete</strong></a> = method(self, **kwargs)</dt><dd><tt>Deletes&nbsp;an&nbsp;event.<br>
18&nbsp;<br>
19Args:<br>
20&nbsp;&nbsp;eventId:&nbsp;string,&nbsp;Event&nbsp;identifier.&nbsp;(required)<br>
21&nbsp;&nbsp;sendNotifications:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;send&nbsp;notifications&nbsp;about&nbsp;the&nbsp;deletion&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
22&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)</tt></dd></dl>
23
24<dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Returns&nbsp;an&nbsp;event.<br>
25&nbsp;<br>
26Args:<br>
27&nbsp;&nbsp;eventId:&nbsp;string,&nbsp;Event&nbsp;identifier.&nbsp;(required)<br>
28&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
29&nbsp;&nbsp;timeZone:&nbsp;string,&nbsp;Time&nbsp;zone&nbsp;used&nbsp;in&nbsp;the&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
30&nbsp;&nbsp;maxAttendees:&nbsp;integer,&nbsp;The&nbsp;maximum&nbsp;number&nbsp;of&nbsp;attendees&nbsp;to&nbsp;include&nbsp;in&nbsp;the&nbsp;response.&nbsp;If&nbsp;there&nbsp;are&nbsp;more&nbsp;than&nbsp;the&nbsp;specified&nbsp;number&nbsp;of&nbsp;attendees,&nbsp;only&nbsp;the&nbsp;participant&nbsp;is&nbsp;returned.&nbsp;Optional.<br>
31&nbsp;<br>
32Returns:<br>
33&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
34&nbsp;<br>
35&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]36&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
37&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
38&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]39&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]40&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
41&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
42&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]43&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]44&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
45&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]46&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]47&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
48&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
49&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
50&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
51&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
52&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
53&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
54&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
55&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
56&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
57&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
58&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
59&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]60&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
61&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]62&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
63&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
64&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
65&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
66&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
67&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
68&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
69&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
70&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
71&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
72&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
73&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
74&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
75&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
76&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
77&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
78&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
79&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
80&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
81&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
82&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
83&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
84&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
85&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
86&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
87&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
88&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
89&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
90&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
91&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
92&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
93&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
94&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
95&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
96&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
97&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
98&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
99&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
100&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
101&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
102&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
103&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
104&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
105&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
106&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
107&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
108&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
109&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
110&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
111&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
112&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
113&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
114&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
115&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
116&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
117&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
118&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
119&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
120&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
121&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
122&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
123&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
124&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
125&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
126&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
127&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
128&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
129&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
130&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
131&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
132&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
133&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
134&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
135&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
136&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
137&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
138&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
139&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
140&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
141&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]142
143<dl><dt><a name="Resource-import_"><strong>import_</strong></a> = method(self, **kwargs)</dt><dd><tt>Imports&nbsp;an&nbsp;event.<br>
144&nbsp;<br>
145Args:<br>
146&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
147&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
148&nbsp;<br>
149{<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]150&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
151&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
152&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
153&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]154&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]155&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
156&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
157&nbsp;&nbsp;&nbsp;&nbsp;},<br>
158&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
159&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
160&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
161&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
162&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
163&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
164&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
165&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
166&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
167&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
168&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
169&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
170&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
171&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
172&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
173&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
174&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
175&nbsp;&nbsp;&nbsp;&nbsp;],<br>
176&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
177&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
178&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
179&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]180&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]181&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
182&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
183&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
184&nbsp;&nbsp;&nbsp;&nbsp;},<br>
185&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
186&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
187&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
188&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
189&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
190&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
191&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
192&nbsp;&nbsp;&nbsp;&nbsp;},<br>
193&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
194&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
195&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
196&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
197&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
198&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
199&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
200&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
201&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
202&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
203&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
204&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
205&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
206&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
207&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
208&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
209&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
210&nbsp;&nbsp;&nbsp;&nbsp;},<br>
211&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
212&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
213&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
214&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
215&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
216&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
217&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
218&nbsp;&nbsp;&nbsp;&nbsp;},<br>
219&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
220&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
221&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
222&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
223&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
224&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
225&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]226&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]227&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
228&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
229&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
230&nbsp;&nbsp;&nbsp;&nbsp;},<br>
231&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
232&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
233&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
234&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
235&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
236&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
237&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
238&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
239&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
240&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
241&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
242&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
243&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
244&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
245&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
246&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
247&nbsp;&nbsp;&nbsp;&nbsp;},<br>
248&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
249&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
250&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
251&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
252&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
253&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
254&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]255&nbsp;&nbsp;}<br>
256&nbsp;<br>
257&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
258&nbsp;<br>
259Returns:<br>
260&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
261&nbsp;<br>
262&nbsp;&nbsp;&nbsp;&nbsp;{<br>
263&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
264&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
265&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
266&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
267&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
268&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
269&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
270&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
271&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
272&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
273&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
274&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
275&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
276&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
277&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
278&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
279&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
280&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
281&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
282&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
283&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
284&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
285&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
286&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
287&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
288&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
289&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
290&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
291&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
292&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
293&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
294&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
295&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
296&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
297&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
298&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
299&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
300&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
301&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
302&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
303&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
304&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
305&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
306&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
307&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
308&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
309&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
310&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
311&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
312&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
313&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
314&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
315&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
316&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
317&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
318&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
319&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
320&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
321&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
322&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
323&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
324&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
325&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
326&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
327&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
328&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
329&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
330&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
331&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
332&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
333&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
334&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
335&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
336&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
337&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
338&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
339&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
340&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
341&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
342&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
343&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
344&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
345&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
346&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
347&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
348&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
349&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
350&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
351&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
352&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
353&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
354&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
355&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
356&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
357&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
358&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
359&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
360&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
361&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
362&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
363&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
364&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
365&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
366&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
367&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
368&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]369
370<dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Creates&nbsp;an&nbsp;event.<br>
371&nbsp;<br>
372Args:<br>
373&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
374&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
375&nbsp;<br>
376{<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]377&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
378&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
379&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
380&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]381&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]382&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
383&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
384&nbsp;&nbsp;&nbsp;&nbsp;},<br>
385&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
386&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
387&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
388&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
389&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
390&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
391&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
392&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
393&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
394&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
395&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
396&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
397&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
398&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
399&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
400&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
401&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
402&nbsp;&nbsp;&nbsp;&nbsp;],<br>
403&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
404&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
405&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
406&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]407&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]408&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
409&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
410&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
411&nbsp;&nbsp;&nbsp;&nbsp;},<br>
412&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
413&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
414&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
415&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
416&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
417&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
418&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
419&nbsp;&nbsp;&nbsp;&nbsp;},<br>
420&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
421&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
422&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
423&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
424&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
425&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
426&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
427&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
428&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
429&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
430&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
431&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
432&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
433&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
434&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
435&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
436&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
437&nbsp;&nbsp;&nbsp;&nbsp;},<br>
438&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
439&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
440&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
441&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
442&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
443&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
444&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
445&nbsp;&nbsp;&nbsp;&nbsp;},<br>
446&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
447&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
448&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
449&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
450&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
451&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
452&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]453&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]454&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
455&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
456&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
457&nbsp;&nbsp;&nbsp;&nbsp;},<br>
458&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
459&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
460&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
461&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
462&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
463&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
464&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
465&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
466&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
467&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
468&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
469&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
470&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
471&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
472&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
473&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
474&nbsp;&nbsp;&nbsp;&nbsp;},<br>
475&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
476&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
477&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
478&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
479&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
481&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]482&nbsp;&nbsp;}<br>
483&nbsp;<br>
484&nbsp;&nbsp;sendNotifications:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;send&nbsp;notifications&nbsp;about&nbsp;the&nbsp;creation&nbsp;of&nbsp;the&nbsp;new&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
485&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
486&nbsp;<br>
487Returns:<br>
488&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
489&nbsp;<br>
490&nbsp;&nbsp;&nbsp;&nbsp;{<br>
491&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
492&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
493&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
494&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
495&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
496&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
497&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
498&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
499&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
500&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
501&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
502&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
503&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
504&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
505&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
506&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
507&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
508&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
509&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
510&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
511&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
512&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
513&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
514&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
515&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
516&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
517&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
518&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
519&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
520&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
521&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
522&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
523&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
524&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
525&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
526&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
527&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
528&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
529&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
530&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
531&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
532&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
533&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
534&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
535&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
536&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
537&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
538&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
539&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
540&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
541&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
542&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
543&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
544&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
545&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
546&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
547&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
548&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
549&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
550&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
551&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
552&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
553&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
554&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
555&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
556&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
557&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
558&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
559&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
560&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
561&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
562&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
563&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
564&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
565&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
566&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
567&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
568&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
569&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
570&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
571&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
572&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
573&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
574&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
575&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
576&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
577&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
578&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
579&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
580&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
581&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
582&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
583&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
584&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
585&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
586&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
587&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
588&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
589&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
590&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
591&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
592&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
593&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
594&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
595&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
596&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]597
598<dl><dt><a name="Resource-instances"><strong>instances</strong></a> = method(self, **kwargs)</dt><dd><tt>Returns&nbsp;instances&nbsp;of&nbsp;the&nbsp;specified&nbsp;recurring&nbsp;event.<br>
599&nbsp;<br>
600Args:<br>
601&nbsp;&nbsp;eventId:&nbsp;string,&nbsp;Recurring&nbsp;event&nbsp;identifier.&nbsp;(required)<br>
602&nbsp;&nbsp;pageToken:&nbsp;string,&nbsp;Token&nbsp;specifying&nbsp;which&nbsp;result&nbsp;page&nbsp;to&nbsp;return.&nbsp;Optional.<br>
603&nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;events&nbsp;returned&nbsp;on&nbsp;one&nbsp;result&nbsp;page.&nbsp;Optional.<br>
604&nbsp;&nbsp;showDeleted:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;include&nbsp;deleted&nbsp;events&nbsp;(with&nbsp;'eventStatus'&nbsp;equals&nbsp;'cancelled')&nbsp;in&nbsp;the&nbsp;result.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
605&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
606&nbsp;&nbsp;timeZone:&nbsp;string,&nbsp;Time&nbsp;zone&nbsp;used&nbsp;in&nbsp;the&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
607&nbsp;&nbsp;originalStart:&nbsp;string,&nbsp;The&nbsp;original&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;instance&nbsp;in&nbsp;the&nbsp;result.&nbsp;Optional.<br>
608&nbsp;&nbsp;maxAttendees:&nbsp;integer,&nbsp;The&nbsp;maximum&nbsp;number&nbsp;of&nbsp;attendees&nbsp;to&nbsp;include&nbsp;in&nbsp;the&nbsp;response.&nbsp;If&nbsp;there&nbsp;are&nbsp;more&nbsp;than&nbsp;the&nbsp;specified&nbsp;number&nbsp;of&nbsp;attendees,&nbsp;only&nbsp;the&nbsp;participant&nbsp;is&nbsp;returned.&nbsp;Optional.<br>
609&nbsp;<br>
610Returns:<br>
611&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
612&nbsp;<br>
613&nbsp;&nbsp;&nbsp;&nbsp;{<br>
614&nbsp;&nbsp;&nbsp;&nbsp;"nextPageToken":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Token&nbsp;used&nbsp;to&nbsp;access&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;this&nbsp;result.&nbsp;Omitted&nbsp;if&nbsp;no&nbsp;further&nbsp;results&nbsp;are&nbsp;available.<br>
615&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#events",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;collection&nbsp;("calendar#events").<br>
616&nbsp;&nbsp;&nbsp;&nbsp;"defaultReminders":&nbsp;[&nbsp;#&nbsp;The&nbsp;default&nbsp;reminders&nbsp;on&nbsp;the&nbsp;calendar&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.&nbsp;These&nbsp;reminders&nbsp;apply&nbsp;to&nbsp;all&nbsp;events&nbsp;on&nbsp;this&nbsp;calendar&nbsp;that&nbsp;do&nbsp;not&nbsp;explicitly&nbsp;override&nbsp;them&nbsp;(i.e.&nbsp;do&nbsp;not&nbsp;have&nbsp;'reminders.useDefault'&nbsp;set&nbsp;to&nbsp;'true').<br>
617&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
618&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
619&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
620&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
621&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
622&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
623&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
624&nbsp;&nbsp;&nbsp;&nbsp;],<br>
625&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;Read-only.<br>
626&nbsp;&nbsp;&nbsp;&nbsp;"items":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.<br>
627&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]628&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
629&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
630&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]631&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]632&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
633&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
634&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]635&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]636&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
637&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]638&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]639&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
640&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
641&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
642&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
643&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
644&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
645&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
646&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
647&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
648&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
649&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
650&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
651&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]652&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
653&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]654&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
655&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
656&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
657&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
658&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
659&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
660&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
661&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
662&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
663&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
664&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
665&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
666&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
667&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
668&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
669&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
670&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
671&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
672&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
673&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
674&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
675&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
676&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
677&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
678&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
679&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
680&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
681&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
682&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
683&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
684&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
685&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
686&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
687&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
688&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
689&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
690&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
691&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
692&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
693&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
694&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
695&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
696&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
697&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
698&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
699&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
700&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
701&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
702&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
703&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
704&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
705&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
706&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
707&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
708&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
709&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
710&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
711&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
712&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
713&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
714&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
715&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
716&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
717&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
718&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
719&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
720&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
721&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
722&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
723&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
724&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
725&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
726&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
727&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
728&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
729&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
730&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
731&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
732&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]733&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]734&nbsp;&nbsp;&nbsp;&nbsp;],<br>
735&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;calendar&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
736&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;Read-only.<br>
737&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;collection.<br>
738&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;Read-only.<br>
739&nbsp;&nbsp;&nbsp;&nbsp;"accessRole":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;user's&nbsp;access&nbsp;role&nbsp;for&nbsp;this&nbsp;calendar.&nbsp;Read-only.&nbsp;Possible&nbsp;values&nbsp;are:<br>
740&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"none"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;no&nbsp;access.<br>
741&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"freeBusyReader"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;read&nbsp;access&nbsp;to&nbsp;free/busy&nbsp;information.<br>
742&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"reader"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;read&nbsp;access&nbsp;to&nbsp;the&nbsp;calendar.&nbsp;Private&nbsp;events&nbsp;will&nbsp;appear&nbsp;to&nbsp;users&nbsp;with&nbsp;reader&nbsp;access,&nbsp;but&nbsp;event&nbsp;details&nbsp;will&nbsp;be&nbsp;hidden.<br>
743&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"writer"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;read&nbsp;and&nbsp;write&nbsp;access&nbsp;to&nbsp;the&nbsp;calendar.&nbsp;Private&nbsp;events&nbsp;will&nbsp;appear&nbsp;to&nbsp;users&nbsp;with&nbsp;writer&nbsp;access,&nbsp;and&nbsp;event&nbsp;details&nbsp;will&nbsp;be&nbsp;visible.<br>
744&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"owner"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;ownership&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;role&nbsp;has&nbsp;all&nbsp;of&nbsp;the&nbsp;permissions&nbsp;of&nbsp;the&nbsp;writer&nbsp;role&nbsp;with&nbsp;the&nbsp;additional&nbsp;ability&nbsp;to&nbsp;see&nbsp;and&nbsp;manipulate&nbsp;ACLs.<br>
745&nbsp;&nbsp;}</tt></dd></dl>
746
747<dl><dt><a name="Resource-instances_next"><strong>instances_next</strong></a> = methodNext(self, previous_request, previous_response)</dt><dd><tt>Retrieves&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;results.<br>
748&nbsp;<br>
749Args:<br>
750&nbsp;&nbsp;previous_request:&nbsp;The&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
751&nbsp;&nbsp;previous_response:&nbsp;The&nbsp;response&nbsp;from&nbsp;the&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
752&nbsp;<br>
753Returns:<br>
754&nbsp;&nbsp;A&nbsp;request&nbsp;object&nbsp;that&nbsp;you&nbsp;can&nbsp;call&nbsp;'execute()'&nbsp;on&nbsp;to&nbsp;request&nbsp;the&nbsp;next<br>
755&nbsp;&nbsp;page.&nbsp;Returns&nbsp;None&nbsp;if&nbsp;there&nbsp;are&nbsp;no&nbsp;more&nbsp;items&nbsp;in&nbsp;the&nbsp;collection.</tt></dd></dl>
756
757<dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Returns&nbsp;events&nbsp;on&nbsp;the&nbsp;specified&nbsp;calendar.<br>
758&nbsp;<br>
759Args:<br>
760&nbsp;&nbsp;orderBy:&nbsp;string,&nbsp;The&nbsp;order&nbsp;of&nbsp;the&nbsp;events&nbsp;returned&nbsp;in&nbsp;the&nbsp;result.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;an&nbsp;unspecified,&nbsp;stable&nbsp;order.<br>
761&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
762&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;startTime&nbsp;-&nbsp;Order&nbsp;by&nbsp;the&nbsp;start&nbsp;date/time&nbsp;(ascending).&nbsp;This&nbsp;is&nbsp;only&nbsp;available&nbsp;when&nbsp;querying&nbsp;single&nbsp;events&nbsp;(i.e.&nbsp;the&nbsp;parameter&nbsp;"singleEvents"&nbsp;is&nbsp;True)<br>
763&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;updated&nbsp;-&nbsp;Order&nbsp;by&nbsp;last&nbsp;modification&nbsp;time&nbsp;(ascending).<br>
764&nbsp;&nbsp;showHiddenInvitations:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;include&nbsp;hidden&nbsp;invitations&nbsp;in&nbsp;the&nbsp;result.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
765&nbsp;&nbsp;iCalUID:&nbsp;string,&nbsp;Specifies&nbsp;iCalendar&nbsp;UID&nbsp;(iCalUID)&nbsp;of&nbsp;events&nbsp;to&nbsp;be&nbsp;included&nbsp;in&nbsp;the&nbsp;response.&nbsp;Optional.<br>
766&nbsp;&nbsp;updatedMin:&nbsp;string,&nbsp;Lower&nbsp;bound&nbsp;for&nbsp;an&nbsp;event's&nbsp;last&nbsp;modification&nbsp;time&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp)&nbsp;to&nbsp;filter&nbsp;by.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;not&nbsp;to&nbsp;filter&nbsp;by&nbsp;last&nbsp;modification&nbsp;time.<br>
767&nbsp;&nbsp;singleEvents:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;expand&nbsp;recurring&nbsp;events&nbsp;into&nbsp;instances&nbsp;and&nbsp;only&nbsp;return&nbsp;single&nbsp;one-off&nbsp;events&nbsp;and&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events,&nbsp;but&nbsp;not&nbsp;the&nbsp;underlying&nbsp;recurring&nbsp;events&nbsp;themselves.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
768&nbsp;&nbsp;timeMax:&nbsp;string,&nbsp;Upper&nbsp;bound&nbsp;(exclusive)&nbsp;for&nbsp;an&nbsp;event's&nbsp;start&nbsp;time&nbsp;to&nbsp;filter&nbsp;by.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;not&nbsp;to&nbsp;filter&nbsp;by&nbsp;start&nbsp;time.<br>
769&nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;events&nbsp;returned&nbsp;on&nbsp;one&nbsp;result&nbsp;page.&nbsp;Optional.<br>
770&nbsp;&nbsp;q:&nbsp;string,&nbsp;Free&nbsp;text&nbsp;search&nbsp;terms&nbsp;to&nbsp;find&nbsp;events&nbsp;that&nbsp;match&nbsp;these&nbsp;terms&nbsp;in&nbsp;any&nbsp;field,&nbsp;except&nbsp;for&nbsp;extended&nbsp;properties.&nbsp;Optional.<br>
771&nbsp;&nbsp;showDeleted:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;include&nbsp;deleted&nbsp;events&nbsp;(with&nbsp;'eventStatus'&nbsp;equals&nbsp;'cancelled')&nbsp;in&nbsp;the&nbsp;result.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
772&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
773&nbsp;&nbsp;timeMin:&nbsp;string,&nbsp;Lower&nbsp;bound&nbsp;(inclusive)&nbsp;for&nbsp;an&nbsp;event's&nbsp;end&nbsp;time&nbsp;to&nbsp;filter&nbsp;by.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;not&nbsp;to&nbsp;filter&nbsp;by&nbsp;end&nbsp;time.<br>
774&nbsp;&nbsp;pageToken:&nbsp;string,&nbsp;Token&nbsp;specifying&nbsp;which&nbsp;result&nbsp;page&nbsp;to&nbsp;return.&nbsp;Optional.<br>
775&nbsp;&nbsp;timeZone:&nbsp;string,&nbsp;Time&nbsp;zone&nbsp;used&nbsp;in&nbsp;the&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
776&nbsp;&nbsp;maxAttendees:&nbsp;integer,&nbsp;The&nbsp;maximum&nbsp;number&nbsp;of&nbsp;attendees&nbsp;to&nbsp;include&nbsp;in&nbsp;the&nbsp;response.&nbsp;If&nbsp;there&nbsp;are&nbsp;more&nbsp;than&nbsp;the&nbsp;specified&nbsp;number&nbsp;of&nbsp;attendees,&nbsp;only&nbsp;the&nbsp;participant&nbsp;is&nbsp;returned.&nbsp;Optional.<br>
777&nbsp;<br>
778Returns:<br>
779&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
780&nbsp;<br>
781&nbsp;&nbsp;&nbsp;&nbsp;{<br>
782&nbsp;&nbsp;&nbsp;&nbsp;"nextPageToken":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Token&nbsp;used&nbsp;to&nbsp;access&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;this&nbsp;result.&nbsp;Omitted&nbsp;if&nbsp;no&nbsp;further&nbsp;results&nbsp;are&nbsp;available.<br>
783&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#events",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;collection&nbsp;("calendar#events").<br>
784&nbsp;&nbsp;&nbsp;&nbsp;"defaultReminders":&nbsp;[&nbsp;#&nbsp;The&nbsp;default&nbsp;reminders&nbsp;on&nbsp;the&nbsp;calendar&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.&nbsp;These&nbsp;reminders&nbsp;apply&nbsp;to&nbsp;all&nbsp;events&nbsp;on&nbsp;this&nbsp;calendar&nbsp;that&nbsp;do&nbsp;not&nbsp;explicitly&nbsp;override&nbsp;them&nbsp;(i.e.&nbsp;do&nbsp;not&nbsp;have&nbsp;'reminders.useDefault'&nbsp;set&nbsp;to&nbsp;'true').<br>
785&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
786&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
787&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
788&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
789&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
790&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
791&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
792&nbsp;&nbsp;&nbsp;&nbsp;],<br>
793&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;Read-only.<br>
794&nbsp;&nbsp;&nbsp;&nbsp;"items":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.<br>
795&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]796&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
797&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
798&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]799&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]800&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
801&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
802&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]803&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]804&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
805&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]806&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]807&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
808&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
809&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
810&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
811&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
812&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
813&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
814&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
815&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
816&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
817&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
818&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
819&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]820&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
821&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]822&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
823&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
824&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
825&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
826&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
827&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
828&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
829&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
830&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
831&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
832&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
833&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
834&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
835&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
836&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
837&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
838&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
839&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
840&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
841&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
842&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
843&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
844&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
845&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
846&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
847&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
848&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
849&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
850&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
851&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
852&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
853&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
854&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
855&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
856&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
857&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
858&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
859&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
860&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
861&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
862&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
863&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
864&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
865&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
866&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
867&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
868&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
869&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
870&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
871&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
872&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
873&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
874&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
875&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
876&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
877&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
878&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
879&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
880&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
881&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
882&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
883&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
884&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
885&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
886&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
887&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
888&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
889&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
890&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
891&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
892&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
893&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
894&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
895&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
896&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
897&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
898&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
899&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
900&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]901&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]902&nbsp;&nbsp;&nbsp;&nbsp;],<br>
903&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;calendar&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
904&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;Read-only.<br>
905&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;collection.<br>
906&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;Read-only.<br>
907&nbsp;&nbsp;&nbsp;&nbsp;"accessRole":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;user's&nbsp;access&nbsp;role&nbsp;for&nbsp;this&nbsp;calendar.&nbsp;Read-only.&nbsp;Possible&nbsp;values&nbsp;are:<br>
908&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"none"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;no&nbsp;access.<br>
909&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"freeBusyReader"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;read&nbsp;access&nbsp;to&nbsp;free/busy&nbsp;information.<br>
910&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"reader"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;read&nbsp;access&nbsp;to&nbsp;the&nbsp;calendar.&nbsp;Private&nbsp;events&nbsp;will&nbsp;appear&nbsp;to&nbsp;users&nbsp;with&nbsp;reader&nbsp;access,&nbsp;but&nbsp;event&nbsp;details&nbsp;will&nbsp;be&nbsp;hidden.<br>
911&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"writer"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;read&nbsp;and&nbsp;write&nbsp;access&nbsp;to&nbsp;the&nbsp;calendar.&nbsp;Private&nbsp;events&nbsp;will&nbsp;appear&nbsp;to&nbsp;users&nbsp;with&nbsp;writer&nbsp;access,&nbsp;and&nbsp;event&nbsp;details&nbsp;will&nbsp;be&nbsp;visible.<br>
912&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"owner"&nbsp;-&nbsp;The&nbsp;user&nbsp;has&nbsp;ownership&nbsp;of&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;role&nbsp;has&nbsp;all&nbsp;of&nbsp;the&nbsp;permissions&nbsp;of&nbsp;the&nbsp;writer&nbsp;role&nbsp;with&nbsp;the&nbsp;additional&nbsp;ability&nbsp;to&nbsp;see&nbsp;and&nbsp;manipulate&nbsp;ACLs.<br>
913&nbsp;&nbsp;}</tt></dd></dl>
914
915<dl><dt><a name="Resource-list_next"><strong>list_next</strong></a> = methodNext(self, previous_request, previous_response)</dt><dd><tt>Retrieves&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;results.<br>
916&nbsp;<br>
917Args:<br>
918&nbsp;&nbsp;previous_request:&nbsp;The&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
919&nbsp;&nbsp;previous_response:&nbsp;The&nbsp;response&nbsp;from&nbsp;the&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
920&nbsp;<br>
921Returns:<br>
922&nbsp;&nbsp;A&nbsp;request&nbsp;object&nbsp;that&nbsp;you&nbsp;can&nbsp;call&nbsp;'execute()'&nbsp;on&nbsp;to&nbsp;request&nbsp;the&nbsp;next<br>
923&nbsp;&nbsp;page.&nbsp;Returns&nbsp;None&nbsp;if&nbsp;there&nbsp;are&nbsp;no&nbsp;more&nbsp;items&nbsp;in&nbsp;the&nbsp;collection.</tt></dd></dl>
924
925<dl><dt><a name="Resource-move"><strong>move</strong></a> = method(self, **kwargs)</dt><dd><tt>Moves&nbsp;an&nbsp;event&nbsp;to&nbsp;another&nbsp;calendar,&nbsp;i.e.&nbsp;changes&nbsp;an&nbsp;event's&nbsp;organizer.<br>
926&nbsp;<br>
927Args:<br>
928&nbsp;&nbsp;eventId:&nbsp;string,&nbsp;Event&nbsp;identifier.&nbsp;(required)<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]929&nbsp;&nbsp;sendNotifications:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;send&nbsp;notifications&nbsp;about&nbsp;the&nbsp;change&nbsp;of&nbsp;the&nbsp;event's&nbsp;organizer.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
930&nbsp;&nbsp;destination:&nbsp;string,&nbsp;Calendar&nbsp;identifier&nbsp;of&nbsp;the&nbsp;target&nbsp;calendar&nbsp;where&nbsp;the&nbsp;event&nbsp;is&nbsp;to&nbsp;be&nbsp;moved&nbsp;to.&nbsp;(required)<br>
931&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier&nbsp;of&nbsp;the&nbsp;source&nbsp;calendar&nbsp;where&nbsp;the&nbsp;event&nbsp;currently&nbsp;is&nbsp;on.&nbsp;(required)<br>
932&nbsp;<br>
933Returns:<br>
934&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
935&nbsp;<br>
936&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]937&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
938&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
939&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]940&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]941&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
942&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
943&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]944&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]945&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
946&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]947&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]948&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
949&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
950&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
951&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
952&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
953&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
954&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
955&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
956&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
957&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
958&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
959&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
960&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]961&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
962&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]963&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
964&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
965&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
966&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
967&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
968&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
969&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
970&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
971&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
972&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
973&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
974&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
975&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
976&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
977&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
978&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
979&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
980&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
981&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
982&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
983&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
984&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
985&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
986&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
987&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
988&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
989&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
990&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
991&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
992&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
993&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
994&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
995&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
996&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
997&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
998&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
999&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
1000&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
1001&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
1002&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1003&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
1004&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1005&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1006&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
1007&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1008&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1009&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
1010&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
1011&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
1012&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1013&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
1014&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1015&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1016&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1017&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1018&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1019&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
1020&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1021&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
1022&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1023&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
1024&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
1025&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1026&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
1027&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1028&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
1029&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
1030&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
1031&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1032&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1033&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
1034&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1035&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1036&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
1037&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1038&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1039&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1040&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
1041&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
1042&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1043
1044<dl><dt><a name="Resource-patch"><strong>patch</strong></a> = method(self, **kwargs)</dt><dd><tt>Updates&nbsp;an&nbsp;event.&nbsp;This&nbsp;method&nbsp;supports&nbsp;patch&nbsp;semantics.<br>
1045&nbsp;<br>
1046Args:<br>
1047&nbsp;&nbsp;eventId:&nbsp;string,&nbsp;Event&nbsp;identifier.&nbsp;(required)<br>
1048&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
1049&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
1050&nbsp;<br>
1051{<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1052&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
1053&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
1054&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1055&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]1056&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1057&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
1058&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1059&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1060&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
1061&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
1062&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1063&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
1064&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
1065&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1066&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1067&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
1068&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
1069&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1070&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1071&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
1072&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1073&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1074&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1075&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
1076&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1077&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1078&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
1079&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
1080&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
1081&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]1082&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1083&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1084&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1085&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1086&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1087&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
1088&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
1089&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
1090&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
1091&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1092&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1093&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1094&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1095&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1096&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
1097&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
1098&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
1099&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1100&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
1101&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
1102&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1103&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
1104&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1105&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1106&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
1107&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
1108&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1109&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
1110&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
1111&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
1112&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1113&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
1114&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
1115&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
1116&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
1117&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1118&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
1119&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1120&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1121&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
1122&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1123&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1124&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
1125&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
1126&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
1127&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]1128&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1129&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1130&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1131&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1132&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1133&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1134&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
1135&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1136&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
1137&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1138&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
1139&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
1140&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1141&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
1142&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1143&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
1144&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
1145&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
1146&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1147&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1148&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
1149&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1150&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1151&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
1152&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1153&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1154&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1155&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
1156&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1157&nbsp;&nbsp;}<br>
1158&nbsp;<br>
1159&nbsp;&nbsp;sendNotifications:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;send&nbsp;notifications&nbsp;about&nbsp;the&nbsp;event&nbsp;update&nbsp;(e.g.&nbsp;attendee's&nbsp;responses,&nbsp;title&nbsp;changes,&nbsp;etc.).&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1160&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
1161&nbsp;<br>
1162Returns:<br>
1163&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
1164&nbsp;<br>
1165&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1166&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
1167&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
1168&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1169&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1170&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
1171&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
1172&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1173&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1174&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
1175&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
1176&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1177&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
1178&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
1179&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1180&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1181&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
1182&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
1183&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1184&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1185&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
1186&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1187&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1188&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1189&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
1190&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1191&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1192&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
1193&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
1194&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
1195&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1196&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
1197&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1198&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1199&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1200&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1201&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
1202&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
1203&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
1204&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
1205&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1206&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1207&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1208&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1209&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1210&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
1211&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
1212&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
1213&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1214&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
1215&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
1216&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1217&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
1218&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1219&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1220&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
1221&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
1222&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1223&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
1224&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
1225&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
1226&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1227&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
1228&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
1229&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
1230&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
1231&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1232&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
1233&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1234&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1235&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
1236&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1237&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1238&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
1239&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
1240&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
1241&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1242&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
1243&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1244&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1245&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1246&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1247&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1248&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
1249&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1250&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
1251&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1252&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
1253&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
1254&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1255&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
1256&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1257&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
1258&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
1259&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
1260&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1261&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1262&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
1263&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1264&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1265&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
1266&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1267&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1268&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1269&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
1270&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
1271&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1272
1273<dl><dt><a name="Resource-quickAdd"><strong>quickAdd</strong></a> = method(self, **kwargs)</dt><dd><tt>Creates&nbsp;an&nbsp;event&nbsp;based&nbsp;on&nbsp;a&nbsp;simple&nbsp;text&nbsp;string.<br>
1274&nbsp;<br>
1275Args:<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1276&nbsp;&nbsp;sendNotifications:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;send&nbsp;notifications&nbsp;about&nbsp;the&nbsp;creation&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1277&nbsp;&nbsp;text:&nbsp;string,&nbsp;The&nbsp;text&nbsp;describing&nbsp;the&nbsp;event&nbsp;to&nbsp;be&nbsp;created.&nbsp;(required)<br>
1278&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
1279&nbsp;<br>
1280Returns:<br>
1281&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
1282&nbsp;<br>
1283&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1284&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
1285&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
1286&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1287&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1288&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
1289&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
1290&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1291&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1292&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
1293&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1294&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1295&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
1296&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
1297&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1298&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1299&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
1300&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
1301&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1302&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1303&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
1304&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1305&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1306&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1307&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1308&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1309&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1310&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
1311&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
1312&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1313&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1314&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
1315&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1316&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1317&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1318&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1319&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
1320&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
1321&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
1322&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
1323&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1324&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1325&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1326&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1327&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1328&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
1329&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
1330&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
1331&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1332&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
1333&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
1334&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1335&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
1336&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1337&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1338&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
1339&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
1340&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1341&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
1342&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
1343&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
1344&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1345&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
1346&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
1347&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
1348&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
1349&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1350&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
1351&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1352&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1353&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
1354&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1355&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1356&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
1357&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
1358&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
1359&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1360&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
1361&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1362&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1363&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1364&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1365&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1366&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
1367&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1368&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
1369&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1370&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
1371&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
1372&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1373&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
1374&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1375&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
1376&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
1377&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
1378&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1379&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1380&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
1381&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1382&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1383&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
1384&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1385&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1386&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1387&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
1388&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
1389&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1390
1391<dl><dt><a name="Resource-update"><strong>update</strong></a> = method(self, **kwargs)</dt><dd><tt>Updates&nbsp;an&nbsp;event.<br>
1392&nbsp;<br>
1393Args:<br>
1394&nbsp;&nbsp;eventId:&nbsp;string,&nbsp;Event&nbsp;identifier.&nbsp;(required)<br>
1395&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
1396&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
1397&nbsp;<br>
1398{<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1399&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
1400&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
1401&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1402&nbsp;&nbsp;&nbsp;&nbsp;},<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]1403&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1404&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
1405&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1406&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1407&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
1408&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
1409&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1410&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
1411&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
1412&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1413&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1414&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
1415&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
1416&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1417&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1418&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
1419&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1420&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1421&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1422&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
1423&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1424&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1425&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
1426&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
1427&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
1428&nbsp;&nbsp;&nbsp;&nbsp;],<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]1429&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1430&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1431&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1432&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1433&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1434&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
1435&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
1436&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
1437&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
1438&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1439&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1440&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1441&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1442&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1443&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
1444&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
1445&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
1446&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1447&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
1448&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
1449&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1450&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
1451&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1452&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1453&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
1454&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
1455&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1456&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
1457&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
1458&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
1459&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1460&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
1461&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
1462&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
1463&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
1464&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1465&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
1466&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1467&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1468&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
1469&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1470&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1471&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
1472&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
1473&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
1474&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -0500[diff] [blame]1475&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1476&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1477&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1478&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1479&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1480&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1481&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
1482&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1483&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
1484&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1485&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
1486&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
1487&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1488&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
1489&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1490&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
1491&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
1492&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
1493&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1494&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1495&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
1496&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1497&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1498&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
1499&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1500&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1501&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1502&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
1503&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
Joe Gregorio6121dd92012-04-13 07:50:04 -0400[diff] [blame]1504&nbsp;&nbsp;}<br>
1505&nbsp;<br>
1506&nbsp;&nbsp;sendNotifications:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;send&nbsp;notifications&nbsp;about&nbsp;the&nbsp;event&nbsp;update&nbsp;(e.g.&nbsp;attendee's&nbsp;responses,&nbsp;title&nbsp;changes,&nbsp;etc.).&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1507&nbsp;&nbsp;calendarId:&nbsp;string,&nbsp;Calendar&nbsp;identifier.&nbsp;(required)<br>
1508&nbsp;<br>
1509Returns:<br>
1510&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
1511&nbsp;<br>
1512&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1513&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creator":&nbsp;{&nbsp;#&nbsp;The&nbsp;creator&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.<br>
1514&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;name,&nbsp;if&nbsp;available.<br>
1515&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;creator's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1516&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1517&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;{&nbsp;#&nbsp;The&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;If&nbsp;the&nbsp;organizer&nbsp;is&nbsp;also&nbsp;an&nbsp;attendee,&nbsp;this&nbsp;is&nbsp;indicated&nbsp;with&nbsp;a&nbsp;separate&nbsp;entry&nbsp;in&nbsp;'attendees'&nbsp;with&nbsp;the&nbsp;'organizer'&nbsp;field&nbsp;set&nbsp;to&nbsp;True.&nbsp;To&nbsp;change&nbsp;the&nbsp;organizer,&nbsp;use&nbsp;the&nbsp;"move"&nbsp;operation.&nbsp;Read-only,&nbsp;except&nbsp;when&nbsp;importing&nbsp;an&nbsp;event.<br>
1518&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;name,&nbsp;if&nbsp;available.<br>
1519&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;organizer's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.<br>
1520&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1521&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;of&nbsp;the&nbsp;event.<br>
1522&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendees":&nbsp;[&nbsp;#&nbsp;The&nbsp;attendees&nbsp;of&nbsp;the&nbsp;event.<br>
1523&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1524&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"comment":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;comment.&nbsp;Optional.<br>
1525&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;name,&nbsp;if&nbsp;available.&nbsp;Optional.<br>
1526&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"self":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;entry&nbsp;represents&nbsp;the&nbsp;calendar&nbsp;on&nbsp;which&nbsp;this&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;appears.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1527&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"responseStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;response&nbsp;status.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1528&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"needsAction"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;not&nbsp;responded&nbsp;to&nbsp;the&nbsp;invitation.<br>
1529&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"declined"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;declined&nbsp;the&nbsp;invitation.<br>
1530&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;tentatively&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1531&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"accepted"&nbsp;-&nbsp;The&nbsp;attendee&nbsp;has&nbsp;accepted&nbsp;the&nbsp;invitation.<br>
1532&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalGuests":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;additional&nbsp;guests.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;0.<br>
1533&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;a&nbsp;resource.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1534&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"organizer":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;attendee&nbsp;is&nbsp;the&nbsp;organizer&nbsp;of&nbsp;the&nbsp;event.&nbsp;Read-only.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1535&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"optional":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;an&nbsp;optional&nbsp;attendee.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1536&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"email":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;attendee's&nbsp;email&nbsp;address,&nbsp;if&nbsp;available.&nbsp;This&nbsp;field&nbsp;must&nbsp;be&nbsp;present&nbsp;when&nbsp;adding&nbsp;an&nbsp;attendee.<br>
1537&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1538&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1539&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"htmlLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;absolute&nbsp;link&nbsp;to&nbsp;this&nbsp;event&nbsp;in&nbsp;the&nbsp;Google&nbsp;Calendar&nbsp;Web&nbsp;UI.&nbsp;Read-only.<br>
1540&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurrence":&nbsp;[&nbsp;#&nbsp;List&nbsp;of&nbsp;RRULE,&nbsp;EXRULE,&nbsp;RDATE&nbsp;and&nbsp;EXDATE&nbsp;lines&nbsp;for&nbsp;a&nbsp;recurring&nbsp;event.&nbsp;This&nbsp;field&nbsp;is&nbsp;omitted&nbsp;for&nbsp;single&nbsp;events&nbsp;or&nbsp;instances&nbsp;of&nbsp;recurring&nbsp;events.<br>
1541&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
1542&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1543&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"start":&nbsp;{&nbsp;#&nbsp;The&nbsp;(inclusive)&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;start&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
1544&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1545&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1546&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1547&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1548&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;resource.<br>
1549&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"location":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Geographic&nbsp;location&nbsp;of&nbsp;the&nbsp;event&nbsp;as&nbsp;free-form&nbsp;text.&nbsp;Optional.<br>
1550&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"recurringEventId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;event&nbsp;ID&nbsp;of&nbsp;the&nbsp;recurring&nbsp;event&nbsp;itself.&nbsp;Immutable.<br>
1551&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"originalStartTime":&nbsp;{&nbsp;#&nbsp;For&nbsp;an&nbsp;instance&nbsp;of&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;time&nbsp;at&nbsp;which&nbsp;this&nbsp;event&nbsp;would&nbsp;start&nbsp;according&nbsp;to&nbsp;the&nbsp;recurrence&nbsp;data&nbsp;in&nbsp;the&nbsp;recurring&nbsp;event&nbsp;identified&nbsp;by&nbsp;recurringEventId.&nbsp;Immutable.<br>
1552&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1553&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1554&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1555&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1556&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Status&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1557&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confirmed"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;confirmed.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;status.<br>
1558&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"tentative"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;tentatively&nbsp;confirmed.<br>
1559&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"cancelled"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;cancelled.<br>
1560&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;modification&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1561&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gadget":&nbsp;{&nbsp;#&nbsp;A&nbsp;gadget&nbsp;that&nbsp;extends&nbsp;this&nbsp;event.<br>
1562&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"preferences":&nbsp;{&nbsp;#&nbsp;Preferences.<br>
1563&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1564&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;title.<br>
1565&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;height&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1566&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;42,&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;width&nbsp;in&nbsp;pixels.&nbsp;Optional.<br>
1567&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;URL.<br>
1568&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;type.<br>
1569&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"display":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;display&nbsp;mode.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1570&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"icon"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;next&nbsp;to&nbsp;the&nbsp;event's&nbsp;title&nbsp;in&nbsp;the&nbsp;calendar&nbsp;view.<br>
1571&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"chip"&nbsp;-&nbsp;The&nbsp;gadget&nbsp;displays&nbsp;when&nbsp;the&nbsp;event&nbsp;is&nbsp;clicked.<br>
1572&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iconLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;gadget's&nbsp;icon&nbsp;URL.<br>
1573&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1574&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.<br>
1575&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"iCalUID":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Event&nbsp;ID&nbsp;in&nbsp;the&nbsp;iCalendar&nbsp;format.<br>
1576&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extendedProperties":&nbsp;{&nbsp;#&nbsp;Extended&nbsp;properties&nbsp;of&nbsp;the&nbsp;event.<br>
1577&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"shared":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;shared&nbsp;between&nbsp;copies&nbsp;of&nbsp;the&nbsp;event&nbsp;on&nbsp;other&nbsp;attendees'&nbsp;calendars.<br>
1578&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1579&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"private":&nbsp;{&nbsp;#&nbsp;Properties&nbsp;that&nbsp;are&nbsp;private&nbsp;to&nbsp;the&nbsp;copy&nbsp;of&nbsp;the&nbsp;event&nbsp;that&nbsp;appears&nbsp;on&nbsp;this&nbsp;calendar.<br>
1580&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1581&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1582&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sequence":&nbsp;42,&nbsp;#&nbsp;Sequence&nbsp;number&nbsp;as&nbsp;per&nbsp;iCalendar.<br>
1583&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"visibility":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Visibility&nbsp;of&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1584&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"default"&nbsp;-&nbsp;Uses&nbsp;the&nbsp;default&nbsp;visibility&nbsp;for&nbsp;events&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1585&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"public"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;public&nbsp;and&nbsp;event&nbsp;details&nbsp;are&nbsp;visible&nbsp;to&nbsp;all&nbsp;readers&nbsp;of&nbsp;the&nbsp;calendar.<br>
1586&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"private"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private&nbsp;and&nbsp;only&nbsp;event&nbsp;attendees&nbsp;may&nbsp;view&nbsp;event&nbsp;details.<br>
1587&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"confidential"&nbsp;-&nbsp;The&nbsp;event&nbsp;is&nbsp;private.&nbsp;This&nbsp;value&nbsp;is&nbsp;provided&nbsp;for&nbsp;compatibility&nbsp;reasons.<br>
1588&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanModify":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;modify&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1589&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"end":&nbsp;{&nbsp;#&nbsp;The&nbsp;(exclusive)&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;event.&nbsp;For&nbsp;a&nbsp;recurring&nbsp;event,&nbsp;this&nbsp;is&nbsp;the&nbsp;end&nbsp;time&nbsp;of&nbsp;the&nbsp;first&nbsp;instance.<br>
1590&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date,&nbsp;in&nbsp;the&nbsp;format&nbsp;"yyyy-mm-dd",&nbsp;if&nbsp;this&nbsp;is&nbsp;an&nbsp;all-day&nbsp;event.<br>
1591&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timeZone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;the&nbsp;time&nbsp;zone&nbsp;in&nbsp;which&nbsp;the&nbsp;time&nbsp;is&nbsp;specified&nbsp;(e.g.&nbsp;"Europe/Zurich").&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;the&nbsp;time&nbsp;zone&nbsp;of&nbsp;the&nbsp;calendar.<br>
1592&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dateTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;time,&nbsp;as&nbsp;a&nbsp;combined&nbsp;date-time&nbsp;value&nbsp;(formatted&nbsp;according&nbsp;to&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>).&nbsp;A&nbsp;time&nbsp;zone&nbsp;offset&nbsp;is&nbsp;required&nbsp;unless&nbsp;a&nbsp;time&nbsp;zone&nbsp;is&nbsp;explicitly&nbsp;specified&nbsp;in&nbsp;'timeZone'.<br>
1593&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1594&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"attendeesOmitted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;have&nbsp;been&nbsp;omitted&nbsp;from&nbsp;the&nbsp;event's&nbsp;representation.&nbsp;When&nbsp;retrieving&nbsp;an&nbsp;event,&nbsp;this&nbsp;is&nbsp;due&nbsp;to&nbsp;a&nbsp;restriction&nbsp;specified&nbsp;by&nbsp;the&nbsp;'maxAttendee'&nbsp;query&nbsp;parameter.&nbsp;When&nbsp;updating&nbsp;an&nbsp;event,&nbsp;this&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;only&nbsp;update&nbsp;the&nbsp;participant's&nbsp;response.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1595&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"calendar#event",&nbsp;#&nbsp;Type&nbsp;of&nbsp;the&nbsp;resource&nbsp;("calendar#event").<br>
1596&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"created":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Creation&nbsp;time&nbsp;of&nbsp;the&nbsp;event&nbsp;(as&nbsp;a&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).&nbsp;Read-only.<br>
1597&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"colorId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;color&nbsp;of&nbsp;the&nbsp;event.&nbsp;This&nbsp;is&nbsp;an&nbsp;ID&nbsp;referring&nbsp;to&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;"event"&nbsp;section&nbsp;of&nbsp;the&nbsp;colors&nbsp;definition&nbsp;(see&nbsp;the&nbsp;"colors"&nbsp;endpoint).&nbsp;Optional.<br>
1598&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"anyoneCanAddSelf":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;anyone&nbsp;can&nbsp;invite&nbsp;themselves&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1599&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reminders":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;the&nbsp;event's&nbsp;reminders&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user.<br>
1600&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"overrides":&nbsp;[&nbsp;#&nbsp;If&nbsp;the&nbsp;event&nbsp;doesn't&nbsp;use&nbsp;the&nbsp;default&nbsp;reminders,&nbsp;this&nbsp;lists&nbsp;the&nbsp;reminders&nbsp;specific&nbsp;to&nbsp;the&nbsp;event,&nbsp;or,&nbsp;if&nbsp;not&nbsp;set,&nbsp;indicates&nbsp;that&nbsp;no&nbsp;reminders&nbsp;are&nbsp;set&nbsp;for&nbsp;this&nbsp;event.<br>
1601&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
1602&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minutes":&nbsp;42,&nbsp;#&nbsp;Number&nbsp;of&nbsp;minutes&nbsp;before&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;event&nbsp;when&nbsp;the&nbsp;reminder&nbsp;should&nbsp;trigger.<br>
1603&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"method":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;method&nbsp;used&nbsp;by&nbsp;this&nbsp;reminder.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1604&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"email"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;email.<br>
1605&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"sms"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;SMS.<br>
1606&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"popup"&nbsp;-&nbsp;Reminders&nbsp;are&nbsp;sent&nbsp;via&nbsp;a&nbsp;UI&nbsp;popup.<br>
1607&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1608&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
1609&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"useDefault":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;the&nbsp;default&nbsp;reminders&nbsp;of&nbsp;the&nbsp;calendar&nbsp;apply&nbsp;to&nbsp;the&nbsp;event.<br>
1610&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
1611&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanSeeOtherGuests":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;see&nbsp;who&nbsp;the&nbsp;event's&nbsp;attendees&nbsp;are.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1612&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"summary":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;of&nbsp;the&nbsp;event.<br>
1613&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"guestsCanInviteOthers":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;attendees&nbsp;other&nbsp;than&nbsp;the&nbsp;organizer&nbsp;can&nbsp;invite&nbsp;others&nbsp;to&nbsp;the&nbsp;event.&nbsp;Optional.&nbsp;The&nbsp;default&nbsp;is&nbsp;False.<br>
1614&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"transparency":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;the&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;Optional.&nbsp;Possible&nbsp;values&nbsp;are:<br>
1615&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"opaque"&nbsp;-&nbsp;The&nbsp;event&nbsp;blocks&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.&nbsp;This&nbsp;is&nbsp;the&nbsp;default&nbsp;value.<br>
1616&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;-&nbsp;"transparent"&nbsp;-&nbsp;The&nbsp;event&nbsp;does&nbsp;not&nbsp;block&nbsp;time&nbsp;on&nbsp;the&nbsp;calendar.<br>
1617&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"privateCopy":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;is&nbsp;a&nbsp;private&nbsp;event&nbsp;copy&nbsp;where&nbsp;changes&nbsp;are&nbsp;not&nbsp;shared&nbsp;with&nbsp;other&nbsp;copies&nbsp;on&nbsp;other&nbsp;calendars.&nbsp;Optional.&nbsp;Immutable.<br>
1618&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorio2401bd62011-12-15 09:18:49 -0500[diff] [blame]1619
1620<hr>
1621Data descriptors defined here:<br>
1622<dl><dt><strong>__dict__</strong></dt>
1623<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
1624</dl>
1625<dl><dt><strong>__weakref__</strong></dt>
1626<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
1627</dl>
1628</td></tr></table>
1629</body></html>