google-api-client 0.42.0 → 0.44.1

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

@@ -44,8 +44,8 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://www.googleapis.com/', '')
-          @batch_path = 'batch/doubleclicksearch/v2'
+          super('https://doubleclicksearch.googleapis.com/', '')
+          @batch_path = 'batch'
         end
         
         # Retrieves a list of conversions from a DoubleClick Search engine account.
@@ -60,8 +60,7 @@ module Google
         # @param [Fixnum] row_count
         #   The number of conversions to return per call.
         # @param [Fixnum] start_date
-        #   First date (inclusive) on which to retrieve conversions. Format is
-        #   yyyymmdd.
+        #   First date (inclusive) on which to retrieve conversions. Format is yyyymmdd.
         # @param [Fixnum] start_row
         #   The 0-based starting index for retrieving conversions results.
         # @param [Fixnum] ad_group_id
@@ -169,8 +168,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the availabilities of a batch of floodlight activities in
-        # DoubleClick Search.
+        # Updates the availabilities of a batch of floodlight activities in DoubleClick
+        # Search.
         # @param [Google::Apis::DoubleclicksearchV2::UpdateAvailabilityRequest] update_availability_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/drive_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/drive/
     module DriveV2
       VERSION = 'V2'
-      REVISION = '20200618'
+      REVISION = '20200813'
 
       # See, edit, create, and delete all of your Google Drive files
       AUTH_DRIVE = 'https://www.googleapis.com/auth/drive'

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

@@ -1340,6 +1340,55 @@ module Google
         end
       end
       
+      # A restriction for accessing the content of the file.
+      class ContentRestriction
+        include Google::Apis::Core::Hashable
+      
+        # 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.
+        # Corresponds to the JSON property `readOnly`
+        # @return [Boolean]
+        attr_accessor :read_only
+        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.
+        # Corresponds to the JSON property `reason`
+        # @return [String]
+        attr_accessor :reason
+      
+        # Information about a Drive user.
+        # Corresponds to the JSON property `restrictingUser`
+        # @return [Google::Apis::DriveV2::User]
+        attr_accessor :restricting_user
+      
+        # The time at which the content restriction was set (formatted RFC 3339
+        # timestamp). Only populated if readOnly is true.
+        # Corresponds to the JSON property `restrictionDate`
+        # @return [DateTime]
+        attr_accessor :restriction_date
+      
+        # The type of the content restriction. Currently the only possible value is
+        # globalContentRestriction.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @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_date = args[:restriction_date] if args.key?(:restriction_date)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # Representation of a shared drive.
       class Drive
         include Google::Apis::Core::Hashable
@@ -1743,6 +1792,12 @@ module Google
         # @return [Google::Apis::DriveV2::File::Capabilities]
         attr_accessor :capabilities
       
+        # Restrictions for accessing the content of the file. Only populated if such a
+        # restriction exists.
+        # Corresponds to the JSON property `contentRestrictions`
+        # @return [Array<Google::Apis::DriveV2::ContentRestriction>]
+        attr_accessor :content_restrictions
+      
         # Whether the options to copy, print, or download this file, should be disabled
         # for readers and commenters.
         # Corresponds to the JSON property `copyRequiresWriterPermission`
@@ -2140,6 +2195,7 @@ module Google
           @can_comment = args[:can_comment] if args.key?(:can_comment)
           @can_read_revisions = args[:can_read_revisions] if args.key?(:can_read_revisions)
           @capabilities = args[:capabilities] if args.key?(:capabilities)
+          @content_restrictions = args[:content_restrictions] if args.key?(:content_restrictions)
           @copy_requires_writer_permission = args[:copy_requires_writer_permission] if args.key?(:copy_requires_writer_permission)
           @copyable = args[:copyable] if args.key?(:copyable)
           @created_date = args[:created_date] if args.key?(:created_date)
@@ -2300,6 +2356,12 @@ module Google
           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.
+          # 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 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.
@@ -2314,9 +2376,10 @@ module Google
           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 the shared
-          # drive. This is false when the item is not a folder. Only populated for items
-          # in shared drives.
+          # 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
@@ -2348,9 +2411,9 @@ module Google
           attr_accessor :can_move_item_out_of_team_drive
           alias_method :can_move_item_out_of_team_drive?, :can_move_item_out_of_team_drive
         
-          # Whether the current user can move this item within this shared drive. Note
-          # that a request to change the parent of the item may still fail depending on
-          # the new parent that is being added. Only populated for items in shared drives.
+          # 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
@@ -2454,6 +2517,7 @@ module Google
             @can_edit = args[:can_edit] if args.key?(:can_edit)
             @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_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)
@@ -2698,8 +2762,11 @@ module Google
           attr_accessor :starred
           alias_method :starred?, :starred
         
-          # Whether this file has been trashed. This label applies to all users accessing
-          # the file; however, only owners are allowed to see and untrash files.
+          # 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.
           # Corresponds to the JSON property `trashed`
           # @return [Boolean]
           attr_accessor :trashed
@@ -3109,6 +3176,12 @@ module Google
         # @return [String]
         attr_accessor :value
       
+        # Indicates the view for this permission. Only populated for permissions that
+        # belong to a view. published is the only supported value.
+        # Corresponds to the JSON property `view`
+        # @return [String]
+        attr_accessor :view
+      
         # Whether the link is required for this permission.
         # Corresponds to the JSON property `withLink`
         # @return [Boolean]
@@ -3138,6 +3211,7 @@ module Google
           @team_drive_permission_details = args[:team_drive_permission_details] if args.key?(:team_drive_permission_details)
           @type = args[:type] if args.key?(:type)
           @value = args[:value] if args.key?(:value)
+          @view = args[:view] if args.key?(:view)
           @with_link = args[:with_link] if args.key?(:with_link)
         end
         

data/generated/google/apis/drive_v2/representations.rb

@@ -160,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ContentRestriction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Drive
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -693,6 +699,19 @@ module Google
         end
       end
       
+      class ContentRestriction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :read_only, as: 'readOnly'
+          property :reason, as: 'reason'
+          property :restricting_user, as: 'restrictingUser', class: Google::Apis::DriveV2::User, decorator: Google::Apis::DriveV2::User::Representation
+      
+          property :restriction_date, as: 'restrictionDate', type: DateTime
+      
+          property :type, as: 'type'
+        end
+      end
+      
       class Drive
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -777,6 +796,8 @@ module Google
           property :can_read_revisions, as: 'canReadRevisions'
           property :capabilities, as: 'capabilities', class: Google::Apis::DriveV2::File::Capabilities, decorator: Google::Apis::DriveV2::File::Capabilities::Representation
       
+          collection :content_restrictions, as: 'contentRestrictions', class: Google::Apis::DriveV2::ContentRestriction, decorator: Google::Apis::DriveV2::ContentRestriction::Representation
+      
           property :copy_requires_writer_permission, as: 'copyRequiresWriterPermission'
           property :copyable, as: 'copyable'
           property :created_date, as: 'createdDate', type: DateTime
@@ -880,6 +901,7 @@ module Google
             property :can_edit, as: 'canEdit'
             property :can_list_children, as: 'canListChildren'
             property :can_modify_content, as: 'canModifyContent'
+            property :can_modify_content_restriction, as: 'canModifyContentRestriction'
             property :can_move_children_out_of_drive, as: 'canMoveChildrenOutOfDrive'
             property :can_move_children_out_of_team_drive, as: 'canMoveChildrenOutOfTeamDrive'
             property :can_move_children_within_drive, as: 'canMoveChildrenWithinDrive'
@@ -1053,6 +1075,7 @@ module Google
       
           property :type, as: 'type'
           property :value, as: 'value'
+          property :view, as: 'view'
           property :with_link, as: 'withLink'
         end
         

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

@@ -278,6 +278,9 @@ module Google
         #   list of changes, for example by deletion or loss of access.
         # @param [Boolean] include_items_from_all_drives
         #   Whether both My Drive and shared drive items should be included in results.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] include_subscribed
         #   Whether to include changes outside the My Drive hierarchy in the result. When
         #   set to false, changes to files such as those in the Application Data folder or
@@ -320,7 +323,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_changes(drive_id: nil, include_corpus_removals: nil, include_deleted: nil, include_items_from_all_drives: nil, include_subscribed: nil, include_team_drive_items: nil, max_results: nil, page_token: nil, spaces: nil, start_change_id: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_changes(drive_id: nil, include_corpus_removals: nil, include_deleted: nil, include_items_from_all_drives: nil, include_permissions_for_view: nil, include_subscribed: nil, include_team_drive_items: nil, max_results: nil, page_token: nil, spaces: nil, start_change_id: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, 'changes', options)
           command.response_representation = Google::Apis::DriveV2::ChangeList::Representation
           command.response_class = Google::Apis::DriveV2::ChangeList
@@ -328,6 +331,7 @@ module Google
           command.query['includeCorpusRemovals'] = include_corpus_removals unless include_corpus_removals.nil?
           command.query['includeDeleted'] = include_deleted unless include_deleted.nil?
           command.query['includeItemsFromAllDrives'] = include_items_from_all_drives unless include_items_from_all_drives.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['includeSubscribed'] = include_subscribed unless include_subscribed.nil?
           command.query['includeTeamDriveItems'] = include_team_drive_items unless include_team_drive_items.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
@@ -359,6 +363,9 @@ module Google
         #   list of changes, for example by deletion or loss of access.
         # @param [Boolean] include_items_from_all_drives
         #   Whether both My Drive and shared drive items should be included in results.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] include_subscribed
         #   Whether to include changes outside the My Drive hierarchy in the result. When
         #   set to false, changes to files such as those in the Application Data folder or
@@ -401,7 +408,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def watch_change(channel_object = nil, drive_id: nil, include_corpus_removals: nil, include_deleted: nil, include_items_from_all_drives: nil, include_subscribed: nil, include_team_drive_items: nil, max_results: nil, page_token: nil, spaces: nil, start_change_id: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def watch_change(channel_object = nil, drive_id: nil, include_corpus_removals: nil, include_deleted: nil, include_items_from_all_drives: nil, include_permissions_for_view: nil, include_subscribed: nil, include_team_drive_items: nil, max_results: nil, page_token: nil, spaces: nil, start_change_id: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'changes/watch', options)
           command.request_representation = Google::Apis::DriveV2::Channel::Representation
           command.request_object = channel_object
@@ -411,6 +418,7 @@ module Google
           command.query['includeCorpusRemovals'] = include_corpus_removals unless include_corpus_removals.nil?
           command.query['includeDeleted'] = include_deleted unless include_deleted.nil?
           command.query['includeItemsFromAllDrives'] = include_items_from_all_drives unless include_items_from_all_drives.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['includeSubscribed'] = include_subscribed unless include_subscribed.nil?
           command.query['includeTeamDriveItems'] = include_team_drive_items unless include_team_drive_items.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
@@ -1131,7 +1139,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a copy of the specified file.
+        # Creates a copy of the specified file. Folders cannot be copied.
         # @param [String] file_id
         #   The ID of the file to copy.
         # @param [Google::Apis::DriveV2::File] file_object
@@ -1141,6 +1149,9 @@ module Google
         #   Set to true to opt in to API behavior that aims for all items to have exactly
         #   one parent. This parameter only takes effect if the item is not in a shared
         #   drive. Requests that specify more than one parent fail.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] ocr
         #   Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
         # @param [String] ocr_language
@@ -1178,7 +1189,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def copy_file(file_id, file_object = nil, convert: nil, enforce_single_parent: nil, ocr: nil, ocr_language: nil, pinned: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, visibility: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def copy_file(file_id, file_object = nil, convert: nil, enforce_single_parent: nil, include_permissions_for_view: nil, ocr: nil, ocr_language: nil, pinned: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, visibility: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'files/{fileId}/copy', options)
           command.request_representation = Google::Apis::DriveV2::File::Representation
           command.request_object = file_object
@@ -1187,6 +1198,7 @@ module Google
           command.params['fileId'] = file_id unless file_id.nil?
           command.query['convert'] = convert unless convert.nil?
           command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['ocr'] = ocr unless ocr.nil?
           command.query['ocrLanguage'] = ocr_language unless ocr_language.nil?
           command.query['pinned'] = pinned unless pinned.nil?
@@ -1205,6 +1217,11 @@ module Google
         # user must own the file or be an organizer on the parent for shared drive files.
         # @param [String] file_id
         #   The ID of the file to delete.
+        # @param [Boolean] enforce_single_parent
+        #   Set to true to opt in to API behavior that aims for all items to have exactly
+        #   one parent. This parameter will only take effect if the item is not in a
+        #   shared drive. If an item's last parent is deleted but the item itself is not,
+        #   the item will be placed under its owner's root.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1228,9 +1245,10 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_file(file_id, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def delete_file(file_id, enforce_single_parent: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:delete, 'files/{fileId}', options)
           command.params['fileId'] = file_id unless file_id.nil?
+          command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?
           command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -1240,6 +1258,11 @@ module Google
         end
         
         # Permanently deletes all of the user's trashed files.
+        # @param [Boolean] enforce_single_parent
+        #   Set to true to opt in to API behavior that aims for all items to have exactly
+        #   one parent. This parameter will only take effect if the item is not in a
+        #   shared drive. If an item's last parent is deleted but the item itself is not,
+        #   the item will be placed under its owner's root.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1259,8 +1282,9 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def empty_trash(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def empty_trash(enforce_single_parent: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:delete, 'files/trash', options)
+          command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['userIp'] = user_ip unless user_ip.nil?
@@ -1352,6 +1376,9 @@ module Google
         # @param [Boolean] acknowledge_abuse
         #   Whether the user is acknowledging the risk of downloading known malware or
         #   other abusive files.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [String] projection
         #   This parameter is deprecated and has no function.
         # @param [String] revision_id
@@ -1385,7 +1412,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_file(file_id, acknowledge_abuse: nil, projection: nil, revision_id: nil, supports_all_drives: nil, supports_team_drives: nil, update_viewed_date: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
+        def get_file(file_id, acknowledge_abuse: nil, include_permissions_for_view: nil, projection: nil, revision_id: nil, supports_all_drives: nil, supports_team_drives: nil, update_viewed_date: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
           if download_dest.nil?
             command = make_simple_command(:get, 'files/{fileId}', options)
           else
@@ -1396,6 +1423,7 @@ module Google
           command.response_class = Google::Apis::DriveV2::File
           command.params['fileId'] = file_id unless file_id.nil?
           command.query['acknowledgeAbuse'] = acknowledge_abuse unless acknowledge_abuse.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['projection'] = projection unless projection.nil?
           command.query['revisionId'] = revision_id unless revision_id.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?
@@ -1415,6 +1443,9 @@ module Google
         #   Set to true to opt in to API behavior that aims for all items to have exactly
         #   one parent. This parameter only takes effect if the item is not in a shared
         #   drive. Requests that specify more than one parent fail.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] ocr
         #   Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
         # @param [String] ocr_language
@@ -1458,7 +1489,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def insert_file(file_object = nil, convert: nil, enforce_single_parent: nil, ocr: nil, ocr_language: nil, pinned: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, use_content_as_indexable_text: nil, visibility: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def insert_file(file_object = nil, convert: nil, enforce_single_parent: nil, include_permissions_for_view: nil, ocr: nil, ocr_language: nil, pinned: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, use_content_as_indexable_text: nil, visibility: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
             command = make_simple_command(:post, 'files', options)
           else
@@ -1472,6 +1503,7 @@ module Google
           command.response_class = Google::Apis::DriveV2::File
           command.query['convert'] = convert unless convert.nil?
           command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['ocr'] = ocr unless ocr.nil?
           command.query['ocrLanguage'] = ocr_language unless ocr_language.nil?
           command.query['pinned'] = pinned unless pinned.nil?
@@ -1489,9 +1521,12 @@ module Google
         
         # Lists the user's files.
         # @param [String] corpora
-        #   Bodies of items (files/documents) to which the query applies. Supported bodies
-        #   are 'default', 'domain', 'drive' and 'allDrives'. Prefer 'default' or 'drive'
-        #   to 'allDrives' for efficiency.
+        #   Groupings of files to which the query applies. Supported groupings are: 'user'
+        #   (files created by, opened by, or shared directly with the user), 'drive' (
+        #   files in the specified shared drive as indicated by the 'driveId'), 'domain' (
+        #   files shared to the user's domain), and 'allDrives' (A combination of 'user'
+        #   and 'drive' for all drives where the user is a member). When able, use 'user'
+        #   or 'drive', instead of 'allDrives', for efficiency.
         # @param [String] corpus
         #   The body of items (files/documents) to which the query applies. Deprecated:
         #   use 'corpora' instead.
@@ -1499,6 +1534,9 @@ module Google
         #   ID of the shared drive to search.
         # @param [Boolean] include_items_from_all_drives
         #   Whether both My Drive and shared drive items should be included in results.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] include_team_drive_items
         #   Deprecated use includeItemsFromAllDrives instead.
         # @param [Fixnum] max_results
@@ -1546,7 +1584,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_files(corpora: nil, corpus: nil, drive_id: nil, include_items_from_all_drives: nil, include_team_drive_items: nil, max_results: nil, order_by: nil, page_token: nil, projection: nil, q: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_files(corpora: nil, corpus: nil, drive_id: nil, include_items_from_all_drives: nil, include_permissions_for_view: nil, include_team_drive_items: nil, max_results: nil, order_by: nil, page_token: nil, projection: nil, q: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, 'files', options)
           command.response_representation = Google::Apis::DriveV2::FileList::Representation
           command.response_class = Google::Apis::DriveV2::FileList
@@ -1554,6 +1592,7 @@ module Google
           command.query['corpus'] = corpus unless corpus.nil?
           command.query['driveId'] = drive_id unless drive_id.nil?
           command.query['includeItemsFromAllDrives'] = include_items_from_all_drives unless include_items_from_all_drives.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['includeTeamDriveItems'] = include_team_drive_items unless include_team_drive_items.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
@@ -1585,6 +1624,9 @@ module Google
         #   removed from all current folders and placed in the requested folder. Other
         #   requests that increase the number of parents fail, except when the
         #   canAddMyDriveParent file capability is true and a single parent is being added.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [String] modified_date_behavior
         #   Determines the behavior in which modifiedDate is updated. This overrides
         #   setModifiedDate.
@@ -1594,14 +1636,16 @@ module Google
         #   created as head revision, and previous unpinned revisions are preserved for a
         #   short period of time. Pinned revisions are stored indefinitely, using
         #   additional storage quota, up to a maximum of 200 revisions. For details on how
-        #   revisions are retained, see the Drive Help Center.
+        #   revisions are retained, see the Drive Help Center. Note that this field is
+        #   ignored if there is no payload in the request.
         # @param [Boolean] ocr
         #   Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
         # @param [String] ocr_language
         #   If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
         # @param [Boolean] pinned
         #   Whether to pin the new revision. A file can have a maximum of 200 pinned
-        #   revisions.
+        #   revisions. Note that this field is ignored if there is no payload in the
+        #   request.
         # @param [String] remove_parents
         #   Comma-separated list of parent IDs to remove.
         # @param [Boolean] set_modified_date
@@ -1640,7 +1684,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def patch_file(file_id, file_object = nil, add_parents: nil, convert: nil, enforce_single_parent: nil, modified_date_behavior: nil, new_revision: nil, ocr: nil, ocr_language: nil, pinned: nil, remove_parents: nil, set_modified_date: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, update_viewed_date: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def patch_file(file_id, file_object = nil, add_parents: nil, convert: nil, enforce_single_parent: nil, include_permissions_for_view: nil, modified_date_behavior: nil, new_revision: nil, ocr: nil, ocr_language: nil, pinned: nil, remove_parents: nil, set_modified_date: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, update_viewed_date: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:patch, 'files/{fileId}', options)
           command.request_representation = Google::Apis::DriveV2::File::Representation
           command.request_object = file_object
@@ -1650,6 +1694,7 @@ module Google
           command.query['addParents'] = add_parents unless add_parents.nil?
           command.query['convert'] = convert unless convert.nil?
           command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['modifiedDateBehavior'] = modified_date_behavior unless modified_date_behavior.nil?
           command.query['newRevision'] = new_revision unless new_revision.nil?
           command.query['ocr'] = ocr unless ocr.nil?
@@ -1672,6 +1717,9 @@ module Google
         # Set the file's updated time to the current server time.
         # @param [String] file_id
         #   The ID of the file to update.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1695,11 +1743,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def touch_file(file_id, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def touch_file(file_id, include_permissions_for_view: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'files/{fileId}/touch', options)
           command.response_representation = Google::Apis::DriveV2::File::Representation
           command.response_class = Google::Apis::DriveV2::File
           command.params['fileId'] = file_id unless file_id.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?
           command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -1709,9 +1758,16 @@ module Google
         end
         
         # Moves a file to the trash. The currently authenticated user must own the file
-        # or be at least a fileOrganizer on the parent for shared drive files.
+        # or be at least a fileOrganizer on the parent for shared drive files. 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.
         # @param [String] file_id
         #   The ID of the file to trash.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1735,11 +1791,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def trash_file(file_id, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def trash_file(file_id, include_permissions_for_view: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'files/{fileId}/trash', options)
           command.response_representation = Google::Apis::DriveV2::File::Representation
           command.response_class = Google::Apis::DriveV2::File
           command.params['fileId'] = file_id unless file_id.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?
           command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -1748,9 +1805,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Restores a file from the trash.
+        # Restores a file from the trash. The currently authenticated user must own the
+        # file or be at least a fileOrganizer on the parent for shared drive files. Only
+        # the owner may untrash a file.
         # @param [String] file_id
         #   The ID of the file to untrash.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1774,11 +1836,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def untrash_file(file_id, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def untrash_file(file_id, include_permissions_for_view: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'files/{fileId}/untrash', options)
           command.response_representation = Google::Apis::DriveV2::File::Representation
           command.response_class = Google::Apis::DriveV2::File
           command.params['fileId'] = file_id unless file_id.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?
           command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -1802,6 +1865,9 @@ module Google
         #   removed from all current folders and placed in the requested folder. Other
         #   requests that increase the number of parents fail, except when the
         #   canAddMyDriveParent file capability is true and a single parent is being added.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [String] modified_date_behavior
         #   Determines the behavior in which modifiedDate is updated. This overrides
         #   setModifiedDate.
@@ -1811,14 +1877,16 @@ module Google
         #   created as head revision, and previous unpinned revisions are preserved for a
         #   short period of time. Pinned revisions are stored indefinitely, using
         #   additional storage quota, up to a maximum of 200 revisions. For details on how
-        #   revisions are retained, see the Drive Help Center.
+        #   revisions are retained, see the Drive Help Center. Note that this field is
+        #   ignored if there is no payload in the request.
         # @param [Boolean] ocr
         #   Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
         # @param [String] ocr_language
         #   If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
         # @param [Boolean] pinned
         #   Whether to pin the new revision. A file can have a maximum of 200 pinned
-        #   revisions.
+        #   revisions. Note that this field is ignored if there is no payload in the
+        #   request.
         # @param [String] remove_parents
         #   Comma-separated list of parent IDs to remove.
         # @param [Boolean] set_modified_date
@@ -1861,7 +1929,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_file(file_id, file_object = nil, add_parents: nil, convert: nil, enforce_single_parent: nil, modified_date_behavior: nil, new_revision: nil, ocr: nil, ocr_language: nil, pinned: nil, remove_parents: nil, set_modified_date: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, update_viewed_date: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+        def update_file(file_id, file_object = nil, add_parents: nil, convert: nil, enforce_single_parent: nil, include_permissions_for_view: nil, modified_date_behavior: nil, new_revision: nil, ocr: nil, ocr_language: nil, pinned: nil, remove_parents: nil, set_modified_date: nil, supports_all_drives: nil, supports_team_drives: nil, timed_text_language: nil, timed_text_track_name: nil, update_viewed_date: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
           if upload_source.nil?
             command = make_simple_command(:put, 'files/{fileId}', options)
           else
@@ -1877,6 +1945,7 @@ module Google
           command.query['addParents'] = add_parents unless add_parents.nil?
           command.query['convert'] = convert unless convert.nil?
           command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['modifiedDateBehavior'] = modified_date_behavior unless modified_date_behavior.nil?
           command.query['newRevision'] = new_revision unless new_revision.nil?
           command.query['ocr'] = ocr unless ocr.nil?
@@ -1903,6 +1972,9 @@ module Google
         # @param [Boolean] acknowledge_abuse
         #   Whether the user is acknowledging the risk of downloading known malware or
         #   other abusive files.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [String] projection
         #   This parameter is deprecated and has no function.
         # @param [String] revision_id
@@ -1936,7 +2008,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def watch_file(file_id, channel_object = nil, acknowledge_abuse: nil, projection: nil, revision_id: nil, supports_all_drives: nil, supports_team_drives: nil, update_viewed_date: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
+        def watch_file(file_id, channel_object = nil, acknowledge_abuse: nil, include_permissions_for_view: nil, projection: nil, revision_id: nil, supports_all_drives: nil, supports_team_drives: nil, update_viewed_date: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
           if download_dest.nil?
             command = make_simple_command(:post, 'files/{fileId}/watch', options)
           else
@@ -1949,6 +2021,7 @@ module Google
           command.response_class = Google::Apis::DriveV2::Channel
           command.params['fileId'] = file_id unless file_id.nil?
           command.query['acknowledgeAbuse'] = acknowledge_abuse unless acknowledge_abuse.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['projection'] = projection unless projection.nil?
           command.query['revisionId'] = revision_id unless revision_id.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?
@@ -2318,6 +2391,9 @@ module Google
         # Lists a file's or shared drive's permissions.
         # @param [String] file_id
         #   The ID for the file or shared drive.
+        # @param [String] include_permissions_for_view
+        #   Specifies which additional view's permissions to include in the response. Only
+        #   'published' is supported.
         # @param [Fixnum] max_results
         #   The maximum number of permissions to return per page. When not set for files
         #   in a shared drive, at most 100 results will be returned. When not set for
@@ -2353,11 +2429,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_permissions(file_id, max_results: nil, page_token: nil, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_permissions(file_id, include_permissions_for_view: nil, max_results: nil, page_token: nil, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, 'files/{fileId}/permissions', options)
           command.response_representation = Google::Apis::DriveV2::PermissionList::Representation
           command.response_class = Google::Apis::DriveV2::PermissionList
           command.params['fileId'] = file_id unless file_id.nil?
+          command.query['includePermissionsForView'] = include_permissions_for_view unless include_permissions_for_view.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?