Refresh docs
diff --git a/docs/dyn/calendar_v3.events.html b/docs/dyn/calendar_v3.events.html
index 14939a3..ab55b93 100644
--- a/docs/dyn/calendar_v3.events.html
+++ b/docs/dyn/calendar_v3.events.html
@@ -82,7 +82,7 @@
<p class="firstline">Returns an event.</p>
<p class="toc_element">
<code><a href="#import_">import_(calendarId, body)</a></code></p>
-<p class="firstline">Imports an event.</p>
+<p class="firstline">Imports an event. This operation is used to add a private copy of an existing event to a calendar.</p>
<p class="toc_element">
<code><a href="#insert">insert(calendarId, body, sendNotifications=None, maxAttendees=None)</a></code></p>
<p class="firstline">Creates an event.</p>
@@ -110,6 +110,9 @@
<p class="toc_element">
<code><a href="#update">update(calendarId, eventId, body, sendNotifications=None, alwaysIncludeEmail=None, maxAttendees=None)</a></code></p>
<p class="firstline">Updates an event.</p>
+<p class="toc_element">
+ <code><a href="#watch">watch(calendarId, body, orderBy=None, showHiddenInvitations=None, timeMin=None, pageToken=None, updatedMin=None, singleEvents=None, alwaysIncludeEmail=None, showDeleted=None, maxAttendees=None, iCalUID=None, maxResults=None, timeMax=None, q=None, timeZone=None)</a></code></p>
+<p class="firstline">Subscribe to changes in events collection</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="delete">delete(calendarId, eventId, sendNotifications=None)</code>
@@ -170,15 +173,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -252,13 +259,13 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}</pre>
</div>
<div class="method">
<code class="details" id="import_">import_(calendarId, body)</code>
- <pre>Imports an event.
+ <pre>Imports an event. This operation is used to add a private copy of an existing event to a calendar.
Args:
calendarId: string, Calendar identifier. (required)
@@ -299,15 +306,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -381,7 +392,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}
@@ -422,15 +433,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -504,7 +519,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}</pre>
</div>
@@ -551,15 +566,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -633,7 +652,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}
sendNotifications: boolean, Whether to send notifications about the creation of the new event. Optional. The default is False.
@@ -676,15 +695,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -758,7 +781,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}</pre>
</div>
@@ -830,15 +853,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -912,7 +939,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
},
],
"updated": "A String", # Last modification time of the calendar (as a RFC 3339 timestamp). Read-only.
@@ -958,7 +985,7 @@
updatedMin: string, Lower bound for an event's last modification time (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by last modification time.
singleEvents: boolean, Whether to expand recurring events into instances and only return single one-off events and instances of recurring events, but not the underlying recurring events themselves. Optional. The default is False.
alwaysIncludeEmail: boolean, Whether to always include a value in the "email" field for the organizer, creator and attendees, even if no real email is available (i.e. a generated, non-working value will be provided). The use of this option is discouraged and should only be used by clients which cannot handle the absence of an email address value in the mentioned places. Optional. The default is False.
- showDeleted: boolean, Whether to include deleted events (with 'status' equals 'cancelled') in the result. Cancelled instances of recurring events (but not the underlying recurring event) will still be included if 'showDeleted' and 'singleEvents' are both False. If 'showDeleted' and 'singleEvents' are both True only single instances of deleted events (but not the underlying recurring events) are returned. Optional. The default is False.
+ showDeleted: boolean, Whether to include deleted events (with 'status' equals 'cancelled') in the result. Cancelled instances of recurring events (but not the underlying recurring event) will still be included if 'showDeleted' and 'singleEvents' are both False. If 'showDeleted' and 'singleEvents' are both True, only single instances of deleted events (but not the underlying recurring events) are returned. Optional. The default is False.
maxAttendees: integer, The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.
iCalUID: string, Specifies iCalendar UID (iCalUID) of events to be included in the response. Optional.
maxResults: integer, Maximum number of events returned on one result page. Optional.
@@ -1017,15 +1044,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -1099,7 +1130,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
},
],
"updated": "A String", # Last modification time of the calendar (as a RFC 3339 timestamp). Read-only.
@@ -1176,15 +1207,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -1258,7 +1293,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}</pre>
</div>
@@ -1306,15 +1341,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -1388,7 +1427,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}
sendNotifications: boolean, Whether to send notifications about the event update (e.g. attendee's responses, title changes, etc.). Optional. The default is False.
@@ -1432,15 +1471,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -1514,7 +1557,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}</pre>
</div>
@@ -1564,15 +1607,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -1646,7 +1693,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}</pre>
</div>
@@ -1694,15 +1741,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -1776,7 +1827,7 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
}
sendNotifications: boolean, Whether to send notifications about the event update (e.g. attendee's responses, title changes, etc.). Optional. The default is False.
@@ -1820,15 +1871,19 @@
"email": "A String", # The attendee's email address, if available. This field must be present when adding an attendee.
},
],
- "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
- "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
- "A String",
- ],
"start": { # The (inclusive) start time of the event. For a recurring event, this is the start time of the first instance.
"date": "A String", # The date, in the format "yyyy-mm-dd", if this is an all-day event.
"timeZone": "A String", # The name of the time zone in which the time is specified (e.g. "Europe/Zurich"). Optional. The default is the time zone of the calendar.
"dateTime": "A String", # The time, as a combined date-time value (formatted according to RFC 3339). A time zone offset is required unless a time zone is explicitly specified in 'timeZone'.
},
+ "htmlLink": "A String", # An absolute link to this event in the Google Calendar Web UI. Read-only.
+ "recurrence": [ # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.
+ "A String",
+ ],
+ "source": { # Source of an event from which it was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of the event.
+ "url": "A String", # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+ "title": "A String", # Title of the source; for example a title of a web page or an email subject.
+ },
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the event as free-form text. Optional.
"recurringEventId": "A String", # For an instance of a recurring event, this is the event ID of the recurring event itself. Immutable.
@@ -1902,7 +1957,66 @@
"transparency": "A String", # Whether the event blocks time on the calendar. Optional. Possible values are:
# - "opaque" - The event blocks time on the calendar. This is the default value.
# - "transparent" - The event does not block time on the calendar.
- "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable.
+ "privateCopy": True or False, # Whether this is a private event copy where changes are not shared with other copies on other calendars. Optional. Immutable. The default is False.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="watch">watch(calendarId, body, orderBy=None, showHiddenInvitations=None, timeMin=None, pageToken=None, updatedMin=None, singleEvents=None, alwaysIncludeEmail=None, showDeleted=None, maxAttendees=None, iCalUID=None, maxResults=None, timeMax=None, q=None, timeZone=None)</code>
+ <pre>Subscribe to changes in events collection
+
+Args:
+ calendarId: string, Calendar identifier. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{
+ "resourceUri": "A String", # The canonicalized ID of the watched resource.
+ "kind": "api#channel", # A channel watching an API resource
+ "resourceId": "A String", # An opaque id that identifies the resource that is being watched. Stable across different API versions
+ "token": "A String", # An arbitrary string associated with the channel that is delivered to the target address with each event delivered over this channel.
+ "params": { # Additional parameters controlling delivery channel behavior
+ "a_key": "A String", # Declares a new parameter by name.
+ },
+ "expiration": "A String", # The expiration instant for this channel if it is defined.
+ "address": "A String", # The address of the receiving entity where events are delivered. Specific to the channel type.
+ "type": "A String", # The type of delivery mechanism used by this channel
+ "id": "A String", # A UUID for the channel
+ }
+
+ orderBy: string, The order of the events returned in the result. Optional. The default is an unspecified, stable order.
+ Allowed values
+ startTime - Order by the start date/time (ascending). This is only available when querying single events (i.e. the parameter "singleEvents" is True)
+ updated - Order by last modification time (ascending).
+ showHiddenInvitations: boolean, Whether to include hidden invitations in the result. Optional. The default is False.
+ timeMin: string, Lower bound (inclusive) for an event's end time to filter by. Optional. The default is not to filter by end time.
+ pageToken: string, Token specifying which result page to return. Optional.
+ updatedMin: string, Lower bound for an event's last modification time (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by last modification time.
+ singleEvents: boolean, Whether to expand recurring events into instances and only return single one-off events and instances of recurring events, but not the underlying recurring events themselves. Optional. The default is False.
+ alwaysIncludeEmail: boolean, Whether to always include a value in the "email" field for the organizer, creator and attendees, even if no real email is available (i.e. a generated, non-working value will be provided). The use of this option is discouraged and should only be used by clients which cannot handle the absence of an email address value in the mentioned places. Optional. The default is False.
+ showDeleted: boolean, Whether to include deleted events (with 'status' equals 'cancelled') in the result. Cancelled instances of recurring events (but not the underlying recurring event) will still be included if 'showDeleted' and 'singleEvents' are both False. If 'showDeleted' and 'singleEvents' are both True, only single instances of deleted events (but not the underlying recurring events) are returned. Optional. The default is False.
+ maxAttendees: integer, The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.
+ iCalUID: string, Specifies iCalendar UID (iCalUID) of events to be included in the response. Optional.
+ maxResults: integer, Maximum number of events returned on one result page. Optional.
+ timeMax: string, Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time.
+ q: string, Free text search terms to find events that match these terms in any field, except for extended properties. Optional.
+ timeZone: string, Time zone used in the response. Optional. The default is the time zone of the calendar.
+
+Returns:
+ An object of the form:
+
+ {
+ "resourceUri": "A String", # The canonicalized ID of the watched resource.
+ "kind": "api#channel", # A channel watching an API resource
+ "resourceId": "A String", # An opaque id that identifies the resource that is being watched. Stable across different API versions
+ "token": "A String", # An arbitrary string associated with the channel that is delivered to the target address with each event delivered over this channel.
+ "params": { # Additional parameters controlling delivery channel behavior
+ "a_key": "A String", # Declares a new parameter by name.
+ },
+ "expiration": "A String", # The expiration instant for this channel if it is defined.
+ "address": "A String", # The address of the receiving entity where events are delivered. Specific to the channel type.
+ "type": "A String", # The type of delivery mechanism used by this channel
+ "id": "A String", # A UUID for the channel
}</pre>
</div>