google-api-client 0.9.pre2 → 0.9.pre3

data/generated/google/apis/blogger_v3/service.rb

@@ -165,7 +165,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_blog_by_url(url: nil, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def get_blog_by_url(url, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'blogs/byurl'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BloggerV3::Blog::Representation
@@ -1157,10 +1157,10 @@ module Google
         # Retrieve a Post by Path.
         # @param [String] blog_id
         #   ID of the blog to fetch the post from.
-        # @param [Fixnum] max_comments
-        #   Maximum number of comments to pull back on a post.
         # @param [String] path
         #   Path of the Post to retrieve.
+        # @param [Fixnum] max_comments
+        #   Maximum number of comments to pull back on a post.
         # @param [String] view
         #   Access level with which to view the returned result. Note that some fields
         #   require elevated access.
@@ -1185,7 +1185,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_post_by_path(blog_id, max_comments: nil, path: nil, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def get_post_by_path(blog_id, path, max_comments: nil, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'blogs/{blogId}/posts/bypath'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BloggerV3::Post::Representation
@@ -1467,13 +1467,13 @@ module Google
         # Search for a post.
         # @param [String] blog_id
         #   ID of the blog to fetch the post from.
+        # @param [String] q
+        #   Query terms to search this blog for matching posts.
         # @param [Boolean] fetch_bodies
         #   Whether the body content of posts is included (default: true). This should be
         #   set to false when the post bodies are not required, to help minimize traffic.
         # @param [String] order_by
         #   Sort search results
-        # @param [String] q
-        #   Query terms to search this blog for matching posts.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1495,7 +1495,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def search_posts(blog_id, fetch_bodies: nil, order_by: nil, q: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def search_posts(blog_id, q, fetch_bodies: nil, order_by: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'blogs/{blogId}/posts/search'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BloggerV3::PostList::Representation

data/generated/google/apis/books_v1/service.rb

@@ -252,7 +252,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_book(volume_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def delete_book(volume_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'cloudloading/deleteBook'
           command =  make_simple_command(:post, path, options)
           command.query['volumeId'] = volume_id unless volume_id.nil?
@@ -322,7 +322,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_offline_metadata_dictionary(cpksver: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_offline_metadata_dictionary(cpksver, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'dictionary/listOfflineMetadata'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BooksV1::Metadata::Representation
@@ -434,10 +434,10 @@ module Google
         #   The ID for the layer to get the annotations.
         # @param [String] annotation_data_id
         #   The ID of the annotation data to retrieve.
-        # @param [Boolean] allow_web_definitions
-        #   For the dictionary layer. Whether or not to allow web definitions.
         # @param [String] content_version
         #   The content version for the volume you are trying to retrieve.
+        # @param [Boolean] allow_web_definitions
+        #   For the dictionary layer. Whether or not to allow web definitions.
         # @param [Fixnum] h
         #   The requested pixel height for any images. If height is provided width must
         #   also be provided.
@@ -472,7 +472,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_layer_annotation_data(volume_id, layer_id, annotation_data_id, allow_web_definitions: nil, content_version: nil, h: nil, locale: nil, scale: nil, source: nil, w: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def get_layer_annotation_data(volume_id, layer_id, annotation_data_id, content_version, allow_web_definitions: nil, h: nil, locale: nil, scale: nil, source: nil, w: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'volumes/{volumeId}/layers/{layerId}/data/{annotationDataId}'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BooksV1::AnnotationData::Representation
@@ -498,11 +498,11 @@ module Google
         #   The volume to retrieve annotation data for.
         # @param [String] layer_id
         #   The ID for the layer to get the annotation data.
+        # @param [String] content_version
+        #   The content version for the requested volume.
         # @param [Array<String>, String] annotation_data_id
         #   The list of Annotation Data Ids to retrieve. Pagination is ignored if this is
         #   set.
-        # @param [String] content_version
-        #   The content version for the requested volume.
         # @param [Fixnum] h
         #   The requested pixel height for any images. If height is provided width must
         #   also be provided.
@@ -547,7 +547,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_layer_annotation_data(volume_id, layer_id, annotation_data_id: nil, content_version: nil, h: nil, locale: nil, max_results: nil, page_token: nil, scale: nil, source: nil, updated_max: nil, updated_min: nil, w: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_layer_annotation_data(volume_id, layer_id, content_version, annotation_data_id: nil, h: nil, locale: nil, max_results: nil, page_token: nil, scale: nil, source: nil, updated_max: nil, updated_min: nil, w: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'volumes/{volumeId}/layers/{layerId}/data'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BooksV1::AnnotationsData::Representation
@@ -676,7 +676,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_layer_volume_annotations(volume_id, layer_id, content_version: nil, end_offset: nil, end_position: nil, locale: nil, max_results: nil, page_token: nil, show_deleted: nil, source: nil, start_offset: nil, start_position: nil, updated_max: nil, updated_min: nil, volume_annotations_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_layer_volume_annotations(volume_id, layer_id, content_version, end_offset: nil, end_position: nil, locale: nil, max_results: nil, page_token: nil, show_deleted: nil, source: nil, start_offset: nil, start_position: nil, updated_max: nil, updated_min: nil, volume_annotations_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'volumes/{volumeId}/layers/{layerId}'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BooksV1::Volumeannotations::Representation
@@ -736,14 +736,14 @@ module Google
         end
         
         # Release downloaded content access restriction.
+        # @param [Array<String>, String] volume_ids
+        #   The volume(s) to release restrictions for.
         # @param [String] cpksver
         #   The device/version ID from which to release the restriction.
         # @param [String] locale
         #   ISO-639-1, ISO-3166-1 codes for message localization, i.e. en_US.
         # @param [String] source
         #   String to identify the originator of this request.
-        # @param [Array<String>, String] volume_ids
-        #   The volume(s) to release restrictions for.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -765,7 +765,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def release_download_access(cpksver: nil, locale: nil, source: nil, volume_ids: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def release_download_access(volume_ids, cpksver, locale: nil, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'myconfig/releaseDownloadAccess'
           command =  make_simple_command(:post, path, options)
           command.response_representation = Google::Apis::BooksV1::DownloadAccesses::Representation
@@ -781,18 +781,18 @@ module Google
         end
         
         # Request concurrent and download access restrictions.
+        # @param [String] source
+        #   String to identify the originator of this request.
+        # @param [String] volume_id
+        #   The volume to request concurrent/download restrictions for.
+        # @param [String] nonce
+        #   The client nonce value.
         # @param [String] cpksver
         #   The device/version ID from which to request the restrictions.
         # @param [String] license_types
         #   The type of access license to request. If not specified, the default is BOTH.
         # @param [String] locale
         #   ISO-639-1, ISO-3166-1 codes for message localization, i.e. en_US.
-        # @param [String] nonce
-        #   The client nonce value.
-        # @param [String] source
-        #   String to identify the originator of this request.
-        # @param [String] volume_id
-        #   The volume to request concurrent/download restrictions for.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -814,7 +814,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def request_access(cpksver: nil, license_types: nil, locale: nil, nonce: nil, source: nil, volume_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def request_access(source, volume_id, nonce, cpksver, license_types: nil, locale: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'myconfig/requestAccess'
           command =  make_simple_command(:post, path, options)
           command.response_representation = Google::Apis::BooksV1::RequestAccess::Representation
@@ -832,18 +832,18 @@ module Google
         end
         
         # Request downloaded content access for specified volumes on the My eBooks shelf.
+        # @param [String] source
+        #   String to identify the originator of this request.
+        # @param [String] nonce
+        #   The client nonce value.
         # @param [String] cpksver
         #   The device/version ID from which to release the restriction.
         # @param [Array<String>, String] features
         #   List of features supported by the client, i.e., 'RENTALS'
         # @param [String] locale
         #   ISO-639-1, ISO-3166-1 codes for message localization, i.e. en_US.
-        # @param [String] nonce
-        #   The client nonce value.
         # @param [Boolean] show_preorders
         #   Set to true to show pre-ordered books. Defaults to false.
-        # @param [String] source
-        #   String to identify the originator of this request.
         # @param [Array<String>, String] volume_ids
         #   The volume(s) to request download restrictions for.
         # @param [String] fields
@@ -867,7 +867,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def sync_volume_licenses(cpksver: nil, features: nil, locale: nil, nonce: nil, show_preorders: nil, source: nil, volume_ids: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def sync_volume_licenses(source, nonce, cpksver, features: nil, locale: nil, show_preorders: nil, volume_ids: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'myconfig/syncVolumeLicenses'
           command =  make_simple_command(:post, path, options)
           command.response_representation = Google::Apis::BooksV1::Volumes::Representation
@@ -1098,7 +1098,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def summarize_my_library_annotation(layer_ids: nil, volume_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def summarize_my_library_annotation(layer_ids, volume_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'mylibrary/annotations/summary'
           command =  make_simple_command(:post, path, options)
           command.response_representation = Google::Apis::BooksV1::AnnotationsSummary::Representation
@@ -1156,12 +1156,12 @@ module Google
         # Adds a volume to a bookshelf.
         # @param [String] shelf
         #   ID of bookshelf to which to add a volume.
+        # @param [String] volume_id
+        #   ID of volume to add.
         # @param [String] reason
         #   The reason for which the book is added to the library.
         # @param [String] source
         #   String to identify the originator of this request.
-        # @param [String] volume_id
-        #   ID of volume to add.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1183,7 +1183,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def add_my_library_volume(shelf, reason: nil, source: nil, volume_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def add_my_library_volume(shelf, volume_id, reason: nil, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'mylibrary/bookshelves/{shelf}/addVolume'
           command =  make_simple_command(:post, path, options)
           command.params['shelf'] = shelf unless shelf.nil?
@@ -1312,13 +1312,13 @@ module Google
         # Moves a volume within a bookshelf.
         # @param [String] shelf
         #   ID of bookshelf with the volume.
-        # @param [String] source
-        #   String to identify the originator of this request.
         # @param [String] volume_id
         #   ID of volume to move.
         # @param [Fixnum] volume_position
         #   Position on shelf to move the item (0 puts the item before the current first
         #   item, 1 puts it between the first and the second and so on.)
+        # @param [String] source
+        #   String to identify the originator of this request.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1340,7 +1340,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def move_my_library_volume(shelf, source: nil, volume_id: nil, volume_position: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def move_my_library_volume(shelf, volume_id, volume_position, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'mylibrary/bookshelves/{shelf}/moveVolume'
           command =  make_simple_command(:post, path, options)
           command.params['shelf'] = shelf unless shelf.nil?
@@ -1356,12 +1356,12 @@ module Google
         # Removes a volume from a bookshelf.
         # @param [String] shelf
         #   ID of bookshelf from which to remove a volume.
+        # @param [String] volume_id
+        #   ID of volume to remove.
         # @param [String] reason
         #   The reason for which the book is removed from the library.
         # @param [String] source
         #   String to identify the originator of this request.
-        # @param [String] volume_id
-        #   ID of volume to remove.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1383,7 +1383,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def remove_my_library_volume(shelf, reason: nil, source: nil, volume_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def remove_my_library_volume(shelf, volume_id, reason: nil, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'mylibrary/bookshelves/{shelf}/removeVolume'
           command =  make_simple_command(:post, path, options)
           command.params['shelf'] = shelf unless shelf.nil?
@@ -1498,18 +1498,18 @@ module Google
         # Sets my reading position information for a volume.
         # @param [String] volume_id
         #   ID of volume for which to update the reading position.
+        # @param [String] timestamp
+        #   RFC 3339 UTC format timestamp associated with this reading position.
+        # @param [String] position
+        #   Position string for the new volume reading position.
         # @param [String] action
         #   Action that caused this reading position to be set.
         # @param [String] content_version
         #   Volume content version for which this reading position applies.
         # @param [String] device_cookie
         #   Random persistent device cookie optional on set position.
-        # @param [String] position
-        #   Position string for the new volume reading position.
         # @param [String] source
         #   String to identify the originator of this request.
-        # @param [String] timestamp
-        #   RFC 3339 UTC format timestamp associated with this reading position.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1531,7 +1531,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def set_my_library_reading_position(volume_id, action: nil, content_version: nil, device_cookie: nil, position: nil, source: nil, timestamp: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def set_my_library_reading_position(volume_id, timestamp, position, action: nil, content_version: nil, device_cookie: nil, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'mylibrary/readingpositions/{volumeId}/setPosition'
           command =  make_simple_command(:post, path, options)
           command.params['volumeId'] = volume_id unless volume_id.nil?
@@ -1840,6 +1840,8 @@ module Google
         end
         
         # Performs a book search.
+        # @param [String] q
+        #   Full-text search query string.
         # @param [String] download
         #   Restrict to volumes by download availability.
         # @param [String] filter
@@ -1858,8 +1860,6 @@ module Google
         #   Restrict to books or magazines.
         # @param [String] projection
         #   Restrict information returned to a set of selected fields.
-        # @param [String] q
-        #   Full-text search query string.
         # @param [Boolean] show_preorders
         #   Set to true to show books available for preorder. Defaults to false.
         # @param [String] source
@@ -1887,7 +1887,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_volumes(download: nil, filter: nil, lang_restrict: nil, library_restrict: nil, max_results: nil, order_by: nil, partner: nil, print_type: nil, projection: nil, q: nil, show_preorders: nil, source: nil, start_index: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_volumes(q, download: nil, filter: nil, lang_restrict: nil, library_restrict: nil, max_results: nil, order_by: nil, partner: nil, print_type: nil, projection: nil, show_preorders: nil, source: nil, start_index: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'volumes'
           command =  make_simple_command(:get, path, options)
           command.response_representation = Google::Apis::BooksV1::Volumes::Representation
@@ -2059,15 +2059,15 @@ module Google
         end
         
         # Rate a recommended book for the current user.
+        # @param [String] rating
+        #   Rating to be given to the volume.
+        # @param [String] volume_id
+        #   ID of the source volume.
         # @param [String] locale
         #   ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for
         #   generating recommendations.
-        # @param [String] rating
-        #   Rating to be given to the volume.
         # @param [String] source
         #   String to identify the originator of this request.
-        # @param [String] volume_id
-        #   ID of the source volume.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2089,7 +2089,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def rate_recommended_volume(locale: nil, rating: nil, source: nil, volume_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def rate_recommended_volume(rating, volume_id, locale: nil, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           path = 'volumes/recommended/rate'
           command =  make_simple_command(:post, path, options)
           command.response_representation = Google::Apis::BooksV1::RateRecommendedVolumeResponse::Representation

data/generated/google/apis/calendar_v3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/google-apps/calendar/firstapp
     module CalendarV3
       VERSION = 'V3'
-      REVISION = '20150701'
+      REVISION = '20150720'
 
       # Manage your calendars
       AUTH_CALENDAR = 'https://www.googleapis.com/auth/calendar'

data/generated/google/apis/calendar_v3/classes.rb

@@ -272,13 +272,17 @@ module Google
         attr_accessor :access_role
       
         # 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.
         # Corresponds to the JSON property `backgroundColor`
         # @return [String]
         attr_accessor :background_color
       
         # 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.
+        # 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.
         # Corresponds to the JSON property `colorId`
         # @return [String]
         attr_accessor :color_id
@@ -306,7 +310,9 @@ module Google
         attr_accessor :etag
       
         # The foreground color of the calendar in the hexadecimal format "#ffffff". 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.
         # Corresponds to the JSON property `foregroundColor`
         # @return [String]
         attr_accessor :foreground_color
@@ -420,7 +426,8 @@ module Google
         # 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.
+        # on inserts and updates. SMS reminders are only available for Google Apps for
+        # Work, Education, and Government customers.
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :delivery_method
@@ -554,15 +561,16 @@ module Google
       class Colors
         include Google::Apis::Core::Hashable
       
-        # 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.
         # Corresponds to the JSON property `calendar`
         # @return [Hash<String,Google::Apis::CalendarV3::ColorDefinition>]
         attr_accessor :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.
         # Corresponds to the JSON property `event`
         # @return [Hash<String,Google::Apis::CalendarV3::ColorDefinition>]
         attr_accessor :event
@@ -644,7 +652,8 @@ module Google
         # @return [Array<Google::Apis::CalendarV3::EventAttachment>]
         attr_accessor :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.
         # Corresponds to the JSON property `attendees`
         # @return [Array<Google::Apis::CalendarV3::EventAttendee>]
         attr_accessor :attendees
@@ -797,8 +806,11 @@ module Google
         attr_accessor :private_copy
         alias_method :private_copy?, :private_copy
       
-        # 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.
         # Corresponds to the JSON property `recurrence`
         # @return [Array<String>]
         attr_accessor :recurrence
@@ -819,9 +831,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :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.
         # Corresponds to the JSON property `source`
         # @return [Google::Apis::CalendarV3::Event::Source]
         attr_accessor :source
@@ -992,17 +1004,18 @@ module Google
           # @return [String]
           attr_accessor :display_mode
         
-          # The gadget's height in pixels. Optional.
+          # The gadget's height in pixels. The height must be an integer greater than 0.
+          # Optional.
           # Corresponds to the JSON property `height`
           # @return [Fixnum]
           attr_accessor :height
         
-          # The gadget's icon URL.
+          # The gadget's icon URL. The URL scheme must be HTTPS.
           # Corresponds to the JSON property `iconLink`
           # @return [String]
           attr_accessor :icon_link
         
-          # The gadget's URL.
+          # The gadget's URL. The URL scheme must be HTTPS.
           # Corresponds to the JSON property `link`
           # @return [String]
           attr_accessor :link
@@ -1022,7 +1035,8 @@ module Google
           # @return [String]
           attr_accessor :type
         
-          # The gadget's width in pixels. Optional.
+          # The gadget's width in pixels. The width must be an integer greater than 0.
+          # Optional.
           # Corresponds to the JSON property `width`
           # @return [Fixnum]
           attr_accessor :width
@@ -1092,7 +1106,7 @@ module Google
         
           # 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.
+          # this event. The maximum number of override reminders is 5.
           # Corresponds to the JSON property `overrides`
           # @return [Array<Google::Apis::CalendarV3::EventReminder>]
           attr_accessor :overrides
@@ -1114,9 +1128,9 @@ module Google
           end
         end
         
-        # 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 Source
           include Google::Apis::Core::Hashable
         
@@ -1125,7 +1139,7 @@ module Google
           # @return [String]
           attr_accessor :title
         
-          # URL of the source pointing to a resource. URL's protocol must be HTTP or HTTPS.
+          # URL of the source pointing to a resource. The URL scheme must be HTTP or HTTPS.
           # Corresponds to the JSON property `url`
           # @return [String]
           attr_accessor :url
@@ -1147,7 +1161,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # ID of the attached file. Read-only.
-        # E.g. for Google Drive files this is the ID of the corresponding Files resource
+        # For Google Drive files, this is the ID of the corresponding Files resource
         # entry in the Drive API.
         # Corresponds to the JSON property `fileId`
         # @return [String]
@@ -1316,14 +1330,16 @@ module Google
       
         # 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.
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :reminder_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).
         # Corresponds to the JSON property `minutes`
         # @return [Fixnum]
         attr_accessor :minutes