Api-roll 21: 2015-08-04

generated/googleapis/lib/calendar/v3.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.calendar.v3;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 32 matching lines @@
   final commons.ApiRequester _requester;
 
   AclResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Deletes an access control rule.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [ruleId] - ACL rule identifier.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future delete(core.String calendarId, core.String ruleId) {
@@ skipping 23 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
    * Returns an access control rule.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [ruleId] - ACL rule identifier.
    *
    * Completes with a [AclRule].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 25 matching lines @@
     return _response.then((data) => new AclRule.fromJson(data));
   }
 
   /**
    * Creates an access control rule.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [AclRule].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<AclRule> insert(AclRule request, core.String calendarId) {
@@ skipping 21 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new AclRule.fromJson(data));
   }
 
   /**
    * Returns the rules in the access control list for the calendar.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [maxResults] - Maximum number of entries returned on one result page. By
    * default the value is 100 entries. The page size can never be larger than
    * 250 entries. Optional.
    *
    * [pageToken] - Token specifying which result page to return. Optional.
    *
    * [showDeleted] - Whether to include deleted ACLs in the result. Deleted ACLs
    * are represented by role equal to "none". Deleted ACLs will always be
    * included if syncToken is provided. Optional. The default is False.
@@ skipping 53 matching lines @@
     return _response.then((data) => new Acl.fromJson(data));
   }
 
   /**
    * Updates an access control rule. This method supports patch semantics.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [ruleId] - ACL rule identifier.
    *
    * Completes with a [AclRule].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 28 matching lines @@
     return _response.then((data) => new AclRule.fromJson(data));
   }
 
   /**
    * Updates an access control rule.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [ruleId] - ACL rule identifier.
    *
    * Completes with a [AclRule].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 28 matching lines @@
     return _response.then((data) => new AclRule.fromJson(data));
   }
 
   /**
    * Watch for changes to ACL resources.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [maxResults] - Maximum number of entries returned on one result page. By
    * default the value is 100 entries. The page size can never be larger than
    * 250 entries. Optional.
    *
    * [pageToken] - Token specifying which result page to return. Optional.
    *
    * [showDeleted] - Whether to include deleted ACLs in the result. Deleted ACLs
    * are represented by role equal to "none". Deleted ACLs will always be
    * included if syncToken is provided. Optional. The default is False.
@@ skipping 63 matching lines @@
   final commons.ApiRequester _requester;
 
   CalendarListResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Deletes an entry on the user's calendar list.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future delete(core.String calendarId) {
     var _url = null;
     var _queryParams = new core.Map();
@@ skipping 18 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
    * Returns an entry on the user's calendar list.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [CalendarListEntry].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<CalendarListEntry> get(core.String calendarId) {
@@ skipping 155 matching lines @@
   }
 
   /**
    * Updates an entry on the user's calendar list. This method supports patch
    * semantics.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [colorRgbFormat] - Whether to use the foregroundColor and backgroundColor
    * fields to write the calendar colors (RGB). If this feature is used, the
    * index-based colorId field will be set to the best matching option
    * automatically. Optional. The default is False.
    *
    * Completes with a [CalendarListEntry].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 31 matching lines @@
     return _response.then((data) => new CalendarListEntry.fromJson(data));
   }
 
   /**
    * Updates an entry on the user's calendar list.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [colorRgbFormat] - Whether to use the foregroundColor and backgroundColor
    * fields to write the calendar colors (RGB). If this feature is used, the
    * index-based colorId field will be set to the best matching option
    * automatically. Optional. The default is False.
    *
    * Completes with a [CalendarListEntry].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 131 matching lines @@
 
   CalendarsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Clears a primary calendar. This operation deletes all events associated
    * with the primary calendar of an account.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future clear(core.String calendarId) {
     var _url = null;
     var _queryParams = new core.Map();
@@ skipping 19 matching lines @@
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
    * Deletes a secondary calendar. Use calendars.clear for clearing all events
    * on primary calendars.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future delete(core.String calendarId) {
     var _url = null;
     var _queryParams = new core.Map();
@@ skipping 18 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
    * Returns metadata for a calendar.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [Calendar].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Calendar> get(core.String calendarId) {
@@ skipping 59 matching lines @@
     return _response.then((data) => new Calendar.fromJson(data));
   }
 
   /**
    * Updates metadata for a calendar. This method supports patch semantics.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [Calendar].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Calendar> patch(Calendar request, core.String calendarId) {
@@ skipping 23 matching lines @@
     return _response.then((data) => new Calendar.fromJson(data));
   }
 
   /**
    * Updates metadata for a calendar.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * Completes with a [Calendar].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Calendar> update(Calendar request, core.String calendarId) {
@@ skipping 121 matching lines @@
   final commons.ApiRequester _requester;
 
   EventsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Deletes an event.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [eventId] - Event identifier.
    *
    * [sendNotifications] - Whether to send notifications about the deletion of
    * the event. Optional. The default is False.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
@@ skipping 29 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
    * Returns an event.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [eventId] - Event identifier.
    *
    * [alwaysIncludeEmail] - 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.
    *
@@ skipping 49 matching lines @@
   }
 
   /**
    * Imports an event. This operation is used to add a private copy of an
    * existing event to a calendar.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [supportsAttachments] - Whether API client performing operation supports
    * event attachments. Optional. The default is False.
    *
    * Completes with a [Event].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
@@ skipping 29 matching lines @@
     return _response.then((data) => new Event.fromJson(data));
   }
 
   /**
    * Creates an event.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [maxAttendees] - 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.
    *
    * [sendNotifications] - Whether to send notifications about the creation of
    * the new event. Optional. The default is False.
    *
    * [supportsAttachments] - Whether API client performing operation supports
    * event attachments. Optional. The default is False.
@@ skipping 40 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Event.fromJson(data));
   }
 
   /**
    * Returns instances of the specified recurring event.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [eventId] - Recurring event identifier.
    *
    * [alwaysIncludeEmail] - 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.
    *
    * [maxAttendees] - 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.
    *
    * [maxResults] - Maximum number of events returned on one result page. By
    * default the value is 250 events. The page size can never be larger than
    * 2500 events. Optional.
    *
    * [originalStart] - The original start time of the instance in the result.
    * Optional.
    *
    * [pageToken] - Token specifying which result page to return. Optional.
    *
    * [showDeleted] - Whether to include deleted events (with status equals
    * "cancelled") in the result. Cancelled instances of recurring events will
    * still be included if singleEvents is False. Optional. The default is False.
    *
    * [timeMax] - Upper bound (exclusive) for an event's start time to filter by.
-   * Optional. The default is not to filter by start time.
+   * Optional. The default is not to filter by start time. Must be an RFC3339
+   * timestamp with mandatory time zone offset.
    *
    * [timeMin] - Lower bound (inclusive) for an event's end time to filter by.
-   * Optional. The default is not to filter by end time.
+   * Optional. The default is not to filter by end time. Must be an RFC3339
+   * timestamp with mandatory time zone offset.
    *
    * [timeZone] - Time zone used in the response. Optional. The default is the
    * time zone of the calendar.
    *
    * Completes with a [Events].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
@@ skipping 51 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Events.fromJson(data));
   }
 
   /**
    * Returns events on the specified calendar.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [alwaysIncludeEmail] - 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.
    *
    * [iCalUID] - Specifies event ID in the iCalendar format to be included in
    * the response. Optional.
@@ skipping 58 matching lines @@
    * - sharedExtendedProperty
    * - timeMin
    * - timeMax
    * - updatedMin If the syncToken expires, the server will respond with a 410
    * GONE response code and the client should clear its storage and perform a
    * full synchronization without any syncToken.
    * Learn more about incremental synchronization.
    * Optional. The default is to return all entries.
    *
    * [timeMax] - Upper bound (exclusive) for an event's start time to filter by.
-   * Optional. The default is not to filter by start time.
+   * Optional. The default is not to filter by start time. Must be an RFC3339
+   * timestamp with mandatory time zone offset, e.g., 2011-06-03T10:00:00-07:00,
+   * 2011-06-03T10:00:00Z. Milliseconds may be provided but will be ignored.
    *
    * [timeMin] - Lower bound (inclusive) for an event's end time to filter by.
-   * Optional. The default is not to filter by end time.
+   * Optional. The default is not to filter by end time. Must be an RFC3339
+   * timestamp with mandatory time zone offset, e.g., 2011-06-03T10:00:00-07:00,
+   * 2011-06-03T10:00:00Z. Milliseconds may be provided but will be ignored.
    *
    * [timeZone] - Time zone used in the response. Optional. The default is the
    * time zone of the calendar.
    *
-   * [updatedMin] - Lower bound for an event's last modification time (as a RFC
-   * 3339 timestamp) to filter by. When specified, entries deleted since this
+   * [updatedMin] - Lower bound for an event's last modification time (as a
+   * RFC3339 timestamp) to filter by. When specified, entries deleted since this
    * time will always be included regardless of showDeleted. Optional. The
    * default is not to filter by last modification time.
    *
    * Completes with a [Events].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 131 matching lines @@
     return _response.then((data) => new Event.fromJson(data));
   }
 
   /**
    * Updates an event. This method supports patch semantics.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [eventId] - Event identifier.
    *
    * [alwaysIncludeEmail] - 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.
    *
@@ skipping 56 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Event.fromJson(data));
   }
 
   /**
    * Creates an event based on a simple text string.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [text] - The text describing the event to be created.
    *
    * [sendNotifications] - Whether to send notifications about the creation of
    * the event. Optional. The default is False.
    *
    * Completes with a [Event].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 32 matching lines @@
     return _response.then((data) => new Event.fromJson(data));
   }
 
   /**
    * Updates an event.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [eventId] - Event identifier.
    *
    * [alwaysIncludeEmail] - 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.
    *
@@ skipping 58 matching lines @@
     return _response.then((data) => new Event.fromJson(data));
   }
 
   /**
    * Watch for changes to Events resources.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [calendarId] - Calendar identifier.
+   * [calendarId] - Calendar identifier. To retrieve calendar IDs call the
+   * calendarList.list method. If you want to access the primary calendar of the
+   * currently logged in user, use the "primary" keyword.
    *
    * [alwaysIncludeEmail] - 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.
    *
    * [iCalUID] - Specifies event ID in the iCalendar format to be included in
    * the response. Optional.
@@ skipping 58 matching lines @@
    * - sharedExtendedProperty
    * - timeMin
    * - timeMax
    * - updatedMin If the syncToken expires, the server will respond with a 410
    * GONE response code and the client should clear its storage and perform a
    * full synchronization without any syncToken.
    * Learn more about incremental synchronization.
    * Optional. The default is to return all entries.
    *
    * [timeMax] - Upper bound (exclusive) for an event's start time to filter by.
-   * Optional. The default is not to filter by start time.
+   * Optional. The default is not to filter by start time. Must be an RFC3339
+   * timestamp with mandatory time zone offset, e.g., 2011-06-03T10:00:00-07:00,
+   * 2011-06-03T10:00:00Z. Milliseconds may be provided but will be ignored.
    *
    * [timeMin] - Lower bound (inclusive) for an event's end time to filter by.
-   * Optional. The default is not to filter by end time.
+   * Optional. The default is not to filter by end time. Must be an RFC3339
+   * timestamp with mandatory time zone offset, e.g., 2011-06-03T10:00:00-07:00,
+   * 2011-06-03T10:00:00Z. Milliseconds may be provided but will be ignored.
    *
    * [timeZone] - Time zone used in the response. Optional. The default is the
    * time zone of the calendar.
    *
-   * [updatedMin] - Lower bound for an event's last modification time (as a RFC
-   * 3339 timestamp) to filter by. When specified, entries deleted since this
+   * [updatedMin] - Lower bound for an event's last modification time (as a
+   * RFC3339 timestamp) to filter by. When specified, entries deleted since this
    * time will always be included regardless of showDeleted. Optional. The
    * default is not to filter by last modification time.
    *
    * Completes with a [Channel].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 459 matching lines @@
     }
     return _json;
   }
 }
 
 class Calendar {
   /** Description of the calendar. Optional. */
   core.String description;
   /** ETag of the resource. */
   core.String etag;
-  /** Identifier of the calendar. */
+  /**
+   * Identifier of the calendar. To retrieve IDs you call the
+   * calendarList.list() method.
+   */
   core.String id;
   /** Type of the resource ("calendar#calendar"). */
   core.String kind;
   /** Geographic location of the calendar as free-form text. Optional. */
   core.String location;
   /** Title of the calendar. */
   core.String summary;
   /**
    * The time zone of the calendar. (Formatted as an IANA Time Zone Database
    * name, e.g. "Europe/Zurich".) Optional.
@@ skipping 146 matching lines @@
    * appear to users with reader access, but event details will be hidden.
    * - "writer" - Provides read and write access to the calendar. Private events
    * will appear to users with writer access, and event details will be visible.
    * - "owner" - Provides ownership of the calendar. This role has all of the
    * permissions of the writer role with the additional ability to see and
    * manipulate ACLs.
    */
   core.String accessRole;
   /**
    * The main color of the calendar in the hexadecimal format "#0088aa". This
-   * property supersedes the index-based colorId property. Optional.
+   * property supersedes the index-based colorId property. To set or change this
+   * property, you need to specify colorRgbFormat=true in the parameters of the
+   * insert, update and patch methods. Optional.
    */
   core.String backgroundColor;
   /**
    * The color of the calendar. This is an ID referring to an entry in the
-   * calendar section of the colors definition (see the colors endpoint).
-   * Optional.
+   * calendar section of the colors definition (see the colors endpoint). This
+   * property is superseded by the backgroundColor and foregroundColor
+   * properties and can be ignored when using these properties. Optional.
    */
   core.String colorId;
   /**
    * The default reminders that the authenticated user has for this calendar.
    */
   core.List<EventReminder> defaultReminders;
   /**
    * Whether this calendar list entry has been deleted from the calendar list.
    * Read-only. Optional. The default is False.
    */
   core.bool deleted;
   /** Description of the calendar. Optional. Read-only. */
   core.String description;
   /** ETag of the resource. */
   core.String etag;
   /**
    * The foreground color of the calendar in the hexadecimal format "#ffffff".
-   * This property supersedes the index-based colorId property. Optional.
+   * This property supersedes the index-based colorId property. To set or change
+   * this property, you need to specify colorRgbFormat=true in the parameters of
+   * the insert, update and patch methods. Optional.
    */
   core.String foregroundColor;
   /**
    * Whether the calendar has been hidden from the list. Optional. The default
    * is False.
    */
   core.bool hidden;
   /** Identifier of the calendar. */
   core.String id;
   /** Type of the resource ("calendar#calendarListEntry"). */
@@ skipping 144 matching lines @@
     }
     return _json;
   }
 }
 
 class CalendarNotification {
   /**
    * The method used to deliver the notification. Possible values are:
    * - "email" - Reminders are sent via email.
    * - "sms" - Reminders are sent via SMS. This value is read-only and is
-   * ignored on inserts and updates.
+   * ignored on inserts and updates. SMS reminders are only available for Google
+   * Apps for Work, Education, and Government customers.
    */
   core.String method;
   /**
    * The type of notification. Possible values are:
    * - "eventCreation" - Notification sent when a new event is put on the
    * calendar.
    * - "eventChange" - Notification sent when an event is changed.
    * - "eventCancellation" - Notification sent when an event is cancelled.
    * - "eventResponse" - Notification sent when an event is changed.
    * - "agenda" - An agenda with the events of the day (sent out in the
@@ skipping 156 matching lines @@
     }
     if (foreground != null) {
       _json["foreground"] = foreground;
     }
     return _json;
   }
 }
 
 class Colors {
   /**
-   * Palette of calendar colors, mapping from the color ID to its definition. A
-   * calendarListEntry resource refers to one of these color IDs in its color
-   * field. Read-only.
+   * A global palette of calendar colors, mapping from the color ID to its
+   * definition. A calendarListEntry resource refers to one of these color IDs
+   * in its color field. Read-only.
    */
   core.Map<core.String, ColorDefinition> calendar;
   /**
-   * Palette of event colors, mapping from the color ID to its definition. An
-   * event resource may refer to one of these color IDs in its color field.
-   * Read-only.
+   * A global palette of event colors, mapping from the color ID to its
+   * definition. An event resource may refer to one of these color IDs in its
+   * color field. Read-only.
    */
   core.Map<core.String, ColorDefinition> event;
   /** Type of the resource ("calendar#colors"). */
   core.String kind;
   /**
-   * Last modification time of the color palette (as a RFC 3339 timestamp).
+   * Last modification time of the color palette (as a RFC3339 timestamp).
    * Read-only.
    */
   core.DateTime updated;
 
   Colors();
 
   Colors.fromJson(core.Map _json) {
     if (_json.containsKey("calendar")) {
       calendar = commons.mapMap(_json["calendar"], (item) => new ColorDefinition.fromJson(item));
     }
@@ skipping 64 matching lines @@
     return _json;
   }
 }
 
 /** The creator of the event. Read-only. */
 class EventCreator {
   /** The creator's name, if available. */
   core.String displayName;
   /** The creator's email address, if available. */
   core.String email;
-  /** The creator's Profile ID, if available. */
+  /**
+   * The creator's Profile ID, if available. It corresponds to theid field in
+   * the People collection of the Google+ API
+   */
   core.String id;
   /**
    * Whether the creator corresponds to the calendar on which this copy of the
    * event appears. Read-only. The default is False.
    */
   core.bool self;
 
   EventCreator();
 
   EventCreator.fromJson(core.Map _json) {
@@ skipping 67 matching lines @@
 
 /** A gadget that extends this event. */
 class EventGadget {
   /**
    * The gadget's display mode. Optional. Possible values are:
    * - "icon" - The gadget displays next to the event's title in the calendar
    * view.
    * - "chip" - The gadget displays when the event is clicked.
    */
   core.String display;
-  /** The gadget's height in pixels. Optional. */
+  /**
+   * The gadget's height in pixels. The height must be an integer greater than
+   * 0. Optional.
+   */
   core.int height;
-  /** The gadget's icon URL. */
+  /** The gadget's icon URL. The URL scheme must be HTTPS. */
   core.String iconLink;
-  /** The gadget's URL. */
+  /** The gadget's URL. The URL scheme must be HTTPS. */
   core.String link;
   /** Preferences. */
   core.Map<core.String, core.String> preferences;
   /** The gadget's title. */
   core.String title;
   /** The gadget's type. */
   core.String type;
-  /** The gadget's width in pixels. Optional. */
+  /**
+   * The gadget's width in pixels. The width must be an integer greater than 0.
+   * Optional.
+   */
   core.int width;
 
   EventGadget();
 
   EventGadget.fromJson(core.Map _json) {
     if (_json.containsKey("display")) {
       display = _json["display"];
     }
     if (_json.containsKey("height")) {
       height = _json["height"];
@@ skipping 50 matching lines @@
 
 /**
  * The organizer of the event. If the organizer is also an attendee, this is
  * indicated with a separate entry in attendees with the organizer field set to
  * True. To change the organizer, use the move operation. Read-only, except when
  * importing an event.
  */
 class EventOrganizer {
   /** The organizer's name, if available. */
   core.String displayName;
-  /** The organizer's email address, if available. */
+  /**
+   * The organizer's email address, if available. It must be a valid email
+   * address as per RFC5322.
+   */
   core.String email;
-  /** The organizer's Profile ID, if available. */
+  /**
+   * The organizer's Profile ID, if available. It corresponds to theid field in
+   * the People collection of the Google+ API
+   */
   core.String id;
   /**
    * Whether the organizer corresponds to the calendar on which this copy of the
    * event appears. Read-only. The default is False.
    */
   core.bool self;
 
   EventOrganizer();
 
   EventOrganizer.fromJson(core.Map _json) {
@@ skipping 27 matching lines @@
     }
     return _json;
   }
 }
 
 /** Information about the event's reminders for the authenticated user. */
 class EventReminders {
   /**
    * If the event doesn't use the default reminders, this lists the reminders
    * specific to the event, or, if not set, indicates that no reminders are set
-   * for this event.
+   * for this event. The maximum number of override reminders is 5.
    */
   core.List<EventReminder> overrides;
   /** Whether the default reminders of the calendar apply to the event. */
   core.bool useDefault;
 
   EventReminders();
 
   EventReminders.fromJson(core.Map _json) {
     if (_json.containsKey("overrides")) {
       overrides = _json["overrides"].map((value) => new EventReminder.fromJson(value)).toList();
     }
     if (_json.containsKey("useDefault")) {
       useDefault = _json["useDefault"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (overrides != null) {
       _json["overrides"] = overrides.map((value) => (value).toJson()).toList();
     }
     if (useDefault != null) {
       _json["useDefault"] = useDefault;
     }
     return _json;
   }
 }
 
 /**
- * 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.
+ * Source from which the event was created. For example, a web page, an email
+ * message or any document identifiable by an URL with HTTP or HTTPS scheme. Can
+ * only be seen or modified by the creator of the event.
  */
 class EventSource {
   /**
    * Title of the source; for example a title of a web page or an email subject.
    */
   core.String title;
   /**
-   * URL of the source pointing to a resource. URL's protocol must be HTTP or
+   * URL of the source pointing to a resource. The URL scheme must be HTTP or
    * HTTPS.
    */
   core.String url;
 
   EventSource();
 
   EventSource.fromJson(core.Map _json) {
     if (_json.containsKey("title")) {
       title = _json["title"];
     }
@@ skipping 21 matching lines @@
    */
   core.bool anyoneCanAddSelf;
   /**
    * File attachments for the event. Currently only Google Drive attachments are
    * supported.
    * In order to modify attachments the supportsAttachments request parameter
    * should be set to true.
    * There can be at most 25 attachments per event,
    */
   core.List<EventAttachment> attachments;
-  /** The attendees of the event. */
+  /**
+   * The attendees of the event. See the Events with attendees guide for more
+   * information on scheduling events with other calendar users.
+   */
   core.List<EventAttendee> attendees;
   /**
    * Whether attendees may have been omitted from the event's representation.
    * When retrieving an event, this may be due to a restriction specified by the
    * maxAttendee query parameter. When updating an event, this can be used to
    * only update the participant's response. Optional. The default is False.
    */
   core.bool attendeesOmitted;
   /**
    * The color of the event. This is an ID referring to an entry in the event
    * section of the colors definition (see the  colors endpoint). Optional.
    */
   core.String colorId;
-  /** Creation time of the event (as a RFC 3339 timestamp). Read-only. */
+  /** Creation time of the event (as a RFC3339 timestamp). Read-only. */
   core.DateTime created;
   /** The creator of the event. Read-only. */
   EventCreator creator;
   /** Description of the event. Optional. */
   core.String description;
   /**
    * The (exclusive) end time of the event. For a recurring event, this is the
    * end time of the first instance.
    */
   EventDateTime end;
@@ skipping 26 matching lines @@
   core.bool guestsCanSeeOtherGuests;
   /**
    * An absolute link to the Google+ hangout associated with this event.
    * Read-only.
    */
   core.String hangoutLink;
   /**
    * An absolute link to this event in the Google Calendar Web UI. Read-only.
    */
   core.String htmlLink;
-  /** Event ID in the iCalendar format. */
+  /**
+   * Event unique identifier as defined in RFC5545. It is used to uniquely
+   * identify events accross calendaring systems and must be supplied when
+   * importing events via the import method.
+   * Note that the icalUID and the id are not identical and only one of them
+   * should be supplied at event creation time. One difference in their
+   * semantics is that in recurring events, all occurrences of one event have
+   * different ids while they all share the same icalUIDs.
+   */
   core.String iCalUID;
   /**
-   * Identifier of the event. When creating new single or recurring events, you
-   * can specify their IDs. Provided IDs must follow these rules:
+   * Opaque identifier of the event. When creating new single or recurring
+   * events, you can specify their IDs. Provided IDs must follow these rules:
    * - characters allowed in the ID are those used in base32hex encoding, i.e.
    * lowercase letters a-v and digits 0-9, see section 3.1.2 in RFC2938
    * - the length of the ID must be between 5 and 1024 characters
    * - the ID must be unique per calendar  Due to the globally distributed
    * nature of the system, we cannot guarantee that ID collisions will be
    * detected at event creation time. To minimize the risk of collisions we
    * recommend using an established UUID algorithm such as one described in
    * RFC4122.
+   * If you do not specify an ID, it will be automatically generated by the
+   * server.
+   * Note that the icalUID and the id are not identical and only one of them
+   * should be supplied at event creation time. One difference in their
+   * semantics is that in recurring events, all occurrences of one event have
+   * different ids while they all share the same icalUIDs.
    */
   core.String id;
   /** Type of the resource ("calendar#event"). */
   core.String kind;
   /** Geographic location of the event as free-form text. Optional. */
   core.String location;
   /**
    * Whether this is a locked event copy where no changes can be made to the
    * main event fields "summary", "description", "location", "start", "end" or
    * "recurrence". The default is False. Read-Only.
@@ skipping 11 matching lines @@
    * would start according to the recurrence data in the recurring event
    * identified by recurringEventId. Immutable.
    */
   EventDateTime originalStartTime;
   /**
    * Whether this is a private event copy where changes are not shared with
    * other copies on other calendars. Optional. Immutable. The default is False.
    */
   core.bool privateCopy;
   /**
-   * List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This
-   * field is omitted for single events or instances of recurring events.
+   * List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as
+   * specified in RFC5545. Note that DTSTART and DTEND lines are not allowed in
+   * this field; event start and end times are specified in the start and end
+   * fields. This field is omitted for single events or instances of recurring
+   * events.
    */
   core.List<core.String> recurrence;
   /**
-   * For an instance of a recurring event, this is the event ID of the recurring
-   * event itself. Immutable.
+   * For an instance of a recurring event, this is the id of the recurring event
+   * to which this instance belongs. Immutable.
    */
   core.String recurringEventId;
   /** Information about the event's reminders for the authenticated user. */
   EventReminders reminders;
   /** Sequence number as per iCalendar. */
   core.int sequence;
   /**
-   * 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.
+   * Source from which the event was created. For example, a web page, an email
+   * message or any document identifiable by an URL with HTTP or HTTPS scheme.
+   * Can only be seen or modified by the creator of the event.
    */
   EventSource source;
   /**
    * The (inclusive) start time of the event. For a recurring event, this is the
    * start time of the first instance.
    */
   EventDateTime start;
   /**
    * Status of the event. Optional. Possible values are:
    * - "confirmed" - The event is confirmed. This is the default status.
    * - "tentative" - The event is tentatively confirmed.
    * - "cancelled" - The event is cancelled.
    */
   core.String status;
   /** Title of the event. */
   core.String summary;
   /**
    * 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.
    */
   core.String transparency;
   /**
-   * Last modification time of the event (as a RFC 3339 timestamp). Read-only.
+   * Last modification time of the event (as a RFC3339 timestamp). Read-only.
    */
   core.DateTime updated;
   /**
    * Visibility of the event. Optional. Possible values are:
    * - "default" - Uses the default visibility for events on the calendar. This
    * is the default value.
    * - "public" - The event is public and event details are visible to all
    * readers of the calendar.
    * - "private" - The event is private and only event attendees may view event
    * details.
@@ skipping 230 matching lines @@
     }
     if (visibility != null) {
       _json["visibility"] = visibility;
     }
     return _json;
   }
 }
 
 class EventAttachment {
   /**
+   * ID of the attached file. Read-only.
+   * For Google Drive files, this is the ID of the corresponding Files resource
+   * entry in the Drive API.
+   */
+  core.String fileId;
+  /**
    * URL link to the attachment.
    * For adding Google Drive file attachments use the same format as in
    * alternateLink property of the Files resource in the Drive API.
    */
   core.String fileUrl;
   /** URL link to the attachment's icon. Read-only. */
   core.String iconLink;
   /** Internet media type (MIME type) of the attachment. */
   core.String mimeType;
   /** Attachment title. */
   core.String title;
 
   EventAttachment();
 
   EventAttachment.fromJson(core.Map _json) {
+    if (_json.containsKey("fileId")) {
+      fileId = _json["fileId"];
+    }
     if (_json.containsKey("fileUrl")) {
       fileUrl = _json["fileUrl"];
     }
     if (_json.containsKey("iconLink")) {
       iconLink = _json["iconLink"];
     }
     if (_json.containsKey("mimeType")) {
       mimeType = _json["mimeType"];
     }
     if (_json.containsKey("title")) {
       title = _json["title"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (fileId != null) {
+      _json["fileId"] = fileId;
+    }
     if (fileUrl != null) {
       _json["fileUrl"] = fileUrl;
     }
     if (iconLink != null) {
       _json["iconLink"] = iconLink;
     }
     if (mimeType != null) {
       _json["mimeType"] = mimeType;
     }
     if (title != null) {
       _json["title"] = title;
     }
     return _json;
   }
 }
 
 class EventAttendee {
   /** Number of additional guests. Optional. The default is 0. */
   core.int additionalGuests;
   /** The attendee's response comment. Optional. */
   core.String comment;
   /** The attendee's name, if available. Optional. */
   core.String displayName;
   /**
    * The attendee's email address, if available. This field must be present when
-   * adding an attendee.
+   * adding an attendee. It must be a valid email address as per RFC5322.
    */
   core.String email;
-  /** The attendee's Profile ID, if available. */
+  /**
+   * The attendee's Profile ID, if available. It corresponds to theid field in
+   * the People collection of the Google+ API
+   */
   core.String id;
   /** Whether this is an optional attendee. Optional. The default is False. */
   core.bool optional;
   /**
    * Whether the attendee is the organizer of the event. Read-only. The default
    * is False.
    */
   core.bool organizer;
   /** Whether the attendee is a resource. Read-only. The default is False. */
   core.bool resource;
@@ skipping 79 matching lines @@
       _json["self"] = self;
     }
     return _json;
   }
 }
 
 class EventDateTime {
   /** The date, in the format "yyyy-mm-dd", if this is an all-day event. */
   core.DateTime date;
   /**
-   * 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.
+   * The time, as a combined date-time value (formatted according to RFC3339). A
+   * time zone offset is required unless a time zone is explicitly specified in
+   * timeZone.
    */
   core.DateTime dateTime;
   /**
    * The time zone in which the time is specified. (Formatted as an IANA Time
    * Zone Database name, e.g. "Europe/Zurich".) For recurring events this field
    * is required and specifies the time zone in which the recurrence is
    * expanded. For single events this field is optional and indicates a custom
    * time zone for the event start/end.
    */
   core.String timeZone;
@@ skipping 24 matching lines @@
       _json["timeZone"] = timeZone;
     }
     return _json;
   }
 }
 
 class EventReminder {
   /**
    * The method used by this reminder. Possible values are:
    * - "email" - Reminders are sent via email.
-   * - "sms" - Reminders are sent via SMS.
+   * - "sms" - Reminders are sent via SMS. These are only available for Google
+   * Apps for Work, Education, and Government customers. Requests to set SMS
+   * reminders for other account types are ignored.
    * - "popup" - Reminders are sent via a UI popup.
    */
   core.String method;
   /**
    * Number of minutes before the start of the event when the reminder should
-   * trigger.
+   * trigger. Valid values are between 0 and 40320 (4 weeks in minutes).
    */
   core.int minutes;
 
   EventReminder();
 
   EventReminder.fromJson(core.Map _json) {
     if (_json.containsKey("method")) {
       method = _json["method"];
     }
     if (_json.containsKey("minutes")) {
@@ skipping 51 matching lines @@
    * Token used at a later point in time to retrieve only the entries that have
    * changed since this result was returned. Omitted if further results are
    * available, in which case nextPageToken is provided.
    */
   core.String nextSyncToken;
   /** Title of the calendar. Read-only. */
   core.String summary;
   /** The time zone of the calendar. Read-only. */
   core.String timeZone;
   /**
-   * Last modification time of the calendar (as a RFC 3339 timestamp).
-   * Read-only.
+   * Last modification time of the calendar (as a RFC3339 timestamp). Read-only.
    */
   core.DateTime updated;
 
   Events();
 
   Events.fromJson(core.Map _json) {
     if (_json.containsKey("accessRole")) {
       accessRole = _json["accessRole"];
     }
     if (_json.containsKey("defaultReminders")) {
@@ skipping 398 matching lines @@
     var _json = new core.Map();
     if (end != null) {
       _json["end"] = (end).toIso8601String();
     }
     if (start != null) {
       _json["start"] = (start).toIso8601String();
     }
     return _json;
   }
 }