google-apis-drive_v3 0.26.0 → 0.44.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,12 +221,14 @@ 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
       
-        # Representation of a shared drive.
+        # Representation of a shared drive. Some resource methods (such as `drives.
+        # update`) require a `driveId`. Use the `drives.list` method to retrieve the ID
+        # for a shared drive.
         # Corresponds to the JSON property `drive`
         # @return [Google::Apis::DriveV3::Drive]
         attr_accessor :drive
@@ -236,7 +238,8 @@ module Google
         # @return [String]
         attr_accessor :drive_id
       
-        # The metadata for a file.
+        # The metadata for a file. Some resource methods (such as `files.update`)
+        # require a `fileId`. Use the `files.list` method to retrieve the ID for a file.
         # Corresponds to the JSON property `file`
         # @return [Google::Apis::DriveV3::File]
         attr_accessor :file
@@ -246,8 +249,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 +267,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 +277,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,22 +312,21 @@ 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
       
         # The starting page token for future changes. This will be present only if the
-        # end of the current changes list has been reached.
+        # end of the current changes list has been reached. The page token doesn't
+        # expire.
         # Corresponds to the JSON property `newStartPageToken`
         # @return [String]
         attr_accessor :new_start_page_token
       
         # The page token for the next page of changes. This will be absent if the end of
-        # the changes list has been reached. If the token is rejected for any reason, it
-        # should be discarded, and pagination should be restarted from the first page of
-        # results.
+        # the changes list has been reached. The page token doesn't expire.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -342,7 +344,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 +365,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 +398,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
@@ -422,12 +422,15 @@ module Google
         end
       end
       
-      # A comment on a file.
+      # A comment on a file. Some resource methods (such as `comments.update`) require
+      # a `commentId`. Use the `comments.list` method to retrieve the ID for a comment
+      # in a file.
       class Comment
         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 +441,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 +451,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 +487,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 +557,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
@@ -562,7 +566,8 @@ module Google
         # The page token for the next page of comments. This will be absent if the end
         # of the comments list has been reached. If the token is rejected for any reason,
         # it should be discarded, and pagination should be restarted from the first
-        # page of results.
+        # page of results. The page token is typically valid for several hours. However,
+        # if new items are added or removed, your expected results might differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -583,6 +588,14 @@ module Google
       class ContentRestriction
         include Google::Apis::Core::Hashable
       
+        # Whether the content restriction can only be modified or removed by a user who
+        # owns the file. For files in shared drives, any user with `organizer`
+        # capabilities can modify or remove this content restriction.
+        # Corresponds to the JSON property `ownerRestricted`
+        # @return [Boolean]
+        attr_accessor :owner_restricted
+        alias_method :owner_restricted?, :owner_restricted
+      
         # Whether the content of the file is read-only. If a file is read-only, a new
         # revision of the file may not be added, comments may not be added or modified,
         # and the title of the file may not be modified.
@@ -592,7 +605,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 +621,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
@@ -620,6 +633,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @owner_restricted = args[:owner_restricted] if args.key?(:owner_restricted)
           @read_only = args[:read_only] if args.key?(:read_only)
           @reason = args[:reason] if args.key?(:reason)
           @restricting_user = args[:restricting_user] if args.key?(:restricting_user)
@@ -628,30 +642,32 @@ module Google
         end
       end
       
-      # Representation of a shared drive.
+      # Representation of a shared drive. Some resource methods (such as `drives.
+      # update`) require a `driveId`. Use the `drives.list` method to retrieve the ID
+      # for a shared drive.
       class Drive
         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 a
-        # drive.drives.update request that does not 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 +683,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 +700,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
@@ -697,10 +714,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 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.
+        # 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 +744,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,126 +793,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 comment on files in 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
+        
+          # 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
@@ -911,6 +945,7 @@ module Google
             @can_change_domain_users_only_restriction = args[:can_change_domain_users_only_restriction] if args.key?(:can_change_domain_users_only_restriction)
             @can_change_drive_background = args[:can_change_drive_background] if args.key?(:can_change_drive_background)
             @can_change_drive_members_only_restriction = args[:can_change_drive_members_only_restriction] if args.key?(:can_change_drive_members_only_restriction)
+            @can_change_sharing_folders_requires_organizer_permission_restriction = args[:can_change_sharing_folders_requires_organizer_permission_restriction] if args.key?(:can_change_sharing_folders_requires_organizer_permission_restriction)
             @can_comment = args[:can_comment] if args.key?(:can_comment)
             @can_copy = args[:can_copy] if args.key?(:can_copy)
             @can_delete_children = args[:can_delete_children] if args.key?(:can_delete_children)
@@ -942,7 +977,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]
@@ -964,6 +999,13 @@ module Google
           attr_accessor :drive_members_only
           alias_method :drive_members_only?, :drive_members_only
         
+          # If true, only users with the organizer role can share folders. If false, users
+          # with either the organizer role or the file organizer role can share folders.
+          # Corresponds to the JSON property `sharingFoldersRequiresOrganizerPermission`
+          # @return [Boolean]
+          attr_accessor :sharing_folders_requires_organizer_permission
+          alias_method :sharing_folders_requires_organizer_permission?, :sharing_folders_requires_organizer_permission
+        
           def initialize(**args)
              update!(**args)
           end
@@ -974,6 +1016,7 @@ module Google
             @copy_requires_writer_permission = args[:copy_requires_writer_permission] if args.key?(:copy_requires_writer_permission)
             @domain_users_only = args[:domain_users_only] if args.key?(:domain_users_only)
             @drive_members_only = args[:drive_members_only] if args.key?(:drive_members_only)
+            @sharing_folders_requires_organizer_permission = args[:sharing_folders_requires_organizer_permission] if args.key?(:sharing_folders_requires_organizer_permission)
           end
         end
       end
@@ -988,8 +1031,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
@@ -997,7 +1040,8 @@ module Google
         # The page token for the next page of shared drives. This will be absent if the
         # end of the list has been reached. If the token is rejected for any reason, it
         # should be discarded, and pagination should be restarted from the first page of
-        # results.
+        # results. The page token is typically valid for several hours. However, if new
+        # items are added or removed, your expected results might differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1014,7 +1058,8 @@ module Google
         end
       end
       
-      # The metadata for a file.
+      # The metadata for a file. Some resource methods (such as `files.update`)
+      # require a `fileId`. Use the `files.list` method to retrieve the ID for a file.
       class File
         include Google::Apis::Core::Hashable
       
@@ -1028,8 +1073,8 @@ module Google
         # @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 may 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
@@ -1063,70 +1108,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. 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.
+        # 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 currently 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
@@ -1136,23 +1180,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 file was created or opened by the requesting app.
+        # 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
@@ -1168,24 +1213,22 @@ 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 the file has been modified by this user.
+        # Output only. Whether the file has been modified by this user.
         # Corresponds to the JSON property `modifiedByMe`
         # @return [Boolean]
         attr_accessor :modified_by_me
@@ -1196,8 +1239,8 @@ module Google
         # @return [DateTime]
         attr_accessor :modified_by_me_time
       
-        # The last time the file was modified by anyone (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
@@ -1210,41 +1253,42 @@ module Google
         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 may 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 which 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
@@ -1255,18 +1299,33 @@ module Google
         # @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
       
-        # Whether the file has been shared. Not populated for items in shared drives.
+        # 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
+      
+        # 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
+      
+        # 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
@@ -1284,19 +1343,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 is applicable to binary files in
-        # Google Drive and Google Docs files.
+        # 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 which 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
@@ -1307,29 +1366,27 @@ 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. If the file isn't shared publicly, the URL
+        # returned in `Files.thumbnailLink` must be fetched using a credentialed request.
         # 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 may 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
@@ -1346,19 +1403,20 @@ 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 may 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 the file has been viewed by this user.
+        # Output only. Whether the file has been viewed by this user.
         # Corresponds to the JSON property `viewedByMe`
         # @return [Boolean]
         attr_accessor :viewed_by_me
@@ -1369,24 +1427,25 @@ module Google
         # @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]
@@ -1438,6 +1497,8 @@ module Google
           @properties = args[:properties] if args.key?(:properties)
           @quota_bytes_used = args[:quota_bytes_used] if args.key?(:quota_bytes_used)
           @resource_key = args[:resource_key] if args.key?(:resource_key)
+          @sha1_checksum = args[:sha1_checksum] if args.key?(:sha1_checksum)
+          @sha256_checksum = args[:sha256_checksum] if args.key?(:sha256_checksum)
           @shared = args[:shared] if args.key?(:shared)
           @shared_with_me_time = args[:shared_with_me_time] if args.key?(:shared_with_me_time)
           @sharing_user = args[:sharing_user] if args.key?(:sharing_user)
@@ -1461,263 +1522,291 @@ 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 may 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 is not 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 is not 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 is 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 is not 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 may 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 is not 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.
+          # Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `
+          # canModifyOwnerContentRestriction` or `canRemoveContentRestriction`.
           # 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 add or modify content restrictions
+          # on the file which are editor restricted.
+          # Corresponds to the JSON property `canModifyEditorContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_modify_editor_content_restriction
+          alias_method :can_modify_editor_content_restriction?, :can_modify_editor_content_restriction
+        
+          # 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 is not a folder. Only populated for
-          # items in shared drives.
+          # Output only. Whether the current user can add or modify content restrictions
+          # which are owner restricted.
+          # Corresponds to the JSON property `canModifyOwnerContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_modify_owner_content_restriction
+          alias_method :can_modify_owner_content_restriction?, :can_modify_owner_content_restriction
+        
+          # 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 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.
+          # 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 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.
+          # 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 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.
+          # 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 is 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 is not 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 there is a content restriction on the file that can be
+          # removed by the current user.
+          # Corresponds to the JSON property `canRemoveContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_remove_content_restriction
+          alias_method :can_remove_content_restriction?, :can_remove_content_restriction
+        
+          # 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 is not 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
@@ -1745,7 +1834,9 @@ module Google
             @can_list_children = args[:can_list_children] if args.key?(:can_list_children)
             @can_modify_content = args[:can_modify_content] if args.key?(:can_modify_content)
             @can_modify_content_restriction = args[:can_modify_content_restriction] if args.key?(:can_modify_content_restriction)
+            @can_modify_editor_content_restriction = args[:can_modify_editor_content_restriction] if args.key?(:can_modify_editor_content_restriction)
             @can_modify_labels = args[:can_modify_labels] if args.key?(:can_modify_labels)
+            @can_modify_owner_content_restriction = args[:can_modify_owner_content_restriction] if args.key?(:can_modify_owner_content_restriction)
             @can_move_children_out_of_drive = args[:can_move_children_out_of_drive] if args.key?(:can_move_children_out_of_drive)
             @can_move_children_out_of_team_drive = args[:can_move_children_out_of_team_drive] if args.key?(:can_move_children_out_of_team_drive)
             @can_move_children_within_drive = args[:can_move_children_within_drive] if args.key?(:can_move_children_within_drive)
@@ -1761,6 +1852,7 @@ module Google
             @can_read_revisions = args[:can_read_revisions] if args.key?(:can_read_revisions)
             @can_read_team_drive = args[:can_read_team_drive] if args.key?(:can_read_team_drive)
             @can_remove_children = args[:can_remove_children] if args.key?(:can_remove_children)
+            @can_remove_content_restriction = args[:can_remove_content_restriction] if args.key?(:can_remove_content_restriction)
             @can_remove_my_drive_parent = args[:can_remove_my_drive_parent] if args.key?(:can_remove_my_drive_parent)
             @can_rename = args[:can_rename] if args.key?(:can_rename)
             @can_share = args[:can_share] if args.key?(:can_share)
@@ -1825,114 +1917,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
@@ -1966,21 +2058,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
@@ -1998,12 +2090,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
@@ -2023,13 +2115,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
@@ -2047,7 +2139,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
         
@@ -2056,14 +2148,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
@@ -2080,22 +2172,22 @@ module Google
           end
         end
         
-        # Additional metadata about video media. This may 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
@@ -2124,17 +2216,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
@@ -2142,7 +2234,8 @@ module Google
         # The page token for the next page of files. This will be absent if the end of
         # the files list has been reached. If the token is rejected for any reason, it
         # should be discarded, and pagination should be restarted from the first page of
-        # results.
+        # results. The page token is typically valid for several hours. However, if new
+        # items are added or removed, your expected results might differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2169,8 +2262,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
@@ -2192,11 +2285,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
@@ -2229,7 +2322,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
       
@@ -2238,12 +2331,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
@@ -2253,28 +2346,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
@@ -2300,7 +2389,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
@@ -2310,28 +2399,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>]
@@ -2360,7 +2449,7 @@ module Google
         end
       end
       
-      # A list of labels.
+      # A list of labels applied to a file.
       class LabelList
         include Google::Apis::Core::Hashable
       
@@ -2377,7 +2466,8 @@ module Google
         # The page token for the next page of labels. This field will be absent if the
         # end of the list has been reached. If the token is rejected for any reason, it
         # should be discarded, and pagination should be restarted from the first page of
-        # results.
+        # results. The page token is typically valid for several hours. However, if new
+        # items are added or removed, your expected results might differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2435,11 +2525,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
@@ -2486,32 +2576,33 @@ module Google
         end
       end
       
-      # A permission for a file. A permission grants a user, group, domain or the
-      # world access to a file or a folder hierarchy.
+      # A permission for a file. A permission grants a user, group, domain, or the
+      # world access to a file or a folder hierarchy. Some resource methods (such as `
+      # permissions.update`) require a `permissionId`. Use the `permissions.list`
+      # method to retrieve the ID for a file, folder, or shared drive.
       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 "thecompany.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
@@ -2527,76 +2618,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 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
+        # 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 are not 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
-        # directly on this item. This is an output-only field which is 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 a 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
@@ -2628,34 +2711,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 possible:
-          # - 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 possible:
-          # - 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
@@ -2677,23 +2754,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
@@ -2716,8 +2793,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
@@ -2725,7 +2802,9 @@ module Google
         # The page token for the next page of permissions. This field will be absent if
         # the end of the permissions list has been reached. If the token is rejected for
         # any reason, it should be discarded, and pagination should be restarted from
-        # the first page of results.
+        # the first page of results. The page token is typically valid for several hours.
+        # However, if new items are added or removed, your expected results might
+        # differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2748,13 +2827,14 @@ module Google
         end
       end
       
-      # A reply to a comment on a file.
+      # A reply to a comment on a file. Some resource methods (such as `replies.update`
+      # ) require a `replyId`. Use the `replies.list` method to retrieve the ID for a
+      # reply.
       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
@@ -2765,8 +2845,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
@@ -2776,24 +2856,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
@@ -2825,8 +2906,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
@@ -2834,7 +2915,8 @@ module Google
         # The page token for the next page of replies. This will be absent if the end of
         # the replies list has been reached. If the token is rejected for any reason, it
         # should be discarded, and pagination should be restarted from the first page of
-        # results.
+        # results. The page token is typically valid for several hours. However, if new
+        # items are added or removed, your expected results might differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2857,16 +2939,18 @@ module Google
         end
       end
       
-      # The metadata for a revision to a file.
+      # The metadata for a revision to a file. Some resource methods (such as `
+      # revisions.update`) require a `revisionId`. Use the `revisions.list` method to
+      # retrieve the ID for a revision.
       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
@@ -2874,15 +2958,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
@@ -2892,13 +2975,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
@@ -2908,8 +2991,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
@@ -2928,8 +3011,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
@@ -2941,8 +3024,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
@@ -2974,8 +3057,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
@@ -2983,7 +3066,8 @@ module Google
         # The page token for the next page of revisions. This will be absent if the end
         # of the revisions list has been reached. If the token is rejected for any
         # reason, it should be discarded, and pagination should be restarted from the
-        # first page of results.
+        # first page of results. The page token is typically valid for several hours.
+        # However, if new items are added or removed, your expected results might differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -3010,13 +3094,14 @@ 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
       
-        # The starting page token for listing changes.
+        # The starting page token for listing future changes. The page token doesn't
+        # expire.
         # Corresponds to the JSON property `startPageToken`
         # @return [String]
         attr_accessor :start_page_token
@@ -3037,9 +3122,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
@@ -3054,8 +3139,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
@@ -3071,8 +3156,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
@@ -3082,8 +3167,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
@@ -3095,11 +3181,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
@@ -3124,9 +3210,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
         
@@ -3183,27 +3269,34 @@ 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.
+          # 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 change the background of this Team Drive.
           # Corresponds to the JSON property `canChangeTeamDriveBackground`
           # @return [Boolean]
           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]
@@ -3267,7 +3360,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
@@ -3312,6 +3405,7 @@ module Google
             @can_add_children = args[:can_add_children] if args.key?(:can_add_children)
             @can_change_copy_requires_writer_permission_restriction = args[:can_change_copy_requires_writer_permission_restriction] if args.key?(:can_change_copy_requires_writer_permission_restriction)
             @can_change_domain_users_only_restriction = args[:can_change_domain_users_only_restriction] if args.key?(:can_change_domain_users_only_restriction)
+            @can_change_sharing_folders_requires_organizer_permission_restriction = args[:can_change_sharing_folders_requires_organizer_permission_restriction] if args.key?(:can_change_sharing_folders_requires_organizer_permission_restriction)
             @can_change_team_drive_background = args[:can_change_team_drive_background] if args.key?(:can_change_team_drive_background)
             @can_change_team_members_only_restriction = args[:can_change_team_members_only_restriction] if args.key?(:can_change_team_members_only_restriction)
             @can_comment = args[:can_comment] if args.key?(:can_comment)
@@ -3346,8 +3440,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
@@ -3362,6 +3456,13 @@ module Google
           attr_accessor :domain_users_only
           alias_method :domain_users_only?, :domain_users_only
         
+          # If true, only users with the organizer role can share folders. If false, users
+          # with either the organizer role or the file organizer role can share folders.
+          # Corresponds to the JSON property `sharingFoldersRequiresOrganizerPermission`
+          # @return [Boolean]
+          attr_accessor :sharing_folders_requires_organizer_permission
+          alias_method :sharing_folders_requires_organizer_permission?, :sharing_folders_requires_organizer_permission
+        
           # Whether access to items inside this Team Drive is restricted to members of
           # this Team Drive.
           # Corresponds to the JSON property `teamMembersOnly`
@@ -3378,6 +3479,7 @@ module Google
             @admin_managed_restrictions = args[:admin_managed_restrictions] if args.key?(:admin_managed_restrictions)
             @copy_requires_writer_permission = args[:copy_requires_writer_permission] if args.key?(:copy_requires_writer_permission)
             @domain_users_only = args[:domain_users_only] if args.key?(:domain_users_only)
+            @sharing_folders_requires_organizer_permission = args[:sharing_folders_requires_organizer_permission] if args.key?(:sharing_folders_requires_organizer_permission)
             @team_members_only = args[:team_members_only] if args.key?(:team_members_only)
           end
         end
@@ -3387,8 +3489,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
@@ -3396,7 +3498,8 @@ module Google
         # The page token for the next page of Team Drives. This will be absent if the
         # end of the Team Drives list has been reached. If the token is rejected for any
         # reason, it should be discarded, and pagination should be restarted from the
-        # first page of results.
+        # first page of results. The page token is typically valid for several hours.
+        # However, if new items are added or removed, your expected results might differ.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -3423,34 +3526,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