google-apis-drive_v3 0.39.0 → 0.40.0

data/lib/google/apis/drive_v3/classes.rb

@@ -38,7 +38,7 @@ module Google
         attr_accessor :can_create_drives
         alias_method :can_create_drives?, :can_create_drives
       
-        # Deprecated - use canCreateDrives instead.
+        # Deprecated: Use `canCreateDrives` instead.
         # Corresponds to the JSON property `canCreateTeamDrives`
         # @return [Boolean]
         attr_accessor :can_create_team_drives
@@ -64,8 +64,8 @@ module Google
         # @return [Hash<String,Array<String>>]
         attr_accessor :import_formats
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#about"
-        # .
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # about"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -85,7 +85,7 @@ module Google
         # @return [Google::Apis::DriveV3::About::StorageQuota]
         attr_accessor :storage_quota
       
-        # Deprecated - use driveThemes instead.
+        # Deprecated: Use `driveThemes` instead.
         # Corresponds to the JSON property `teamDriveThemes`
         # @return [Array<Google::Apis::DriveV3::About::TeamDriveTheme>]
         attr_accessor :team_drive_themes
@@ -189,17 +189,17 @@ module Google
         class TeamDriveTheme
           include Google::Apis::Core::Hashable
         
-          # Deprecated - use driveThemes/backgroundImageLink instead.
+          # Deprecated: Use `driveThemes/backgroundImageLink` instead.
           # Corresponds to the JSON property `backgroundImageLink`
           # @return [String]
           attr_accessor :background_image_link
         
-          # Deprecated - use driveThemes/colorRgb instead.
+          # Deprecated: Use `driveThemes/colorRgb` instead.
           # Corresponds to the JSON property `colorRgb`
           # @return [String]
           attr_accessor :color_rgb
         
-          # Deprecated - use driveThemes/id instead.
+          # Deprecated: Use `driveThemes/id` instead.
           # Corresponds to the JSON property `id`
           # @return [String]
           attr_accessor :id
@@ -221,7 +221,7 @@ module Google
       class Change
         include Google::Apis::Core::Hashable
       
-        # The type of the change. Possible values are file and drive.
+        # The type of the change. Possible values are `file` and `drive`.
         # Corresponds to the JSON property `changeType`
         # @return [String]
         attr_accessor :change_type
@@ -246,8 +246,8 @@ module Google
         # @return [String]
         attr_accessor :file_id
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # change".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # change"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -264,7 +264,7 @@ module Google
         # @return [Google::Apis::DriveV3::TeamDrive]
         attr_accessor :team_drive
       
-        # Deprecated - use driveId instead.
+        # Deprecated: Use `driveId` instead.
         # Corresponds to the JSON property `teamDriveId`
         # @return [String]
         attr_accessor :team_drive_id
@@ -274,7 +274,7 @@ module Google
         # @return [DateTime]
         attr_accessor :time
       
-        # Deprecated - use changeType instead.
+        # Deprecated: Use `changeType` instead.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -309,8 +309,8 @@ module Google
         # @return [Array<Google::Apis::DriveV3::Change>]
         attr_accessor :changes
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # changeList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # changeList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -342,7 +342,7 @@ module Google
         end
       end
       
-      # An notification channel used to watch for resource changes.
+      # A notification channel used to watch for resource changes.
       class Channel
         include Google::Apis::Core::Hashable
       
@@ -363,7 +363,7 @@ module Google
         attr_accessor :id
       
         # Identifies this as a notification channel used to watch for changes to a
-        # resource, which is "api#channel".
+        # resource, which is `api#channel`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -396,9 +396,7 @@ module Google
         # @return [String]
         attr_accessor :token
       
-        # The type of delivery mechanism used for this channel. Valid values are "
-        # web_hook" (or "webhook"). Both values refer to a channel where Http requests
-        # are used to deliver messages.
+        # The type of delivery mechanism used for this channel.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -427,7 +425,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A region of the document represented as a JSON string. For details on defining
-        # anchor properties, refer to  Add comments and replies.
+        # anchor properties, refer to [Manage comments and replies](https://developers.
+        # google.com/drive/api/v3/manage-comments).
         # Corresponds to the JSON property `anchor`
         # @return [String]
         attr_accessor :anchor
@@ -438,7 +437,7 @@ module Google
         attr_accessor :author
       
         # The plain text content of the comment. This field is used for setting the
-        # content, while htmlContent should be displayed.
+        # content, while `htmlContent` should be displayed.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
@@ -448,24 +447,25 @@ module Google
         # @return [DateTime]
         attr_accessor :created_time
       
-        # Whether the comment has been deleted. A deleted comment has no content.
+        # Output only. Whether the comment has been deleted. A deleted comment has no
+        # content.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # The content of the comment with HTML formatting.
+        # Output only. The content of the comment with HTML formatting.
         # Corresponds to the JSON property `htmlContent`
         # @return [String]
         attr_accessor :html_content
       
-        # The ID of the comment.
+        # Output only. The ID of the comment.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # comment".
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # `"drive#comment"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -483,12 +483,12 @@ module Google
         # @return [Google::Apis::DriveV3::Comment::QuotedFileContent]
         attr_accessor :quoted_file_content
       
-        # The full list of replies to the comment in chronological order.
+        # Output only. The full list of replies to the comment in chronological order.
         # Corresponds to the JSON property `replies`
         # @return [Array<Google::Apis::DriveV3::Reply>]
         attr_accessor :replies
       
-        # Whether the comment has been resolved by one of its replies.
+        # Output only. Whether the comment has been resolved by one of its replies.
         # Corresponds to the JSON property `resolved`
         # @return [Boolean]
         attr_accessor :resolved
@@ -553,8 +553,8 @@ module Google
         # @return [Array<Google::Apis::DriveV3::Comment>]
         attr_accessor :comments
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # commentList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # commentList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -592,7 +592,7 @@ module Google
         alias_method :read_only?, :read_only
       
         # Reason for why the content of the file is restricted. This is only mutable on
-        # requests that also set readOnly=true.
+        # requests that also set `readOnly=true`.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -608,8 +608,8 @@ module Google
         # @return [DateTime]
         attr_accessor :restriction_time
       
-        # The type of the content restriction. Currently the only possible value is
-        # globalContentRestriction.
+        # Output only. The type of the content restriction. Currently the only possible
+        # value is `globalContentRestriction`.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -633,25 +633,25 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An image file and cropping parameters from which a background image for this
-        # shared drive is set. This is a write-only field; it can only be set on drive.
-        # drives.update requests that don't set themeId. When specified, all fields of
-        # the backgroundImageFile must be set.
+        # shared drive is set. This is a write only field; it can only be set on `drive.
+        # drives.update` requests that don't set `themeId`. When specified, all fields
+        # of the `backgroundImageFile` must be set.
         # Corresponds to the JSON property `backgroundImageFile`
         # @return [Google::Apis::DriveV3::Drive::BackgroundImageFile]
         attr_accessor :background_image_file
       
-        # A short-lived link to this shared drive's background image.
+        # Output only. A short-lived link to this shared drive's background image.
         # Corresponds to the JSON property `backgroundImageLink`
         # @return [String]
         attr_accessor :background_image_link
       
-        # Capabilities the current user has on this shared drive.
+        # Output only. Capabilities the current user has on this shared drive.
         # Corresponds to the JSON property `capabilities`
         # @return [Google::Apis::DriveV3::Drive::Capabilities]
         attr_accessor :capabilities
       
-        # The color of this shared drive as an RGB hex string. It can only be set on
-        # drive.drives.update requests that don't set themeId.
+        # The color of this shared drive as an RGB hex string. It can only be set on a `
+        # drive.drives.update` request that does not set `themeId`.
         # Corresponds to the JSON property `colorRgb`
         # @return [String]
         attr_accessor :color_rgb
@@ -667,14 +667,14 @@ module Google
         attr_accessor :hidden
         alias_method :hidden?, :hidden
       
-        # The ID of this shared drive which is also the ID of the top level folder of
-        # this shared drive.
+        # Output only. The ID of this shared drive which is also the ID of the top level
+        # folder of this shared drive.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#drive"
-        # .
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # `"drive#drive"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -684,8 +684,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The organizational unit of this shared drive. This field is only populated on
-        # drives.list responses when the useDomainAdminAccess parameter is set to true.
+        # Output only. The organizational unit of this shared drive. This field is only
+        # populated on `drives.list` responses when the `useDomainAdminAccess` parameter
+        # is set to `true`.
         # Corresponds to the JSON property `orgUnitId`
         # @return [String]
         attr_accessor :org_unit_id
@@ -696,11 +697,12 @@ module Google
         # @return [Google::Apis::DriveV3::Drive::Restrictions]
         attr_accessor :restrictions
       
-        # The ID of the theme from which the background image and color are set. The set
-        # of possible driveThemes can be retrieved from a drive.about.get response. When
-        # not specified on a drive.drives.create request, a random theme is chosen from
-        # which the background image and color are set. This is a write-only field; it
-        # can only be set on requests that don't set colorRgb or backgroundImageFile.
+        # The ID of the theme from which the background image and color will be set. The
+        # set of possible `driveThemes` can be retrieved from a `drive.about.get`
+        # response. When not specified on a `drive.drives.create` request, a random
+        # theme is chosen from which the background image and color are set. This is a
+        # write-only field; it can only be set on requests that don't set `colorRgb` or `
+        # backgroundImageFile`.
         # Corresponds to the JSON property `themeId`
         # @return [String]
         attr_accessor :theme_id
@@ -726,9 +728,9 @@ module Google
         end
         
         # An image file and cropping parameters from which a background image for this
-        # shared drive is set. This is a write-only field; it can only be set on drive.
-        # drives.update requests that don't set themeId. When specified, all fields of
-        # the backgroundImageFile must be set.
+        # shared drive is set. This is a write only field; it can only be set on `drive.
+        # drives.update` requests that don't set `themeId`. When specified, all fields
+        # of the `backgroundImageFile` must be set.
         class BackgroundImageFile
           include Google::Apis::Core::Hashable
         
@@ -775,133 +777,142 @@ module Google
           end
         end
         
-        # Capabilities the current user has on this shared drive.
+        # Output only. Capabilities the current user has on this shared drive.
         class Capabilities
           include Google::Apis::Core::Hashable
         
-          # Whether the current user can add children to folders in this shared drive.
+          # Output only. Whether the current user can add children to folders in this
+          # shared drive.
           # Corresponds to the JSON property `canAddChildren`
           # @return [Boolean]
           attr_accessor :can_add_children
           alias_method :can_add_children?, :can_add_children
         
-          # Whether the current user can change the copyRequiresWriterPermission
-          # restriction of this shared drive.
+          # Output only. Whether the current user can change the `
+          # copyRequiresWriterPermission` restriction of this shared drive.
           # Corresponds to the JSON property `canChangeCopyRequiresWriterPermissionRestriction`
           # @return [Boolean]
           attr_accessor :can_change_copy_requires_writer_permission_restriction
           alias_method :can_change_copy_requires_writer_permission_restriction?, :can_change_copy_requires_writer_permission_restriction
         
-          # Whether the current user can change the domainUsersOnly restriction of this
-          # shared drive.
+          # Output only. Whether the current user can change the `domainUsersOnly`
+          # restriction of this shared drive.
           # Corresponds to the JSON property `canChangeDomainUsersOnlyRestriction`
           # @return [Boolean]
           attr_accessor :can_change_domain_users_only_restriction
           alias_method :can_change_domain_users_only_restriction?, :can_change_domain_users_only_restriction
         
-          # Whether the current user can change the background of this shared drive.
+          # Output only. Whether the current user can change the background of this shared
+          # drive.
           # Corresponds to the JSON property `canChangeDriveBackground`
           # @return [Boolean]
           attr_accessor :can_change_drive_background
           alias_method :can_change_drive_background?, :can_change_drive_background
         
-          # Whether the current user can change the driveMembersOnly restriction of this
-          # shared drive.
+          # Output only. Whether the current user can change the `driveMembersOnly`
+          # restriction of this shared drive.
           # Corresponds to the JSON property `canChangeDriveMembersOnlyRestriction`
           # @return [Boolean]
           attr_accessor :can_change_drive_members_only_restriction
           alias_method :can_change_drive_members_only_restriction?, :can_change_drive_members_only_restriction
         
-          # Whether the current user can change the
-          # sharingFoldersRequiresOrganizerPermission restriction of this shared drive.
+          # Output only. Whether the current user can change the `
+          # sharingFoldersRequiresOrganizerPermission` restriction of this shared drive.
           # Corresponds to the JSON property `canChangeSharingFoldersRequiresOrganizerPermissionRestriction`
           # @return [Boolean]
           attr_accessor :can_change_sharing_folders_requires_organizer_permission_restriction
           alias_method :can_change_sharing_folders_requires_organizer_permission_restriction?, :can_change_sharing_folders_requires_organizer_permission_restriction
         
-          # Whether the current user can comment on files in this shared drive.
+          # Output only. Whether the current user can comment on files in this shared
+          # drive.
           # Corresponds to the JSON property `canComment`
           # @return [Boolean]
           attr_accessor :can_comment
           alias_method :can_comment?, :can_comment
         
-          # Whether the current user can copy files in this shared drive.
+          # Output only. Whether the current user can copy files in this shared drive.
           # Corresponds to the JSON property `canCopy`
           # @return [Boolean]
           attr_accessor :can_copy
           alias_method :can_copy?, :can_copy
         
-          # Whether the current user can delete children from folders in this shared drive.
+          # Output only. Whether the current user can delete children from folders in this
+          # shared drive.
           # Corresponds to the JSON property `canDeleteChildren`
           # @return [Boolean]
           attr_accessor :can_delete_children
           alias_method :can_delete_children?, :can_delete_children
         
-          # Whether the current user can delete this shared drive. Attempting to delete
-          # the shared drive may still fail if there are untrashed items inside the shared
-          # drive.
+          # Output only. Whether the current user can delete this shared drive. Attempting
+          # to delete the shared drive may still fail if there are untrashed items inside
+          # the shared drive.
           # Corresponds to the JSON property `canDeleteDrive`
           # @return [Boolean]
           attr_accessor :can_delete_drive
           alias_method :can_delete_drive?, :can_delete_drive
         
-          # Whether the current user can download files in this shared drive.
+          # Output only. Whether the current user can download files in this shared drive.
           # Corresponds to the JSON property `canDownload`
           # @return [Boolean]
           attr_accessor :can_download
           alias_method :can_download?, :can_download
         
-          # Whether the current user can edit files in this shared drive
+          # Output only. Whether the current user can edit files in this shared drive
           # Corresponds to the JSON property `canEdit`
           # @return [Boolean]
           attr_accessor :can_edit
           alias_method :can_edit?, :can_edit
         
-          # Whether the current user can list the children of folders in this shared drive.
+          # Output only. Whether the current user can list the children of folders in this
+          # shared drive.
           # Corresponds to the JSON property `canListChildren`
           # @return [Boolean]
           attr_accessor :can_list_children
           alias_method :can_list_children?, :can_list_children
         
-          # Whether the current user can add members to this shared drive or remove them
-          # or change their role.
+          # Output only. Whether the current user can add members to this shared drive or
+          # remove them or change their role.
           # Corresponds to the JSON property `canManageMembers`
           # @return [Boolean]
           attr_accessor :can_manage_members
           alias_method :can_manage_members?, :can_manage_members
         
-          # Whether the current user can read the revisions resource of files in this
-          # shared drive.
+          # Output only. Whether the current user can read the revisions resource of files
+          # in this shared drive.
           # Corresponds to the JSON property `canReadRevisions`
           # @return [Boolean]
           attr_accessor :can_read_revisions
           alias_method :can_read_revisions?, :can_read_revisions
         
-          # Whether the current user can rename files or folders in this shared drive.
+          # Output only. Whether the current user can rename files or folders in this
+          # shared drive.
           # Corresponds to the JSON property `canRename`
           # @return [Boolean]
           attr_accessor :can_rename
           alias_method :can_rename?, :can_rename
         
-          # Whether the current user can rename this shared drive.
+          # Output only. Whether the current user can rename this shared drive.
           # Corresponds to the JSON property `canRenameDrive`
           # @return [Boolean]
           attr_accessor :can_rename_drive
           alias_method :can_rename_drive?, :can_rename_drive
         
-          # Whether the current user can reset the shared drive restrictions to defaults.
+          # Output only. Whether the current user can reset the shared drive restrictions
+          # to defaults.
           # Corresponds to the JSON property `canResetDriveRestrictions`
           # @return [Boolean]
           attr_accessor :can_reset_drive_restrictions
           alias_method :can_reset_drive_restrictions?, :can_reset_drive_restrictions
         
-          # Whether the current user can share files or folders in this shared drive.
+          # Output only. Whether the current user can share files or folders in this
+          # shared drive.
           # Corresponds to the JSON property `canShare`
           # @return [Boolean]
           attr_accessor :can_share
           alias_method :can_share?, :can_share
         
-          # Whether the current user can trash children from folders in this shared drive.
+          # Output only. Whether the current user can trash children from folders in this
+          # shared drive.
           # Corresponds to the JSON property `canTrashChildren`
           # @return [Boolean]
           attr_accessor :can_trash_children
@@ -950,7 +961,7 @@ module Google
         
           # Whether the options to copy, print, or download files inside this shared drive,
           # should be disabled for readers and commenters. When this restriction is set
-          # to true, it will override the similarly named field to true for any file
+          # to `true`, it will override the similarly named field to `true` for any file
           # inside this shared drive.
           # Corresponds to the JSON property `copyRequiresWriterPermission`
           # @return [Boolean]
@@ -1004,8 +1015,8 @@ module Google
         # @return [Array<Google::Apis::DriveV3::Drive>]
         attr_accessor :drives
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # driveList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # driveList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1034,18 +1045,18 @@ module Google
       class File
         include Google::Apis::Core::Hashable
       
-        # A collection of arbitrary key-value pairs that are private to the requesting
+        # A collection of arbitrary key-value pairs which are private to the requesting
         # app.
         # Entries with null values are cleared in update and copy requests. These
         # properties can only be retrieved using an authenticated request. An
-        # authenticated request uses an access token obtained with an OAuth 2 client ID.
+        # authenticated request uses an access token obtained with a OAuth 2 client ID.
         # You cannot use an API key to retrieve private properties.
         # Corresponds to the JSON property `appProperties`
         # @return [Hash<String,String>]
         attr_accessor :app_properties
       
-        # Capabilities the current user has on this file. Each capability corresponds to
-        # a fine-grained action that a user can take.
+        # Output only. Capabilities the current user has on this file. Each capability
+        # corresponds to a fine-grained action that a user may take.
         # Corresponds to the JSON property `capabilities`
         # @return [Google::Apis::DriveV3::File::Capabilities]
         attr_accessor :capabilities
@@ -1079,70 +1090,69 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # ID of the shared drive the file resides in. Only populated for items in shared
-        # drives.
+        # Output only. ID of the shared drive the file resides in. Only populated for
+        # items in shared drives.
         # Corresponds to the JSON property `driveId`
         # @return [String]
         attr_accessor :drive_id
       
-        # Whether the file has been explicitly trashed, as opposed to recursively
-        # trashed from a parent folder.
+        # Output only. Whether the file has been explicitly trashed, as opposed to
+        # recursively trashed from a parent folder.
         # Corresponds to the JSON property `explicitlyTrashed`
         # @return [Boolean]
         attr_accessor :explicitly_trashed
         alias_method :explicitly_trashed?, :explicitly_trashed
       
-        # Links for exporting Docs Editors files to specific formats.
+        # Output only. Links for exporting Docs Editors files to specific formats.
         # Corresponds to the JSON property `exportLinks`
         # @return [Hash<String,String>]
         attr_accessor :export_links
       
-        # The final component of fullFileExtension. This is only available for files
-        # with binary content in Google Drive.
+        # Output only. The final component of `fullFileExtension`. This is only
+        # available for files with binary content in Google Drive.
         # Corresponds to the JSON property `fileExtension`
         # @return [String]
         attr_accessor :file_extension
       
-        # The color for a folder or shortcut to a folder as an RGB hex string. The
-        # supported colors are published in the folderColorPalette field of the About
-        # resource.
-        # If an unsupported color is specified, the closest color in the palette will be
-        # used instead.
+        # The color for a folder or a shortcut to a folder as an RGB hex string. The
+        # supported colors are published in the `folderColorPalette` field of the About
+        # resource. If an unsupported color is specified, the closest color in the
+        # palette is used instead.
         # Corresponds to the JSON property `folderColorRgb`
         # @return [String]
         attr_accessor :folder_color_rgb
       
-        # The full file extension extracted from the name field. Can contain multiple
-        # concatenated extensions, such as "tar.gz". This is only available for files
-        # with binary content in Google Drive.
-        # This is automatically updated when the name field changes, however it's not
-        # cleared if the new name does not contain a valid extension.
+        # Output only. The full file extension extracted from the `name` field. May
+        # contain multiple concatenated extensions, such as "tar.gz". This is only
+        # available for files with binary content in Google Drive. This is automatically
+        # updated when the `name` field changes, however it is not cleared if the new
+        # name does not contain a valid extension.
         # Corresponds to the JSON property `fullFileExtension`
         # @return [String]
         attr_accessor :full_file_extension
       
-        # Whether there are permissions directly on this file. This field is only
-        # populated for items in shared drives.
+        # Output only. Whether there are permissions directly on this file. This field
+        # is only populated for items in shared drives.
         # Corresponds to the JSON property `hasAugmentedPermissions`
         # @return [Boolean]
         attr_accessor :has_augmented_permissions
         alias_method :has_augmented_permissions?, :has_augmented_permissions
       
-        # Whether this file has a thumbnail. This does not indicate whether the
-        # requesting app has access to the thumbnail. To check access, look for the
+        # Output only. Whether this file has a thumbnail. This does not indicate whether
+        # the requesting app has access to the thumbnail. To check access, look for the
         # presence of the thumbnailLink field.
         # Corresponds to the JSON property `hasThumbnail`
         # @return [Boolean]
         attr_accessor :has_thumbnail
         alias_method :has_thumbnail?, :has_thumbnail
       
-        # The ID of the file's head revision. This is only available for files with
-        # binary content in Google Drive.
+        # Output only. The ID of the file's head revision. This is currently only
+        # available for files with binary content in Google Drive.
         # Corresponds to the JSON property `headRevisionId`
         # @return [String]
         attr_accessor :head_revision_id
       
-        # A static, unauthenticated link to the file's icon.
+        # Output only. A static, unauthenticated link to the file's icon.
         # Corresponds to the JSON property `iconLink`
         # @return [String]
         attr_accessor :icon_link
@@ -1152,23 +1162,24 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Additional metadata about image media, if available.
+        # Output only. Additional metadata about image media, if available.
         # Corresponds to the JSON property `imageMediaMetadata`
         # @return [Google::Apis::DriveV3::File::ImageMediaMetadata]
         attr_accessor :image_media_metadata
       
-        # Whether the requesting app created or opened the file.
+        # Output only. Whether the file was created or opened by the requesting app.
         # Corresponds to the JSON property `isAppAuthorized`
         # @return [Boolean]
         attr_accessor :is_app_authorized
         alias_method :is_app_authorized?, :is_app_authorized
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#file".
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # `"drive#file"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # An overview of the labels on the file.
+        # Output only. An overview of the labels on the file.
         # Corresponds to the JSON property `labelInfo`
         # @return [Google::Apis::DriveV3::File::LabelInfo]
         attr_accessor :label_info
@@ -1184,119 +1195,119 @@ module Google
         # @return [Google::Apis::DriveV3::File::LinkShareMetadata]
         attr_accessor :link_share_metadata
       
-        # The MD5 checksum for the content of the file. This is only applicable to files
-        # with binary content in Google Drive.
+        # Output only. The MD5 checksum for the content of the file. This is only
+        # applicable to files with binary content in Google Drive.
         # Corresponds to the JSON property `md5Checksum`
         # @return [String]
         attr_accessor :md5_checksum
       
-        # The MIME type of the file.
-        # Google Drive will attempt to automatically detect an appropriate value from
-        # uploaded content if no value is provided. The value cannot be changed unless a
-        # new revision is uploaded.
-        # If a file is created with a Google Doc MIME type, the uploaded content will be
-        # imported if possible. The supported import formats are published in the About
-        # resource.
+        # The MIME type of the file. Google Drive attempts to automatically detect an
+        # appropriate value from uploaded content, if no value is provided. The value
+        # cannot be changed unless a new revision is uploaded. If a file is created with
+        # a Google Doc MIME type, the uploaded content is imported, if possible. The
+        # supported import formats are published in the About resource.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
       
-        # Whether this user has modified the file.
+        # Output only. Whether the file has been modified by this user.
         # Corresponds to the JSON property `modifiedByMe`
         # @return [Boolean]
         attr_accessor :modified_by_me
         alias_method :modified_by_me?, :modified_by_me
       
-        # The last time the user modified the file (RFC 3339 date-time).
+        # The last time the file was modified by the user (RFC 3339 date-time).
         # Corresponds to the JSON property `modifiedByMeTime`
         # @return [DateTime]
         attr_accessor :modified_by_me_time
       
-        # The last time anyone modified the file (RFC 3339 date-time).
-        # Note that setting modifiedTime will also update modifiedByMeTime for the user.
+        # he last time the file was modified by anyone (RFC 3339 date-time). Note that
+        # setting modifiedTime will also update modifiedByMeTime for the user.
         # Corresponds to the JSON property `modifiedTime`
         # @return [DateTime]
         attr_accessor :modified_time
       
-        # The name of the file. This isn't necessarily unique within a folder. Note that
-        # for immutable items such as the top-level folders of shared drives, My Drive
-        # root folder, and Application Data folder the name is constant.
+        # The name of the file. This is not necessarily unique within a folder. Note
+        # that for immutable items such as the top level folders of shared drives, My
+        # Drive root folder, and Application Data folder the name is constant.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # The original filename of the uploaded content if available, or else the
-        # original value of the name field. This is only available for files with binary
-        # content in Google Drive.
+        # original value of the `name` field. This is only available for files with
+        # binary content in Google Drive.
         # Corresponds to the JSON property `originalFilename`
         # @return [String]
         attr_accessor :original_filename
       
-        # Whether the user owns the file. Not populated for items in shared drives.
+        # Output only. Whether the user owns the file. Not populated for items in shared
+        # drives.
         # Corresponds to the JSON property `ownedByMe`
         # @return [Boolean]
         attr_accessor :owned_by_me
         alias_method :owned_by_me?, :owned_by_me
       
-        # The owner of this file. Only certain legacy files might have more than one
-        # owner. This field isn't populated for items in shared drives.
+        # Output only. The owner of this file. Only certain legacy files may have more
+        # than one owner. This field isn't populated for items in shared drives.
         # Corresponds to the JSON property `owners`
         # @return [Array<Google::Apis::DriveV3::User>]
         attr_accessor :owners
       
-        # The IDs of the parent folders that contain the file.
-        # If not specified as part of a create request, the file will be placed directly
-        # in the user's My Drive folder. If not specified as part of a copy request, the
-        # file will inherit any discoverable parents of the source file. Update requests
-        # must use the addParents and removeParents parameters to modify the parents
-        # list.
+        # The IDs of the parent folders which contain the file. If not specified as part
+        # of a create request, the file is placed directly in the user's My Drive folder.
+        # If not specified as part of a copy request, the file inherits any
+        # discoverable parents of the source file. Update requests must use the `
+        # addParents` and `removeParents` parameters to modify the parents list.
         # Corresponds to the JSON property `parents`
         # @return [Array<String>]
         attr_accessor :parents
       
-        # List of permission IDs for users with access to this file.
+        # Output only. List of permission IDs for users with access to this file.
         # Corresponds to the JSON property `permissionIds`
         # @return [Array<String>]
         attr_accessor :permission_ids
       
-        # The full list of permissions for the file. This is only available if the
-        # requesting user can share the file. Not populated for items in shared drives.
+        # Output only. The full list of permissions for the file. This is only available
+        # if the requesting user can share the file. Not populated for items in shared
+        # drives.
         # Corresponds to the JSON property `permissions`
         # @return [Array<Google::Apis::DriveV3::Permission>]
         attr_accessor :permissions
       
-        # A collection of arbitrary key-value pairs that are visible to all apps.
+        # A collection of arbitrary key-value pairs which are visible to all apps.
         # Entries with null values are cleared in update and copy requests.
         # Corresponds to the JSON property `properties`
         # @return [Hash<String,String>]
         attr_accessor :properties
       
-        # The number of storage quota bytes used by the file. This includes the head
-        # revision as well as previous revisions with keepForever enabled.
+        # Output only. The number of storage quota bytes used by the file. This includes
+        # the head revision as well as previous revisions with `keepForever` enabled.
         # Corresponds to the JSON property `quotaBytesUsed`
         # @return [Fixnum]
         attr_accessor :quota_bytes_used
       
-        # A key needed to access the item via a shared link.
+        # Output only. A key needed to access the item via a shared link.
         # Corresponds to the JSON property `resourceKey`
         # @return [String]
         attr_accessor :resource_key
       
-        # The SHA1 checksum associated with this file, if available. This field is only
-        # populated for files with content stored in Google Drive; it's not populated
-        # for Docs Editors or shortcut files.
+        # Output only. The SHA1 checksum associated with this file, if available. This
+        # field is only populated for files with content stored in Google Drive; it is
+        # not populated for Docs Editors or shortcut files.
         # Corresponds to the JSON property `sha1Checksum`
         # @return [String]
         attr_accessor :sha1_checksum
       
-        # The SHA256 checksum associated with this file, if available. This field is
-        # only populated for files with content stored in Google Drive; it's not
-        # populated for Docs Editors or shortcut files.
+        # Output only. The SHA256 checksum associated with this file, if available. This
+        # field is only populated for files with content stored in Google Drive; it is
+        # not populated for Docs Editors or shortcut files.
         # Corresponds to the JSON property `sha256Checksum`
         # @return [String]
         attr_accessor :sha256_checksum
       
-        # Whether the file has been shared. Not populated for items in shared drives.
+        # Output only. Whether the file has been shared. Not populated for items in
+        # shared drives.
         # Corresponds to the JSON property `shared`
         # @return [Boolean]
         attr_accessor :shared
@@ -1314,20 +1325,19 @@ module Google
         attr_accessor :sharing_user
       
         # Shortcut file details. Only populated for shortcut files, which have the
-        # mimeType field set to application/vnd.google-apps.shortcut.
+        # mimeType field set to `application/vnd.google-apps.shortcut`.
         # Corresponds to the JSON property `shortcutDetails`
         # @return [Google::Apis::DriveV3::File::ShortcutDetails]
         attr_accessor :shortcut_details
       
-        # The size of the file's content in bytes. This field is populated for files
-        # with binary content stored in Google Drive and for Docs Editors files; it's
-        # not populated for shortcuts or folders.
+        # Output only. Size in bytes of blobs and first party editor files. Won't be
+        # populated for files that have no size, like shortcuts and folders.
         # Corresponds to the JSON property `size`
         # @return [Fixnum]
         attr_accessor :size
       
-        # The list of spaces that contain the file. The currently supported values are '
-        # drive', 'appDataFolder' and 'photos'.
+        # Output only. The list of spaces which contain the file. The currently
+        # supported values are 'drive', 'appDataFolder' and 'photos'.
         # Corresponds to the JSON property `spaces`
         # @return [Array<String>]
         attr_accessor :spaces
@@ -1338,29 +1348,26 @@ module Google
         attr_accessor :starred
         alias_method :starred?, :starred
       
-        # Deprecated - use driveId instead.
+        # Deprecated: Output only. Use `driveId` instead.
         # Corresponds to the JSON property `teamDriveId`
         # @return [String]
         attr_accessor :team_drive_id
       
-        # A short-lived link to the file's thumbnail, if available. Typically lasts on
-        # the order of hours. Only populated when the requesting app can access the file'
-        # s content. If the file isn't shared publicly, the URL returned in Files.
-        # thumbnailLink must be fetched using a credentialed request.
+        # Output only. A short-lived link to the file's thumbnail, if available.
+        # Typically lasts on the order of hours. Only populated when the requesting app
+        # can access the file's content.
         # Corresponds to the JSON property `thumbnailLink`
         # @return [String]
         attr_accessor :thumbnail_link
       
-        # The thumbnail version for use in thumbnail cache invalidation.
+        # Output only. The thumbnail version for use in thumbnail cache invalidation.
         # Corresponds to the JSON property `thumbnailVersion`
         # @return [Fixnum]
         attr_accessor :thumbnail_version
       
         # Whether the file has been trashed, either explicitly or from a trashed parent
-        # folder. Only the owner can trash a file. The trashed item is excluded from all
-        # files.list responses returned for any user who does not own the file. However,
-        # all users with access to the file can see the trashed item metadata in an API
-        # response. All users with access can copy, download, export, and share the file.
+        # folder. Only the owner may trash a file, and other users cannot see files in
+        # the owner's trash.
         # Corresponds to the JSON property `trashed`
         # @return [Boolean]
         attr_accessor :trashed
@@ -1377,47 +1384,49 @@ module Google
         # @return [Google::Apis::DriveV3::User]
         attr_accessor :trashing_user
       
-        # A monotonically increasing version number for the file. This reflects every
-        # change made to the file on the server, even those not visible to the user.
+        # Output only. A monotonically increasing version number for the file. This
+        # reflects every change made to the file on the server, even those not visible
+        # to the user.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
       
-        # Additional metadata about video media. This might not be available immediately
-        # upon upload.
+        # Output only. Additional metadata about video media. This may not be available
+        # immediately upon upload.
         # Corresponds to the JSON property `videoMediaMetadata`
         # @return [Google::Apis::DriveV3::File::VideoMediaMetadata]
         attr_accessor :video_media_metadata
       
-        # Whether this user has viewed the file.
+        # Output only. Whether the file has been viewed by this user.
         # Corresponds to the JSON property `viewedByMe`
         # @return [Boolean]
         attr_accessor :viewed_by_me
         alias_method :viewed_by_me?, :viewed_by_me
       
-        # The last time the user viewed the file (RFC 3339 date-time).
+        # The last time the file was viewed by the user (RFC 3339 date-time).
         # Corresponds to the JSON property `viewedByMeTime`
         # @return [DateTime]
         attr_accessor :viewed_by_me_time
       
-        # Deprecated - use copyRequiresWriterPermission instead.
+        # Deprecated: Use `copyRequiresWriterPermission` instead.
         # Corresponds to the JSON property `viewersCanCopyContent`
         # @return [Boolean]
         attr_accessor :viewers_can_copy_content
         alias_method :viewers_can_copy_content?, :viewers_can_copy_content
       
-        # A link for downloading the content of the file in a browser. This is only
-        # available for files with binary content in Google Drive.
+        # Output only. A link for downloading the content of the file in a browser. This
+        # is only available for files with binary content in Google Drive.
         # Corresponds to the JSON property `webContentLink`
         # @return [String]
         attr_accessor :web_content_link
       
-        # A link for opening the file in a relevant Google editor or viewer in a browser.
+        # Output only. A link for opening the file in a relevant Google editor or viewer
+        # in a browser.
         # Corresponds to the JSON property `webViewLink`
         # @return [String]
         attr_accessor :web_view_link
       
-        # Whether users with only writer permission can modify the file's permissions.
+        # Whether users with only `writer` permission can modify the file's permissions.
         # Not populated for items in shared drives.
         # Corresponds to the JSON property `writersCanShare`
         # @return [Boolean]
@@ -1494,264 +1503,270 @@ module Google
           @writers_can_share = args[:writers_can_share] if args.key?(:writers_can_share)
         end
         
-        # Capabilities the current user has on this file. Each capability corresponds to
-        # a fine-grained action that a user can take.
+        # Output only. Capabilities the current user has on this file. Each capability
+        # corresponds to a fine-grained action that a user may take.
         class Capabilities
           include Google::Apis::Core::Hashable
         
-          # Whether the current user is the pending owner of the file. Not populated for
-          # shared drive files.
+          # Output only. Whether the current user is the pending owner of the file. Not
+          # populated for shared drive files.
           # Corresponds to the JSON property `canAcceptOwnership`
           # @return [Boolean]
           attr_accessor :can_accept_ownership
           alias_method :can_accept_ownership?, :can_accept_ownership
         
-          # Whether the current user can add children to this folder. This is always false
-          # when the item isn't a folder.
+          # Output only. Whether the current user can add children to this folder. This is
+          # always false when the item is not a folder.
           # Corresponds to the JSON property `canAddChildren`
           # @return [Boolean]
           attr_accessor :can_add_children
           alias_method :can_add_children?, :can_add_children
         
-          # Whether the current user can add a folder from another drive (different shared
-          # drive or My Drive) to this folder. This is false when the item isn't a folder.
-          # Only populated for items in shared drives.
+          # Output only. Whether the current user can add a folder from another drive (
+          # different shared drive or My Drive) to this folder. This is false when the
+          # item is not a folder. Only populated for items in shared drives.
           # Corresponds to the JSON property `canAddFolderFromAnotherDrive`
           # @return [Boolean]
           attr_accessor :can_add_folder_from_another_drive
           alias_method :can_add_folder_from_another_drive?, :can_add_folder_from_another_drive
         
-          # Whether the current user can add a parent for the item without removing an
-          # existing parent in the same request. Not populated for shared drive files.
+          # Output only. Whether the current user can add a parent for the item without
+          # removing an existing parent in the same request. Not populated for shared
+          # drive files.
           # Corresponds to the JSON property `canAddMyDriveParent`
           # @return [Boolean]
           attr_accessor :can_add_my_drive_parent
           alias_method :can_add_my_drive_parent?, :can_add_my_drive_parent
         
-          # Whether the current user can change the copyRequiresWriterPermission
-          # restriction of this file.
+          # Output only. Whether the current user can change the `
+          # copyRequiresWriterPermission` restriction of this file.
           # Corresponds to the JSON property `canChangeCopyRequiresWriterPermission`
           # @return [Boolean]
           attr_accessor :can_change_copy_requires_writer_permission
           alias_method :can_change_copy_requires_writer_permission?, :can_change_copy_requires_writer_permission
         
-          # Whether the current user can change the securityUpdateEnabled field on link
-          # share metadata.
+          # Output only. Whether the current user can change the securityUpdateEnabled
+          # field on link share metadata.
           # Corresponds to the JSON property `canChangeSecurityUpdateEnabled`
           # @return [Boolean]
           attr_accessor :can_change_security_update_enabled
           alias_method :can_change_security_update_enabled?, :can_change_security_update_enabled
         
-          # Deprecated
+          # Deprecated: Output only.
           # Corresponds to the JSON property `canChangeViewersCanCopyContent`
           # @return [Boolean]
           attr_accessor :can_change_viewers_can_copy_content
           alias_method :can_change_viewers_can_copy_content?, :can_change_viewers_can_copy_content
         
-          # Whether the current user can comment on this file.
+          # Output only. Whether the current user can comment on this file.
           # Corresponds to the JSON property `canComment`
           # @return [Boolean]
           attr_accessor :can_comment
           alias_method :can_comment?, :can_comment
         
-          # Whether the current user can copy this file. For an item in a shared drive,
-          # whether the current user can copy non-folder descendants of this item, or this
-          # item itself if it's not a folder.
+          # Output only. Whether the current user can copy this file. For an item in a
+          # shared drive, whether the current user can copy non-folder descendants of this
+          # item, or this item itself if it is not a folder.
           # Corresponds to the JSON property `canCopy`
           # @return [Boolean]
           attr_accessor :can_copy
           alias_method :can_copy?, :can_copy
         
-          # Whether the current user can delete this file.
+          # Output only. Whether the current user can delete this file.
           # Corresponds to the JSON property `canDelete`
           # @return [Boolean]
           attr_accessor :can_delete
           alias_method :can_delete?, :can_delete
         
-          # Whether the current user can delete children of this folder. This is false
-          # when the item isn't a folder. Only populated for items in shared drives.
+          # Output only. Whether the current user can delete children of this folder. This
+          # is false when the item is not a folder. Only populated for items in shared
+          # drives.
           # Corresponds to the JSON property `canDeleteChildren`
           # @return [Boolean]
           attr_accessor :can_delete_children
           alias_method :can_delete_children?, :can_delete_children
         
-          # Whether the current user can download this file.
+          # Output only. Whether the current user can download this file.
           # Corresponds to the JSON property `canDownload`
           # @return [Boolean]
           attr_accessor :can_download
           alias_method :can_download?, :can_download
         
-          # Whether the current user can edit this file. Other factors might limit the
-          # type of changes a user can make to a file. For example, see
-          # canChangeCopyRequiresWriterPermission or canModifyContent.
+          # Output only. Whether the current user can edit this file. Other factors may
+          # limit the type of changes a user can make to a file. For example, see `
+          # canChangeCopyRequiresWriterPermission` or `canModifyContent`.
           # Corresponds to the JSON property `canEdit`
           # @return [Boolean]
           attr_accessor :can_edit
           alias_method :can_edit?, :can_edit
         
-          # Whether the current user can list the children of this folder. This is always
-          # false when the item isn't a folder.
+          # Output only. Whether the current user can list the children of this folder.
+          # This is always false when the item is not a folder.
           # Corresponds to the JSON property `canListChildren`
           # @return [Boolean]
           attr_accessor :can_list_children
           alias_method :can_list_children?, :can_list_children
         
-          # Whether the current user can modify the content of this file.
+          # Output only. Whether the current user can modify the content of this file.
           # Corresponds to the JSON property `canModifyContent`
           # @return [Boolean]
           attr_accessor :can_modify_content
           alias_method :can_modify_content?, :can_modify_content
         
-          # Whether the current user can modify restrictions on content of this file.
+          # Output only. Whether the current user can modify restrictions on content of
+          # this file.
           # Corresponds to the JSON property `canModifyContentRestriction`
           # @return [Boolean]
           attr_accessor :can_modify_content_restriction
           alias_method :can_modify_content_restriction?, :can_modify_content_restriction
         
-          # Whether the current user can modify the labels on this file.
+          # Output only. Whether the current user can modify the labels on the file.
           # Corresponds to the JSON property `canModifyLabels`
           # @return [Boolean]
           attr_accessor :can_modify_labels
           alias_method :can_modify_labels?, :can_modify_labels
         
-          # Whether the current user can move children of this folder outside of the
-          # shared drive. This is false when the item isn't a folder. Only populated for
-          # items in shared drives.
+          # Output only. Whether the current user can move children of this folder outside
+          # of the shared drive. This is false when the item is not a folder. Only
+          # populated for items in shared drives.
           # Corresponds to the JSON property `canMoveChildrenOutOfDrive`
           # @return [Boolean]
           attr_accessor :can_move_children_out_of_drive
           alias_method :can_move_children_out_of_drive?, :can_move_children_out_of_drive
         
-          # Deprecated - use canMoveChildrenOutOfDrive instead.
+          # Deprecated: Output only. Use `canMoveChildrenOutOfDrive` instead.
           # Corresponds to the JSON property `canMoveChildrenOutOfTeamDrive`
           # @return [Boolean]
           attr_accessor :can_move_children_out_of_team_drive
           alias_method :can_move_children_out_of_team_drive?, :can_move_children_out_of_team_drive
         
-          # Whether the current user can move children of this folder within this shared
-          # drive or My Drive. This is false when the item isn't a folder. Note that a
-          # request to move the child might still fail depending on the current user's
-          # access to the child and to the destination folder.
+          # Output only. Whether the current user can move children of this folder within
+          # this drive. This is false when the item is not a folder. Note that a request
+          # to move the child may still fail depending on the current user's access to the
+          # child and to the destination folder.
           # Corresponds to the JSON property `canMoveChildrenWithinDrive`
           # @return [Boolean]
           attr_accessor :can_move_children_within_drive
           alias_method :can_move_children_within_drive?, :can_move_children_within_drive
         
-          # Deprecated - use canMoveChildrenWithinDrive instead.
+          # Deprecated: Output only. Use `canMoveChildrenWithinDrive` instead.
           # Corresponds to the JSON property `canMoveChildrenWithinTeamDrive`
           # @return [Boolean]
           attr_accessor :can_move_children_within_team_drive
           alias_method :can_move_children_within_team_drive?, :can_move_children_within_team_drive
         
-          # Deprecated - use canMoveItemOutOfDrive instead.
+          # Deprecated: Output only. Use `canMoveItemOutOfDrive` instead.
           # Corresponds to the JSON property `canMoveItemIntoTeamDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_into_team_drive
           alias_method :can_move_item_into_team_drive?, :can_move_item_into_team_drive
         
-          # Whether the current user can move this item outside of this shared drive or My
-          # Drive by changing its parent. Note that a request to change the parent of the
-          # item might still fail depending on the new parent that's being added.
+          # Output only. Whether the current user can move this item outside of this drive
+          # by changing its parent. Note that a request to change the parent of the item
+          # may still fail depending on the new parent that is being added.
           # Corresponds to the JSON property `canMoveItemOutOfDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_out_of_drive
           alias_method :can_move_item_out_of_drive?, :can_move_item_out_of_drive
         
-          # Deprecated - use canMoveItemOutOfDrive instead.
+          # Deprecated: Output only. Use `canMoveItemOutOfDrive` instead.
           # Corresponds to the JSON property `canMoveItemOutOfTeamDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_out_of_team_drive
           alias_method :can_move_item_out_of_team_drive?, :can_move_item_out_of_team_drive
         
-          # Whether the current user can move this item within this shared drive or My
-          # Drive. Note that a request to change the parent of the item might still fail
-          # depending on the new parent that's being added and the parent that's being
-          # removed.
+          # Output only. Whether the current user can move this item within this drive.
+          # Note that a request to change the parent of the item may still fail depending
+          # on the new parent that is being added and the parent that is being removed.
           # Corresponds to the JSON property `canMoveItemWithinDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_within_drive
           alias_method :can_move_item_within_drive?, :can_move_item_within_drive
         
-          # Deprecated - use canMoveItemWithinDrive instead.
+          # Deprecated: Output only. Use `canMoveItemWithinDrive` instead.
           # Corresponds to the JSON property `canMoveItemWithinTeamDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_within_team_drive
           alias_method :can_move_item_within_team_drive?, :can_move_item_within_team_drive
         
-          # Deprecated - use canMoveItemWithinDrive or canMoveItemOutOfDrive instead.
+          # Deprecated: Output only. Use `canMoveItemWithinDrive` or `
+          # canMoveItemOutOfDrive` instead.
           # Corresponds to the JSON property `canMoveTeamDriveItem`
           # @return [Boolean]
           attr_accessor :can_move_team_drive_item
           alias_method :can_move_team_drive_item?, :can_move_team_drive_item
         
-          # Whether the current user can read the shared drive to which this file belongs.
-          # Only populated for items in shared drives.
+          # Output only. Whether the current user can read the shared drive to which this
+          # file belongs. Only populated for items in shared drives.
           # Corresponds to the JSON property `canReadDrive`
           # @return [Boolean]
           attr_accessor :can_read_drive
           alias_method :can_read_drive?, :can_read_drive
         
-          # Whether the current user can read the labels on this file.
+          # Output only. Whether the current user can read the labels on the file.
           # Corresponds to the JSON property `canReadLabels`
           # @return [Boolean]
           attr_accessor :can_read_labels
           alias_method :can_read_labels?, :can_read_labels
         
-          # Whether the current user can read the revisions resource of this file. For a
-          # shared drive item, whether revisions of non-folder descendants of this item,
-          # or this item itself if it's not a folder, can be read.
+          # Output only. Whether the current user can read the revisions resource of this
+          # file. For a shared drive item, whether revisions of non-folder descendants of
+          # this item, or this item itself if it is not a folder, can be read.
           # Corresponds to the JSON property `canReadRevisions`
           # @return [Boolean]
           attr_accessor :can_read_revisions
           alias_method :can_read_revisions?, :can_read_revisions
         
-          # Deprecated - use canReadDrive instead.
+          # Deprecated: Output only. Use `canReadDrive` instead.
           # Corresponds to the JSON property `canReadTeamDrive`
           # @return [Boolean]
           attr_accessor :can_read_team_drive
           alias_method :can_read_team_drive?, :can_read_team_drive
         
-          # Whether the current user can remove children from this folder. This is always
-          # false when the item isn't a folder. For a folder in a shared drive, use
-          # canDeleteChildren or canTrashChildren instead.
+          # Output only. Whether the current user can remove children from this folder.
+          # This is always false when the item is not a folder. For a folder in a shared
+          # drive, use `canDeleteChildren` or `canTrashChildren` instead.
           # Corresponds to the JSON property `canRemoveChildren`
           # @return [Boolean]
           attr_accessor :can_remove_children
           alias_method :can_remove_children?, :can_remove_children
         
-          # Whether the current user can remove a parent from the item without adding
-          # another parent in the same request. Not populated for shared drive files.
+          # Output only. Whether the current user can remove a parent from the item
+          # without adding another parent in the same request. Not populated for shared
+          # drive files.
           # Corresponds to the JSON property `canRemoveMyDriveParent`
           # @return [Boolean]
           attr_accessor :can_remove_my_drive_parent
           alias_method :can_remove_my_drive_parent?, :can_remove_my_drive_parent
         
-          # Whether the current user can rename this file.
+          # Output only. Whether the current user can rename this file.
           # Corresponds to the JSON property `canRename`
           # @return [Boolean]
           attr_accessor :can_rename
           alias_method :can_rename?, :can_rename
         
-          # Whether the current user can modify the sharing settings for this file.
+          # Output only. Whether the current user can modify the sharing settings for this
+          # file.
           # Corresponds to the JSON property `canShare`
           # @return [Boolean]
           attr_accessor :can_share
           alias_method :can_share?, :can_share
         
-          # Whether the current user can move this file to trash.
+          # Output only. Whether the current user can move this file to trash.
           # Corresponds to the JSON property `canTrash`
           # @return [Boolean]
           attr_accessor :can_trash
           alias_method :can_trash?, :can_trash
         
-          # Whether the current user can trash children of this folder. This is false when
-          # the item isn't a folder. Only populated for items in shared drives.
+          # Output only. Whether the current user can trash children of this folder. This
+          # is false when the item is not a folder. Only populated for items in shared
+          # drives.
           # Corresponds to the JSON property `canTrashChildren`
           # @return [Boolean]
           attr_accessor :can_trash_children
           alias_method :can_trash_children?, :can_trash_children
         
-          # Whether the current user can restore this file from trash.
+          # Output only. Whether the current user can restore this file from trash.
           # Corresponds to the JSON property `canUntrash`
           # @return [Boolean]
           attr_accessor :can_untrash
@@ -1810,8 +1825,7 @@ module Google
           include Google::Apis::Core::Hashable
         
           # Text to be indexed for the file to improve fullText queries. This is limited
-          # to 128 KB in length and might contain HTML elements. For more information, see
-          # Manage file metadata.
+          # to 128KB in length and may contain HTML elements.
           # Corresponds to the JSON property `indexableText`
           # @return [String]
           attr_accessor :indexable_text
@@ -1860,114 +1874,114 @@ module Google
           end
         end
         
-        # Additional metadata about image media, if available.
+        # Output only. Additional metadata about image media, if available.
         class ImageMediaMetadata
           include Google::Apis::Core::Hashable
         
-          # The aperture used to create the photo (f-number).
+          # Output only. The aperture used to create the photo (f-number).
           # Corresponds to the JSON property `aperture`
           # @return [Float]
           attr_accessor :aperture
         
-          # The make of the camera used to create the photo.
+          # Output only. The make of the camera used to create the photo.
           # Corresponds to the JSON property `cameraMake`
           # @return [String]
           attr_accessor :camera_make
         
-          # The model of the camera used to create the photo.
+          # Output only. The model of the camera used to create the photo.
           # Corresponds to the JSON property `cameraModel`
           # @return [String]
           attr_accessor :camera_model
         
-          # The color space of the photo.
+          # Output only. The color space of the photo.
           # Corresponds to the JSON property `colorSpace`
           # @return [String]
           attr_accessor :color_space
         
-          # The exposure bias of the photo (APEX value).
+          # Output only. The exposure bias of the photo (APEX value).
           # Corresponds to the JSON property `exposureBias`
           # @return [Float]
           attr_accessor :exposure_bias
         
-          # The exposure mode used to create the photo.
+          # Output only. The exposure mode used to create the photo.
           # Corresponds to the JSON property `exposureMode`
           # @return [String]
           attr_accessor :exposure_mode
         
-          # The length of the exposure, in seconds.
+          # Output only. The length of the exposure, in seconds.
           # Corresponds to the JSON property `exposureTime`
           # @return [Float]
           attr_accessor :exposure_time
         
-          # Whether a flash was used to create the photo.
+          # Output only. Whether a flash was used to create the photo.
           # Corresponds to the JSON property `flashUsed`
           # @return [Boolean]
           attr_accessor :flash_used
           alias_method :flash_used?, :flash_used
         
-          # The focal length used to create the photo, in millimeters.
+          # Output only. The focal length used to create the photo, in millimeters.
           # Corresponds to the JSON property `focalLength`
           # @return [Float]
           attr_accessor :focal_length
         
-          # The height of the image in pixels.
+          # Output only. The height of the image in pixels.
           # Corresponds to the JSON property `height`
           # @return [Fixnum]
           attr_accessor :height
         
-          # The ISO speed used to create the photo.
+          # Output only. The ISO speed used to create the photo.
           # Corresponds to the JSON property `isoSpeed`
           # @return [Fixnum]
           attr_accessor :iso_speed
         
-          # The lens used to create the photo.
+          # Output only. The lens used to create the photo.
           # Corresponds to the JSON property `lens`
           # @return [String]
           attr_accessor :lens
         
-          # Geographic location information stored in the image.
+          # Output only. Geographic location information stored in the image.
           # Corresponds to the JSON property `location`
           # @return [Google::Apis::DriveV3::File::ImageMediaMetadata::Location]
           attr_accessor :location
         
-          # The smallest f-number of the lens at the focal length used to create the photo
-          # (APEX value).
+          # Output only. The smallest f-number of the lens at the focal length used to
+          # create the photo (APEX value).
           # Corresponds to the JSON property `maxApertureValue`
           # @return [Float]
           attr_accessor :max_aperture_value
         
-          # The metering mode used to create the photo.
+          # Output only. The metering mode used to create the photo.
           # Corresponds to the JSON property `meteringMode`
           # @return [String]
           attr_accessor :metering_mode
         
-          # The number of clockwise 90-degree rotations applied from the image's original
-          # orientation.
+          # Output only. The number of clockwise 90 degree rotations applied from the
+          # image's original orientation.
           # Corresponds to the JSON property `rotation`
           # @return [Fixnum]
           attr_accessor :rotation
         
-          # The type of sensor used to create the photo.
+          # Output only. The type of sensor used to create the photo.
           # Corresponds to the JSON property `sensor`
           # @return [String]
           attr_accessor :sensor
         
-          # The distance to the subject of the photo, in meters.
+          # Output only. The distance to the subject of the photo, in meters.
           # Corresponds to the JSON property `subjectDistance`
           # @return [Fixnum]
           attr_accessor :subject_distance
         
-          # The date and time the photo was taken (EXIF DateTime).
+          # Output only. The date and time the photo was taken (EXIF DateTime).
           # Corresponds to the JSON property `time`
           # @return [String]
           attr_accessor :time
         
-          # The white balance mode used to create the photo.
+          # Output only. The white balance mode used to create the photo.
           # Corresponds to the JSON property `whiteBalance`
           # @return [String]
           attr_accessor :white_balance
         
-          # The width of the image in pixels.
+          # Output only. The width of the image in pixels.
           # Corresponds to the JSON property `width`
           # @return [Fixnum]
           attr_accessor :width
@@ -2001,21 +2015,21 @@ module Google
             @width = args[:width] if args.key?(:width)
           end
           
-          # Geographic location information stored in the image.
+          # Output only. Geographic location information stored in the image.
           class Location
             include Google::Apis::Core::Hashable
           
-            # The altitude stored in the image.
+            # Output only. The altitude stored in the image.
             # Corresponds to the JSON property `altitude`
             # @return [Float]
             attr_accessor :altitude
           
-            # The latitude stored in the image.
+            # Output only. The latitude stored in the image.
             # Corresponds to the JSON property `latitude`
             # @return [Float]
             attr_accessor :latitude
           
-            # The longitude stored in the image.
+            # Output only. The longitude stored in the image.
             # Corresponds to the JSON property `longitude`
             # @return [Float]
             attr_accessor :longitude
@@ -2033,12 +2047,12 @@ module Google
           end
         end
         
-        # An overview of the labels on the file.
+        # Output only. An overview of the labels on the file.
         class LabelInfo
           include Google::Apis::Core::Hashable
         
-          # The set of labels on the file as requested by the label IDs in the
-          # includeLabels parameter. By default, no labels are returned.
+          # Output only. The set of labels on the file as requested by the label IDs in
+          # the `includeLabels` parameter. By default, no labels are returned.
           # Corresponds to the JSON property `labels`
           # @return [Array<Google::Apis::DriveV3::Label>]
           attr_accessor :labels
@@ -2058,13 +2072,13 @@ module Google
         class LinkShareMetadata
           include Google::Apis::Core::Hashable
         
-          # Whether the file is eligible for security update.
+          # Output only. Whether the file is eligible for security update.
           # Corresponds to the JSON property `securityUpdateEligible`
           # @return [Boolean]
           attr_accessor :security_update_eligible
           alias_method :security_update_eligible?, :security_update_eligible
         
-          # Whether the security update is enabled for this file.
+          # Output only. Whether the security update is enabled for this file.
           # Corresponds to the JSON property `securityUpdateEnabled`
           # @return [Boolean]
           attr_accessor :security_update_enabled
@@ -2082,7 +2096,7 @@ module Google
         end
         
         # Shortcut file details. Only populated for shortcut files, which have the
-        # mimeType field set to application/vnd.google-apps.shortcut.
+        # mimeType field set to `application/vnd.google-apps.shortcut`.
         class ShortcutDetails
           include Google::Apis::Core::Hashable
         
@@ -2091,14 +2105,14 @@ module Google
           # @return [String]
           attr_accessor :target_id
         
-          # The MIME type of the file that this shortcut points to. The value of this
-          # field is a snapshot of the target's MIME type, captured when the shortcut is
-          # created.
+          # Output only. The MIME type of the file that this shortcut points to. The value
+          # of this field is a snapshot of the target's MIME type, captured when the
+          # shortcut is created.
           # Corresponds to the JSON property `targetMimeType`
           # @return [String]
           attr_accessor :target_mime_type
         
-          # The ResourceKey for the target file.
+          # Output only. The ResourceKey for the target file.
           # Corresponds to the JSON property `targetResourceKey`
           # @return [String]
           attr_accessor :target_resource_key
@@ -2115,22 +2129,22 @@ module Google
           end
         end
         
-        # Additional metadata about video media. This might not be available immediately
-        # upon upload.
+        # Output only. Additional metadata about video media. This may not be available
+        # immediately upon upload.
         class VideoMediaMetadata
           include Google::Apis::Core::Hashable
         
-          # The duration of the video in milliseconds.
+          # Output only. The duration of the video in milliseconds.
           # Corresponds to the JSON property `durationMillis`
           # @return [Fixnum]
           attr_accessor :duration_millis
         
-          # The height of the video in pixels.
+          # Output only. The height of the video in pixels.
           # Corresponds to the JSON property `height`
           # @return [Fixnum]
           attr_accessor :height
         
-          # The width of the video in pixels.
+          # Output only. The width of the video in pixels.
           # Corresponds to the JSON property `width`
           # @return [Fixnum]
           attr_accessor :width
@@ -2159,17 +2173,17 @@ module Google
         attr_accessor :files
       
         # Whether the search process was incomplete. If true, then some search results
-        # may be missing, since all documents were not searched. This may occur when
-        # searching multiple drives with the "allDrives" corpora, but all corpora could
-        # not be searched. When this happens, it is suggested that clients narrow their
-        # query by choosing a different corpus such as "user" or "drive".
+        # might be missing, since all documents were not searched. This can occur when
+        # searching multiple drives with the 'allDrives' corpora, but all corpora couldn'
+        # t be searched. When this happens, it's suggested that clients narrow their
+        # query by choosing a different corpus such as 'user' or 'drive'.
         # Corresponds to the JSON property `incompleteSearch`
         # @return [Boolean]
         attr_accessor :incomplete_search
         alias_method :incomplete_search?, :incomplete_search
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # fileList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # fileList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2204,8 +2218,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :ids
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # generatedIds".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # generatedIds"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2227,11 +2241,11 @@ module Google
         end
       end
       
-      # Representation of a label and its fields.
+      # Representation of label and label fields.
       class Label
         include Google::Apis::Core::Hashable
       
-        # A map of the label's fields keyed by the field ID.
+        # A map of the fields on the label, keyed by the field's ID.
         # Corresponds to the JSON property `fields`
         # @return [Hash<String,Google::Apis::DriveV3::LabelField>]
         attr_accessor :fields
@@ -2264,7 +2278,7 @@ module Google
         end
       end
       
-      # Representation of a label field.
+      # Representation of field, which is a typed key-value pair.
       class LabelField
         include Google::Apis::Core::Hashable
       
@@ -2273,12 +2287,12 @@ module Google
         # @return [Array<Date>]
         attr_accessor :date_string
       
-        # The identifier of this field.
+        # The identifier of this label field.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Only present if valueType is integer.
+        # Only present if `valueType` is `integer`.
         # Corresponds to the JSON property `integer`
         # @return [Array<Fixnum>]
         attr_accessor :integer
@@ -2288,28 +2302,24 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Only present if valueType is selection.
+        # Only present if `valueType` is `selection`
         # Corresponds to the JSON property `selection`
         # @return [Array<String>]
         attr_accessor :selection
       
-        # Only present if valueType is text.
+        # Only present if `valueType` is `text`.
         # Corresponds to the JSON property `text`
         # @return [Array<String>]
         attr_accessor :text
       
-        # Only present if valueType is user.
+        # Only present if `valueType` is `user`.
         # Corresponds to the JSON property `user`
         # @return [Array<Google::Apis::DriveV3::User>]
         attr_accessor :user
       
         # The field type. While new values may be supported in the future, the following
-        # are currently allowed:
-        # - dateString
-        # - integer
-        # - selection
-        # - text
-        # - user
+        # are currently allowed: * `dateString` * `integer` * `selection` * `text` * `
+        # user`
         # Corresponds to the JSON property `valueType`
         # @return [String]
         attr_accessor :value_type
@@ -2335,7 +2345,7 @@ module Google
       class LabelFieldModification
         include Google::Apis::Core::Hashable
       
-        # The ID of the Field to be modified.
+        # The ID of the field to be modified.
         # Corresponds to the JSON property `fieldId`
         # @return [String]
         attr_accessor :field_id
@@ -2345,28 +2355,28 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Replaces a dateString field with these new values. The values must be strings
-        # in the RFC 3339 full-date format: YYYY-MM-DD.
+        # Replaces the value of a dateString Field with these new values. The string
+        # must be in the RFC 3339 full-date format: YYYY-MM-DD.
         # Corresponds to the JSON property `setDateValues`
         # @return [Array<Date>]
         attr_accessor :set_date_values
       
-        # Replaces an integer field with these new values.
+        # Replaces the value of an `integer` field with these new values.
         # Corresponds to the JSON property `setIntegerValues`
         # @return [Array<Fixnum>]
         attr_accessor :set_integer_values
       
-        # Replaces a selection field with these new values.
+        # Replaces a `selection` field with these new values.
         # Corresponds to the JSON property `setSelectionValues`
         # @return [Array<String>]
         attr_accessor :set_selection_values
       
-        # Replaces a text field with these new values.
+        # Sets the value of a `text` field.
         # Corresponds to the JSON property `setTextValues`
         # @return [Array<String>]
         attr_accessor :set_text_values
       
-        # Replaces a user field with these new values. The values must be valid email
+        # Replaces a `user` field with these new values. The values must be valid email
         # addresses.
         # Corresponds to the JSON property `setUserValues`
         # @return [Array<String>]
@@ -2395,7 +2405,7 @@ module Google
         end
       end
       
-      # A list of labels.
+      # A list of labels applied to a file.
       class LabelList
         include Google::Apis::Core::Hashable
       
@@ -2470,11 +2480,11 @@ module Google
       end
       
       # A request to modify the set of labels on a file. This request may contain many
-      # modifications that will either all succeed or all fail transactionally.
+      # modifications that will either all succeed or all fail atomically.
       class ModifyLabelsRequest
         include Google::Apis::Core::Hashable
       
-        # This is always drive#modifyLabelsRequest
+        # This is always drive#modifyLabelsRequest.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2521,40 +2531,36 @@ module Google
         end
       end
       
-      # A permission for a file. A permission grants a user, group, domain, or the
+      # A permission for a file. A permission grants a user, group, domain or the
       # world access to a file or a folder hierarchy.
       class Permission
         include Google::Apis::Core::Hashable
       
         # Whether the permission allows the file to be discovered through search. This
-        # is only applicable for permissions of type domain or anyone.
+        # is only applicable for permissions of type `domain` or `anyone`.
         # Corresponds to the JSON property `allowFileDiscovery`
         # @return [Boolean]
         attr_accessor :allow_file_discovery
         alias_method :allow_file_discovery?, :allow_file_discovery
       
-        # Whether the account associated with this permission has been deleted. This
-        # field only pertains to user and group permissions.
+        # Output only. Whether the account associated with this permission has been
+        # deleted. This field only pertains to user and group permissions.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # The "pretty" name of the value of the permission. The following is a list of
-        # examples for each type of permission:
-        # - user - User's full name, as defined for their Google Account, such as "Joe
-        # Smith."
-        # - group - Name of the Google Group, such as "The Company Administrators."
-        # - domain - String domain name, such as "your-company.com."
-        # - anyone - No displayName is present.
+        # Output only. The "pretty" name of the value of the permission. The following
+        # is a list of examples for each type of permission: * `user` - User's full name,
+        # as defined for their Google account, such as "Joe Smith." * `group` - Name of
+        # the Google Group, such as "The Company Administrators." * `domain` - String
+        # domain name, such as "thecompany.com." * `anyone` - No `displayName` is
+        # present.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # The domain to which this permission refers. The following options are
-        # currently allowed:
-        # - The entire domain, such as "your-company.com."
-        # - A target audience, such as "ID.audience.googledomains.com."
+        # The domain to which this permission refers.
         # Corresponds to the JSON property `domain`
         # @return [String]
         attr_accessor :domain
@@ -2565,77 +2571,68 @@ module Google
         attr_accessor :email_address
       
         # The time at which this permission will expire (RFC 3339 date-time). Expiration
-        # times have the following restrictions:
-        # - They cannot be set on shared drive items.
-        # - They can only be set on user and group permissions.
-        # - The time must be in the future.
-        # - The time cannot be more than one year in the future.
+        # times have the following restrictions: - They can only be set on user and
+        # group permissions - The time must be in the future - The time cannot be more
+        # than a year in the future
         # Corresponds to the JSON property `expirationTime`
         # @return [DateTime]
         attr_accessor :expiration_time
       
-        # The ID of this permission. This is a unique identifier for the grantee, and is
-        # published in User resources as permissionId. IDs should be treated as opaque
-        # values.
+        # Output only. The ID of this permission. This is a unique identifier for the
+        # grantee, and is published in User resources as `permissionId`. IDs should be
+        # treated as opaque values.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # permission".
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # `"drive#permission"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # Whether the account associated with this permission is a pending owner. Only
-        # populated for user type permissions for files that aren't in a shared drive.
+        # populated for `user` type permissions for files that are not in a shared drive.
         # Corresponds to the JSON property `pendingOwner`
         # @return [Boolean]
         attr_accessor :pending_owner
         alias_method :pending_owner?, :pending_owner
       
-        # Details of whether the permissions on this shared drive item are inherited or
-        # are directly on this item. This is an output-only field that's present only
-        # for shared drive items.
+        # Output only. Details of whether the permissions on this shared drive item are
+        # inherited or directly on this item. This is an output-only field which is
+        # present only for shared drive items.
         # Corresponds to the JSON property `permissionDetails`
         # @return [Array<Google::Apis::DriveV3::Permission::PermissionDetail>]
         attr_accessor :permission_details
       
-        # A link to the user's profile photo, if available.
+        # Output only. A link to the user's profile photo, if available.
         # Corresponds to the JSON property `photoLink`
         # @return [String]
         attr_accessor :photo_link
       
         # The role granted by this permission. While new values may be supported in the
-        # future, the following are currently allowed:
-        # - owner
-        # - organizer
-        # - fileOrganizer
-        # - writer
-        # - commenter
-        # - reader
+        # future, the following are currently allowed: * `owner` * `organizer` * `
+        # fileOrganizer` * `writer` * `commenter` * `reader`
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
       
-        # Deprecated - use permissionDetails instead.
+        # Output only. Deprecated: Output only. Use `permissionDetails` instead.
         # Corresponds to the JSON property `teamDrivePermissionDetails`
         # @return [Array<Google::Apis::DriveV3::Permission::TeamDrivePermissionDetail>]
         attr_accessor :team_drive_permission_details
       
-        # The type of the grantee. Valid values are:
-        # - user
-        # - group
-        # - domain
-        # - anyone  When creating a permission, if type is user or group, you must
-        # provide an emailAddress for the user or group. When type is domain, you must
-        # provide a domain. There isn't extra information required for the anyone type.
+        # The type of the grantee. Valid values are: * `user` * `group` * `domain` * `
+        # anyone` When creating a permission, if `type` is `user` or `group`, you must
+        # provide an `emailAddress` for the user or group. When `type` is `domain`, you
+        # must provide a `domain`. There isn't extra information required for an `anyone`
+        # type.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
         # Indicates the view for this permission. Only populated for permissions that
-        # belong to a view. published is the only supported value.
+        # belong to a view. 'published' is the only supported value.
         # Corresponds to the JSON property `view`
         # @return [String]
         attr_accessor :view
@@ -2667,34 +2664,28 @@ module Google
         class PermissionDetail
           include Google::Apis::Core::Hashable
         
-          # Whether this permission is inherited. This field is always populated. This is
-          # an output-only field.
+          # Output only. Whether this permission is inherited. This field is always
+          # populated. This is an output-only field.
           # Corresponds to the JSON property `inherited`
           # @return [Boolean]
           attr_accessor :inherited
           alias_method :inherited?, :inherited
         
-          # The ID of the item from which this permission is inherited. This is an output-
-          # only field.
+          # Output only. The ID of the item from which this permission is inherited. This
+          # is an output-only field.
           # Corresponds to the JSON property `inheritedFrom`
           # @return [String]
           attr_accessor :inherited_from
         
-          # The permission type for this user. While new values may be added in future,
-          # the following are currently allowed:
-          # - file
-          # - member
+          # Output only. The permission type for this user. While new values may be added
+          # in future, the following are currently possible: * `file` * `member`
           # Corresponds to the JSON property `permissionType`
           # @return [String]
           attr_accessor :permission_type
         
-          # The primary role for this user. While new values may be added in the future,
-          # the following are currently allowed:
-          # - organizer
-          # - fileOrganizer
-          # - writer
-          # - commenter
-          # - reader
+          # Output only. The primary role for this user. While new values may be added in
+          # the future, the following are currently possible: * `organizer` * `
+          # fileOrganizer` * `writer` * `commenter` * `reader`
           # Corresponds to the JSON property `role`
           # @return [String]
           attr_accessor :role
@@ -2716,23 +2707,23 @@ module Google
         class TeamDrivePermissionDetail
           include Google::Apis::Core::Hashable
         
-          # Deprecated - use permissionDetails/inherited instead.
+          # Deprecated: Output only. Use `permissionDetails/inherited` instead.
           # Corresponds to the JSON property `inherited`
           # @return [Boolean]
           attr_accessor :inherited
           alias_method :inherited?, :inherited
         
-          # Deprecated - use permissionDetails/inheritedFrom instead.
+          # Deprecated: Output only. Use `permissionDetails/inheritedFrom` instead.
           # Corresponds to the JSON property `inheritedFrom`
           # @return [String]
           attr_accessor :inherited_from
         
-          # Deprecated - use permissionDetails/role instead.
+          # Deprecated: Output only. Use `permissionDetails/role` instead.
           # Corresponds to the JSON property `role`
           # @return [String]
           attr_accessor :role
         
-          # Deprecated - use permissionDetails/permissionType instead.
+          # Deprecated: Output only. Use `permissionDetails/permissionType` instead.
           # Corresponds to the JSON property `teamDrivePermissionType`
           # @return [String]
           attr_accessor :team_drive_permission_type
@@ -2755,8 +2746,8 @@ module Google
       class PermissionList
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # permissionList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # permissionList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2791,9 +2782,8 @@ module Google
       class Reply
         include Google::Apis::Core::Hashable
       
-        # The action the reply performed to the parent comment. Valid values are:
-        # - resolve
-        # - reopen
+        # The action the reply performed to the parent comment. Valid values are: * `
+        # resolve` * `reopen`
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
@@ -2804,8 +2794,8 @@ module Google
         attr_accessor :author
       
         # The plain text content of the reply. This field is used for setting the
-        # content, while htmlContent should be displayed. This is required on creates if
-        # no action is specified.
+        # content, while `htmlContent` should be displayed. This is required on creates
+        # if no `action` is specified.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
@@ -2815,24 +2805,25 @@ module Google
         # @return [DateTime]
         attr_accessor :created_time
       
-        # Whether the reply has been deleted. A deleted reply has no content.
+        # Output only. Whether the reply has been deleted. A deleted reply has no
+        # content.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # The content of the reply with HTML formatting.
+        # Output only. The content of the reply with HTML formatting.
         # Corresponds to the JSON property `htmlContent`
         # @return [String]
         attr_accessor :html_content
       
-        # The ID of the reply.
+        # Output only. The ID of the reply.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#reply"
-        # .
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # `"drive#reply"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2864,8 +2855,8 @@ module Google
       class ReplyList
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # replyList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # replyList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2900,12 +2891,12 @@ module Google
       class Revision
         include Google::Apis::Core::Hashable
       
-        # Links for exporting Docs Editors files to specific formats.
+        # Output only. Links for exporting Docs Editors files to specific formats.
         # Corresponds to the JSON property `exportLinks`
         # @return [Hash<String,String>]
         attr_accessor :export_links
       
-        # The ID of the revision.
+        # Output only. The ID of the revision.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -2913,15 +2904,14 @@ module Google
         # Whether to keep this revision forever, even if it is no longer the head
         # revision. If not set, the revision will be automatically purged 30 days after
         # newer content is uploaded. This can be set on a maximum of 200 revisions for a
-        # file.
-        # This field is only applicable to files with binary content in Drive.
+        # file. This field is only applicable to files with binary content in Drive.
         # Corresponds to the JSON property `keepForever`
         # @return [Boolean]
         attr_accessor :keep_forever
         alias_method :keep_forever?, :keep_forever
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # revision".
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # `"drive#revision"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2931,13 +2921,13 @@ module Google
         # @return [Google::Apis::DriveV3::User]
         attr_accessor :last_modifying_user
       
-        # The MD5 checksum of the revision's content. This is only applicable to files
-        # with binary content in Drive.
+        # Output only. The MD5 checksum of the revision's content. This is only
+        # applicable to files with binary content in Drive.
         # Corresponds to the JSON property `md5Checksum`
         # @return [String]
         attr_accessor :md5_checksum
       
-        # The MIME type of the revision.
+        # Output only. The MIME type of the revision.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
@@ -2947,8 +2937,8 @@ module Google
         # @return [DateTime]
         attr_accessor :modified_time
       
-        # The original filename used to create this revision. This is only applicable to
-        # files with binary content in Drive.
+        # Output only. The original filename used to create this revision. This is only
+        # applicable to files with binary content in Drive.
         # Corresponds to the JSON property `originalFilename`
         # @return [String]
         attr_accessor :original_filename
@@ -2967,8 +2957,8 @@ module Google
         attr_accessor :published
         alias_method :published?, :published
       
-        # A link to the published revision. This is only populated for Google Sites
-        # files.
+        # Output only. A link to the published revision. This is only populated for
+        # Google Sites files.
         # Corresponds to the JSON property `publishedLink`
         # @return [String]
         attr_accessor :published_link
@@ -2980,8 +2970,8 @@ module Google
         attr_accessor :published_outside_domain
         alias_method :published_outside_domain?, :published_outside_domain
       
-        # The size of the revision's content in bytes. This is only applicable to files
-        # with binary content in Drive.
+        # Output only. The size of the revision's content in bytes. This is only
+        # applicable to files with binary content in Drive.
         # Corresponds to the JSON property `size`
         # @return [Fixnum]
         attr_accessor :size
@@ -3013,8 +3003,8 @@ module Google
       class RevisionList
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # revisionList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # revisionList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3049,8 +3039,8 @@ module Google
       class StartPageToken
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # startPageToken".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # startPageToken"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3076,9 +3066,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An image file and cropping parameters from which a background image for this
-        # Team Drive is set. This is a write only field; it can only be set on drive.
-        # teamdrives.update requests that don't set themeId. When specified, all fields
-        # of the backgroundImageFile must be set.
+        # Team Drive is set. This is a write only field; it can only be set on `drive.
+        # teamdrives.update` requests that don't set `themeId`. When specified, all
+        # fields of the `backgroundImageFile` must be set.
         # Corresponds to the JSON property `backgroundImageFile`
         # @return [Google::Apis::DriveV3::TeamDrive::BackgroundImageFile]
         attr_accessor :background_image_file
@@ -3093,8 +3083,8 @@ module Google
         # @return [Google::Apis::DriveV3::TeamDrive::Capabilities]
         attr_accessor :capabilities
       
-        # The color of this Team Drive as an RGB hex string. It can only be set on a
-        # drive.teamdrives.update request that does not set themeId.
+        # The color of this Team Drive as an RGB hex string. It can only be set on a `
+        # drive.teamdrives.update` request that does not set `themeId`.
         # Corresponds to the JSON property `colorRgb`
         # @return [String]
         attr_accessor :color_rgb
@@ -3110,8 +3100,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # teamDrive".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # teamDrive"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3121,8 +3111,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The organizational unit of this shared drive. This field is only populated on
-        # drives.list responses when the useDomainAdminAccess parameter is set to true.
+        # The organizational unit of this shared drive. This field is only populated on `
+        # drives.list` responses when the `useDomainAdminAccess` parameter is set to `
+        # true`.
         # Corresponds to the JSON property `orgUnitId`
         # @return [String]
         attr_accessor :org_unit_id
@@ -3134,11 +3125,11 @@ module Google
         attr_accessor :restrictions
       
         # The ID of the theme from which the background image and color will be set. The
-        # set of possible teamDriveThemes can be retrieved from a drive.about.get
-        # response. When not specified on a drive.teamdrives.create request, a random
+        # set of possible `teamDriveThemes` can be retrieved from a `drive.about.get`
+        # response. When not specified on a `drive.teamdrives.create` request, a random
         # theme is chosen from which the background image and color are set. This is a
-        # write-only field; it can only be set on requests that don't set colorRgb or
-        # backgroundImageFile.
+        # write-only field; it can only be set on requests that don't set `colorRgb` or `
+        # backgroundImageFile`.
         # Corresponds to the JSON property `themeId`
         # @return [String]
         attr_accessor :theme_id
@@ -3163,9 +3154,9 @@ module Google
         end
         
         # An image file and cropping parameters from which a background image for this
-        # Team Drive is set. This is a write only field; it can only be set on drive.
-        # teamdrives.update requests that don't set themeId. When specified, all fields
-        # of the backgroundImageFile must be set.
+        # Team Drive is set. This is a write only field; it can only be set on `drive.
+        # teamdrives.update` requests that don't set `themeId`. When specified, all
+        # fields of the `backgroundImageFile` must be set.
         class BackgroundImageFile
           include Google::Apis::Core::Hashable
         
@@ -3222,22 +3213,22 @@ module Google
           attr_accessor :can_add_children
           alias_method :can_add_children?, :can_add_children
         
-          # Whether the current user can change the copyRequiresWriterPermission
+          # Whether the current user can change the `copyRequiresWriterPermission`
           # restriction of this Team Drive.
           # Corresponds to the JSON property `canChangeCopyRequiresWriterPermissionRestriction`
           # @return [Boolean]
           attr_accessor :can_change_copy_requires_writer_permission_restriction
           alias_method :can_change_copy_requires_writer_permission_restriction?, :can_change_copy_requires_writer_permission_restriction
         
-          # Whether the current user can change the domainUsersOnly restriction of this
+          # Whether the current user can change the `domainUsersOnly` restriction of this
           # Team Drive.
           # Corresponds to the JSON property `canChangeDomainUsersOnlyRestriction`
           # @return [Boolean]
           attr_accessor :can_change_domain_users_only_restriction
           alias_method :can_change_domain_users_only_restriction?, :can_change_domain_users_only_restriction
         
-          # Whether the current user can change the
-          # sharingFoldersRequiresOrganizerPermission restriction of this Team Drive.
+          # Whether the current user can change the `
+          # sharingFoldersRequiresOrganizerPermission` restriction of this Team Drive.
           # Corresponds to the JSON property `canChangeSharingFoldersRequiresOrganizerPermissionRestriction`
           # @return [Boolean]
           attr_accessor :can_change_sharing_folders_requires_organizer_permission_restriction
@@ -3249,7 +3240,7 @@ module Google
           attr_accessor :can_change_team_drive_background
           alias_method :can_change_team_drive_background?, :can_change_team_drive_background
         
-          # Whether the current user can change the teamMembersOnly restriction of this
+          # Whether the current user can change the `teamMembersOnly` restriction of this
           # Team Drive.
           # Corresponds to the JSON property `canChangeTeamMembersOnlyRestriction`
           # @return [Boolean]
@@ -3313,7 +3304,7 @@ module Google
           attr_accessor :can_read_revisions
           alias_method :can_read_revisions?, :can_read_revisions
         
-          # Deprecated - use canDeleteChildren or canTrashChildren instead.
+          # Deprecated: Use `canDeleteChildren` or `canTrashChildren` instead.
           # Corresponds to the JSON property `canRemoveChildren`
           # @return [Boolean]
           attr_accessor :can_remove_children
@@ -3393,8 +3384,8 @@ module Google
         
           # Whether the options to copy, print, or download files inside this Team Drive,
           # should be disabled for readers and commenters. When this restriction is set to
-          # true, it will override the similarly named field to true for any file inside
-          # this Team Drive.
+          # `true`, it will override the similarly named field to `true` for any file
+          # inside this Team Drive.
           # Corresponds to the JSON property `copyRequiresWriterPermission`
           # @return [Boolean]
           attr_accessor :copy_requires_writer_permission
@@ -3442,8 +3433,8 @@ module Google
       class TeamDriveList
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#
-        # teamDriveList".
+        # Identifies what kind of resource this is. Value: the fixed string `"drive#
+        # teamDriveList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3478,34 +3469,35 @@ module Google
       class User
         include Google::Apis::Core::Hashable
       
-        # A plain text displayable name for this user.
+        # Output only. A plain text displayable name for this user.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # The email address of the user. This may not be present in certain contexts if
-        # the user has not made their email address visible to the requester.
+        # Output only. The email address of the user. This may not be present in certain
+        # contexts if the user has not made their email address visible to the requester.
         # Corresponds to the JSON property `emailAddress`
         # @return [String]
         attr_accessor :email_address
       
-        # Identifies what kind of resource this is. Value: the fixed string "drive#user".
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # `"drive#user"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Whether this user is the requesting user.
+        # Output only. Whether this user is the requesting user.
         # Corresponds to the JSON property `me`
         # @return [Boolean]
         attr_accessor :me
         alias_method :me?, :me
       
-        # The user's ID as visible in Permission resources.
+        # Output only. The user's ID as visible in Permission resources.
         # Corresponds to the JSON property `permissionId`
         # @return [String]
         attr_accessor :permission_id
       
-        # A link to the user's profile photo, if available.
+        # Output only. A link to the user's profile photo, if available.
         # Corresponds to the JSON property `photoLink`
         # @return [String]
         attr_accessor :photo_link