RubyGems - google-apis-drive_v3 - Versions diffs - 0.30.0 → 0.61.0 - Mend

google-apis-drive_v3 0.30.0 → 0.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +129 -0
data/OVERVIEW.md +5 -5
data/lib/google/apis/drive_v3/classes.rb +1117 -470
data/lib/google/apis/drive_v3/gem_version.rb +3 -3
data/lib/google/apis/drive_v3/representations.rb +191 -0
data/lib/google/apis/drive_v3/service.rb +716 -438
data/lib/google/apis/drive_v3.rb +9 -4
metadata +11 -11

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

@@ -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
@@ -80,12 +80,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :max_upload_size
-        # The user's storage quota limits and usage. All fields are measured in bytes.
+        # The user's storage quota limits and usage. For users that are part of an
+        # organization with pooled storage, information about the limit and usage across
+        # all services is for the organization, rather than the individual user. All
+        # fields are measured in bytes.
         # Corresponds to the JSON property `storageQuota`
         # @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
@@ -147,17 +150,24 @@ module Google
           end
         end
-        # The user's storage quota limits and usage. All fields are measured in bytes.
+        # The user's storage quota limits and usage. For users that are part of an
+        # organization with pooled storage, information about the limit and usage across
+        # all services is for the organization, rather than the individual user. All
+        # fields are measured in bytes.
         class StorageQuota
           include Google::Apis::Core::Hashable
           # The usage limit, if applicable. This will not be present if the user has
-          # unlimited storage.
+          # unlimited storage. For users that are part of an organization with pooled
+          # storage, this is the limit for the organization, rather than the individual
+          # user.
           # Corresponds to the JSON property `limit`
           # @return [Fixnum]
           attr_accessor :limit
-          # The total usage across all services.
+          # The total usage across all services. For users that are part of an
+          # organization with pooled storage, this is the usage across all services for
+          # the organization, rather than the individual user.
           # Corresponds to the JSON property `usage`
           # @return [Fixnum]
           attr_accessor :usage
@@ -189,17 +199,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
@@ -217,16 +227,349 @@ module Google
         end
       end
+      # The Access Proposal resource for outstanding access proposals on a file
+      class AccessProposal
+        include Google::Apis::Core::Hashable
+        # The creation time
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+        # The file id that the proposal for access is on
+        # Corresponds to the JSON property `fileId`
+        # @return [String]
+        attr_accessor :file_id
+        # The id of the access proposal
+        # Corresponds to the JSON property `proposalId`
+        # @return [String]
+        attr_accessor :proposal_id
+        # The email address of the user that will receive permissions if accepted
+        # Corresponds to the JSON property `recipientEmailAddress`
+        # @return [String]
+        attr_accessor :recipient_email_address
+        # The message that the requester added to the proposal
+        # Corresponds to the JSON property `requestMessage`
+        # @return [String]
+        attr_accessor :request_message
+        # The email address of the requesting user
+        # Corresponds to the JSON property `requesterEmailAddress`
+        # @return [String]
+        attr_accessor :requester_email_address
+        # A wrapper for the role and view of an access proposal.
+        # Corresponds to the JSON property `rolesAndViews`
+        # @return [Array<Google::Apis::DriveV3::AccessProposalRoleAndView>]
+        attr_accessor :roles_and_views
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @file_id = args[:file_id] if args.key?(:file_id)
+          @proposal_id = args[:proposal_id] if args.key?(:proposal_id)
+          @recipient_email_address = args[:recipient_email_address] if args.key?(:recipient_email_address)
+          @request_message = args[:request_message] if args.key?(:request_message)
+          @requester_email_address = args[:requester_email_address] if args.key?(:requester_email_address)
+          @roles_and_views = args[:roles_and_views] if args.key?(:roles_and_views)
+        end
+      end
+      # A wrapper for the role and view of an access proposal.
+      class AccessProposalRoleAndView
+        include Google::Apis::Core::Hashable
+        # The role that was proposed by the requester New values may be added in the
+        # future, but the following are currently possible: * `writer` * `commenter` * `
+        # reader`
+        # Corresponds to the JSON property `role`
+        # @return [String]
+        attr_accessor :role
+        # Indicates the view for this access proposal. Only populated for proposals that
+        # belong to a view. `published` is the only supported value.
+        # Corresponds to the JSON property `view`
+        # @return [String]
+        attr_accessor :view
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @role = args[:role] if args.key?(:role)
+          @view = args[:view] if args.key?(:view)
+        end
+      end
+      # The `apps` resource provides a list of apps that a user has installed, with
+      # information about each app's supported MIME types, file extensions, and other
+      # details. Some resource methods (such as `apps.get`) require an `appId`. Use
+      # the `apps.list` method to retrieve the ID for an installed application.
+      class App
+        include Google::Apis::Core::Hashable
+        # Whether the app is authorized to access data on the user's Drive.
+        # Corresponds to the JSON property `authorized`
+        # @return [Boolean]
+        attr_accessor :authorized
+        alias_method :authorized?, :authorized
+        # The template URL to create a file with this app in a given folder. The
+        # template contains the `folderId` to be replaced by the folder ID house the new
+        # file.
+        # Corresponds to the JSON property `createInFolderTemplate`
+        # @return [String]
+        attr_accessor :create_in_folder_template
+        # The URL to create a file with this app.
+        # Corresponds to the JSON property `createUrl`
+        # @return [String]
+        attr_accessor :create_url
+        # Whether the app has Drive-wide scope. An app with Drive-wide scope can access
+        # all files in the user's Drive.
+        # Corresponds to the JSON property `hasDriveWideScope`
+        # @return [Boolean]
+        attr_accessor :has_drive_wide_scope
+        alias_method :has_drive_wide_scope?, :has_drive_wide_scope
+        # The various icons for the app.
+        # Corresponds to the JSON property `icons`
+        # @return [Array<Google::Apis::DriveV3::AppIcons>]
+        attr_accessor :icons
+        # The ID of the app.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+        # Whether the app is installed.
+        # Corresponds to the JSON property `installed`
+        # @return [Boolean]
+        attr_accessor :installed
+        alias_method :installed?, :installed
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # "drive#app".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+        # A long description of the app.
+        # Corresponds to the JSON property `longDescription`
+        # @return [String]
+        attr_accessor :long_description
+        # The name of the app.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+        # The type of object this app creates such as a Chart. If empty, the app name
+        # should be used instead.
+        # Corresponds to the JSON property `objectType`
+        # @return [String]
+        attr_accessor :object_type
+        # The template URL for opening files with this app. The template contains `ids`
+        # or `exportIds` to be replaced by the actual file IDs. For more information,
+        # see Open Files for the full documentation.
+        # Corresponds to the JSON property `openUrlTemplate`
+        # @return [String]
+        attr_accessor :open_url_template
+        # The list of primary file extensions.
+        # Corresponds to the JSON property `primaryFileExtensions`
+        # @return [Array<String>]
+        attr_accessor :primary_file_extensions
+        # The list of primary MIME types.
+        # Corresponds to the JSON property `primaryMimeTypes`
+        # @return [Array<String>]
+        attr_accessor :primary_mime_types
+        # The ID of the product listing for this app.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+        # A link to the product listing for this app.
+        # Corresponds to the JSON property `productUrl`
+        # @return [String]
+        attr_accessor :product_url
+        # The list of secondary file extensions.
+        # Corresponds to the JSON property `secondaryFileExtensions`
+        # @return [Array<String>]
+        attr_accessor :secondary_file_extensions
+        # The list of secondary MIME types.
+        # Corresponds to the JSON property `secondaryMimeTypes`
+        # @return [Array<String>]
+        attr_accessor :secondary_mime_types
+        # A short description of the app.
+        # Corresponds to the JSON property `shortDescription`
+        # @return [String]
+        attr_accessor :short_description
+        # Whether this app supports creating objects.
+        # Corresponds to the JSON property `supportsCreate`
+        # @return [Boolean]
+        attr_accessor :supports_create
+        alias_method :supports_create?, :supports_create
+        # Whether this app supports importing from Google Docs.
+        # Corresponds to the JSON property `supportsImport`
+        # @return [Boolean]
+        attr_accessor :supports_import
+        alias_method :supports_import?, :supports_import
+        # Whether this app supports opening more than one file.
+        # Corresponds to the JSON property `supportsMultiOpen`
+        # @return [Boolean]
+        attr_accessor :supports_multi_open
+        alias_method :supports_multi_open?, :supports_multi_open
+        # Whether this app supports creating files when offline.
+        # Corresponds to the JSON property `supportsOfflineCreate`
+        # @return [Boolean]
+        attr_accessor :supports_offline_create
+        alias_method :supports_offline_create?, :supports_offline_create
+        # Whether the app is selected as the default handler for the types it supports.
+        # Corresponds to the JSON property `useByDefault`
+        # @return [Boolean]
+        attr_accessor :use_by_default
+        alias_method :use_by_default?, :use_by_default
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @authorized = args[:authorized] if args.key?(:authorized)
+          @create_in_folder_template = args[:create_in_folder_template] if args.key?(:create_in_folder_template)
+          @create_url = args[:create_url] if args.key?(:create_url)
+          @has_drive_wide_scope = args[:has_drive_wide_scope] if args.key?(:has_drive_wide_scope)
+          @icons = args[:icons] if args.key?(:icons)
+          @id = args[:id] if args.key?(:id)
+          @installed = args[:installed] if args.key?(:installed)
+          @kind = args[:kind] if args.key?(:kind)
+          @long_description = args[:long_description] if args.key?(:long_description)
+          @name = args[:name] if args.key?(:name)
+          @object_type = args[:object_type] if args.key?(:object_type)
+          @open_url_template = args[:open_url_template] if args.key?(:open_url_template)
+          @primary_file_extensions = args[:primary_file_extensions] if args.key?(:primary_file_extensions)
+          @primary_mime_types = args[:primary_mime_types] if args.key?(:primary_mime_types)
+          @product_id = args[:product_id] if args.key?(:product_id)
+          @product_url = args[:product_url] if args.key?(:product_url)
+          @secondary_file_extensions = args[:secondary_file_extensions] if args.key?(:secondary_file_extensions)
+          @secondary_mime_types = args[:secondary_mime_types] if args.key?(:secondary_mime_types)
+          @short_description = args[:short_description] if args.key?(:short_description)
+          @supports_create = args[:supports_create] if args.key?(:supports_create)
+          @supports_import = args[:supports_import] if args.key?(:supports_import)
+          @supports_multi_open = args[:supports_multi_open] if args.key?(:supports_multi_open)
+          @supports_offline_create = args[:supports_offline_create] if args.key?(:supports_offline_create)
+          @use_by_default = args[:use_by_default] if args.key?(:use_by_default)
+        end
+      end
+      #
+      class AppIcons
+        include Google::Apis::Core::Hashable
+        # Category of the icon. Allowed values are: * `application` - The icon for the
+        # application. * `document` - The icon for a file associated with the app. * `
+        # documentShared` - The icon for a shared file associated with the app.
+        # Corresponds to the JSON property `category`
+        # @return [String]
+        attr_accessor :category
+        # URL for the icon.
+        # Corresponds to the JSON property `iconUrl`
+        # @return [String]
+        attr_accessor :icon_url
+        # Size of the icon. Represented as the maximum of the width and height.
+        # Corresponds to the JSON property `size`
+        # @return [Fixnum]
+        attr_accessor :size
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @category = args[:category] if args.key?(:category)
+          @icon_url = args[:icon_url] if args.key?(:icon_url)
+          @size = args[:size] if args.key?(:size)
+        end
+      end
+      # A list of third-party applications which the user has installed or given
+      # access to Google Drive.
+      class AppList
+        include Google::Apis::Core::Hashable
+        # The list of app IDs that the user has specified to use by default. The list is
+        # in reverse-priority order (lowest to highest).
+        # Corresponds to the JSON property `defaultAppIds`
+        # @return [Array<String>]
+        attr_accessor :default_app_ids
+        # The list of apps.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::DriveV3::App>]
+        attr_accessor :items
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # "drive#appList".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+        # A link back to this list.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @default_app_ids = args[:default_app_ids] if args.key?(:default_app_ids)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @self_link = args[:self_link] if args.key?(:self_link)
+        end
+      end
       # A change to a file or shared drive.
       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 +579,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 +590,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 +608,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 +618,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 +653,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 +685,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 +706,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
@@ -397,8 +740,7 @@ module Google
         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.
+        # web_hook" or "webhook".
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -422,12 +764,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 +783,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 +793,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 +829,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 +899,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 +908,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 +930,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 +947,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 +963,16 @@ module Google
         # @return [DateTime]
         attr_accessor :restriction_time
-        # The type of the content restriction. Currently the only possible value is
-        # globalContentRestriction.
+        # Output only. Whether the content restriction was applied by the system, for
+        # example due to an esignature. Users cannot modify or remove system restricted
+        # content restrictions.
+        # Corresponds to the JSON property `systemRestricted`
+        # @return [Boolean]
+        attr_accessor :system_restricted
+        alias_method :system_restricted?, :system_restricted
+        # 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,38 +983,42 @@ 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)
           @restriction_time = args[:restriction_time] if args.key?(:restriction_time)
+          @system_restricted = args[:system_restricted] if args.key?(:system_restricted)
           @type = args[:type] if args.key?(:type)
         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 +1034,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,23 +1051,27 @@ 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
         # A set of restrictions that apply to this shared drive or items inside this
-        # shared drive.
+        # shared drive. Note that restrictions can't be set when creating a shared drive.
+        # To add a restriction, first create a shared drive and then use `drives.update`
+        # to add restrictions.
         # Corresponds to the JSON property `restrictions`
         # @return [Google::Apis::DriveV3::Drive::Restrictions]
         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 +1097,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 +1146,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 +1298,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)
@@ -929,7 +1317,9 @@ module Google
         end
         # A set of restrictions that apply to this shared drive or items inside this
-        # shared drive.
+        # shared drive. Note that restrictions can't be set when creating a shared drive.
+        # To add a restriction, first create a shared drive and then use `drives.update`
+        # to add restrictions.
         class Restrictions
           include Google::Apis::Core::Hashable
@@ -942,7 +1332,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 +1354,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 +1371,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 +1386,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 +1395,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 +1413,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 +1428,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 +1463,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 +1535,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 +1568,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 +1594,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 +1608,43 @@ 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 ID of the parent folder containing the file. A file can only have one
+        # parent folder; specifying multiple parents isn't supported. 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 parent 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,32 +1655,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
-        # 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.
+        # Output only. The SHA1 checksum associated with this file, if available. This
+        # field is only populated for files with content stored in Google Drive; it is
+        # not populated for Docs Editors or shortcut files.
         # Corresponds to the JSON property `sha1Checksum`
         # @return [String]
         attr_accessor :sha1_checksum
-        # The SHA256 checksum associated with this file, if available. This field is
-        # only populated for files with content stored in Google Drive; it is not
-        # populated for Docs Editors or shortcut files.
+        # Output only. The SHA256 checksum associated with this file, if available. This
+        # field is only populated for files with content stored in Google Drive; it is
+        # not populated for Docs Editors or shortcut files.
         # Corresponds to the JSON property `sha256Checksum`
         # @return [String]
         attr_accessor :sha256_checksum
-        # Whether the file has been shared. Not populated for items in shared drives.
+        # Output only. Whether the file has been shared. Not populated for items in
+        # shared drives.
         # Corresponds to the JSON property `shared`
         # @return [Boolean]
         attr_accessor :shared
@@ -1298,19 +1699,20 @@ 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`. Can only be set
+        # on `files.create` requests.
         # 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
@@ -1321,29 +1723,30 @@ 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. Not intended for direct usage on web
+        # applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.
+        # mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider using a proxy server.
+        # 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
@@ -1360,19 +1763,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
@@ -1383,24 +1787,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]
@@ -1477,263 +1882,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
@@ -1761,7 +2194,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)
@@ -1777,6 +2212,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)
@@ -1841,114 +2277,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
@@ -1982,21 +2418,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
@@ -2014,12 +2450,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
@@ -2039,13 +2475,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
@@ -2063,23 +2499,25 @@ 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`. Can only be set
+        # on `files.create` requests.
         class ShortcutDetails
           include Google::Apis::Core::Hashable
-          # The ID of the file that this shortcut points to.
+          # The ID of the file that this shortcut points to. Can only be set on `files.
+          # create` requests.
           # Corresponds to the JSON property `targetId`
           # @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
@@ -2096,22 +2534,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
@@ -2140,17 +2578,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
@@ -2158,7 +2596,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
@@ -2185,8 +2624,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
@@ -2208,11 +2647,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
@@ -2245,7 +2684,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
@@ -2254,12 +2693,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
@@ -2269,28 +2708,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
@@ -2316,7 +2751,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
@@ -2326,28 +2761,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>]
@@ -2376,7 +2811,7 @@ module Google
         end
       end
-      # A list of labels.
+      # A list of labels applied to a file.
       class LabelList
         include Google::Apis::Core::Hashable
@@ -2393,7 +2828,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
@@ -2450,12 +2886,65 @@ module Google
         end
       end
+      # The response to an Access Proposal list request.
+      class ListAccessProposalsResponse
+        include Google::Apis::Core::Hashable
+        # The list of Access Proposals. This field is only populated in v3 and v3beta.
+        # Corresponds to the JSON property `accessProposals`
+        # @return [Array<Google::Apis::DriveV3::AccessProposal>]
+        attr_accessor :access_proposals
+        # The continuation token for the next page of results. This will be absent if
+        # the end of the results 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.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @access_proposals = args[:access_proposals] if args.key?(:access_proposals)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      # The response message for Operations.ListOperations.
+      class ListOperationsResponse
+        include Google::Apis::Core::Hashable
+        # The standard List next-page token.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+        # A list of operations that matches the specified filter in the request.
+        # Corresponds to the JSON property `operations`
+        # @return [Array<Google::Apis::DriveV3::Operation>]
+        attr_accessor :operations
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @operations = args[:operations] if args.key?(:operations)
+        end
+      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
@@ -2502,32 +2991,98 @@ 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.
+      # This resource represents a long-running operation that is the result of a
+      # network API call.
+      class Operation
+        include Google::Apis::Core::Hashable
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
+        # Corresponds to the JSON property `done`
+        # @return [Boolean]
+        attr_accessor :done
+        alias_method :done?, :done
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
+        # Corresponds to the JSON property `error`
+        # @return [Google::Apis::DriveV3::Status]
+        attr_accessor :error
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,Object>]
+        attr_accessor :metadata
+        # The server-assigned name, which is only unique within the same service that
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+        # The normal, successful response of the operation. If the original method
+        # returns no data on success, such as `Delete`, the response is `google.protobuf.
+        # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
+        # response should be the resource. For other methods, the response should have
+        # the type `XxxResponse`, where `Xxx` is the original method name. For example,
+        # if the original method name is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
+        # Corresponds to the JSON property `response`
+        # @return [Hash<String,Object>]
+        attr_accessor :response
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @done = args[:done] if args.key?(:done)
+          @error = args[:error] if args.key?(:error)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @name = args[:name] if args.key?(:name)
+          @response = args[:response] if args.key?(:response)
+        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. By default, permissions requests
+      # only return a subset of fields. Permission kind, ID, type, and role are always
+      # returned. To retrieve specific fields, see https://developers.google.com/drive/
+      # api/guides/fields-parameter. 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
@@ -2543,77 +3098,68 @@ module Google
         attr_accessor :email_address
         # The time at which this permission will expire (RFC 3339 date-time). Expiration
-        # times have the following restrictions:
-        # - They cannot be set on shared drive items
-        # - They can only be set on user and group permissions
-        # - The time must be in the future
-        # - The time cannot be more than 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
@@ -2645,34 +3191,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
@@ -2694,23 +3234,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
@@ -2733,8 +3273,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
@@ -2742,7 +3282,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
@@ -2765,13 +3307,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
@@ -2782,8 +3325,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
@@ -2793,24 +3336,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
@@ -2842,8 +3386,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
@@ -2851,7 +3395,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
@@ -2874,16 +3419,59 @@ module Google
         end
       end
-      # The metadata for a revision to a file.
+      # Request message for resolving an AccessProposal on a file.
+      class ResolveAccessProposalRequest
+        include Google::Apis::Core::Hashable
+        # Required. The action to take on the AccessProposal.
+        # Corresponds to the JSON property `action`
+        # @return [String]
+        attr_accessor :action
+        # Optional. The roles the approver has allowed, if any. Note: This field is
+        # required for the `ACCEPT` action.
+        # Corresponds to the JSON property `role`
+        # @return [Array<String>]
+        attr_accessor :role
+        # Optional. Whether to send an email to the requester when the AccessProposal is
+        # denied or accepted.
+        # Corresponds to the JSON property `sendNotification`
+        # @return [Boolean]
+        attr_accessor :send_notification
+        alias_method :send_notification?, :send_notification
+        # Optional. Indicates the view for this access proposal. This should only be set
+        # when the proposal belongs to a view. `published` is the only supported value.
+        # Corresponds to the JSON property `view`
+        # @return [String]
+        attr_accessor :view
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @action = args[:action] if args.key?(:action)
+          @role = args[:role] if args.key?(:role)
+          @send_notification = args[:send_notification] if args.key?(:send_notification)
+          @view = args[:view] if args.key?(:view)
+        end
+      end
+      # 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
@@ -2891,15 +3479,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
@@ -2909,13 +3496,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
@@ -2925,8 +3512,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
@@ -2945,8 +3532,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
@@ -2958,8 +3545,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
@@ -2991,8 +3578,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
@@ -3000,7 +3587,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
@@ -3027,13 +3615,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
@@ -3049,14 +3638,53 @@ module Google
         end
       end
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
+      class Status
+        include Google::Apis::Core::Hashable
+        # The status code, which should be an enum value of google.rpc.Code.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+        # A list of messages that carry the error details. There is a common set of
+        # message types for APIs to use.
+        # Corresponds to the JSON property `details`
+        # @return [Array<Hash<String,Object>>]
+        attr_accessor :details
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @details = args[:details] if args.key?(:details)
+          @message = args[:message] if args.key?(:message)
+        end
+      end
       # Deprecated: use the drive collection instead.
       class TeamDrive
         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
@@ -3071,8 +3699,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
@@ -3088,8 +3716,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
@@ -3099,8 +3727,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
@@ -3112,11 +3741,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
@@ -3141,9 +3770,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
@@ -3200,27 +3829,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]
@@ -3284,7 +3920,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
@@ -3329,6 +3965,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)
@@ -3363,8 +4000,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
@@ -3379,6 +4016,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`
@@ -3395,6 +4039,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
@@ -3404,8 +4049,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
@@ -3413,7 +4058,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
@@ -3440,34 +4086,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