google-apis-drive_v3 0.51.0 → 0.63.0

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

@@ -30,7 +30,7 @@ module Google
       #    Drive = Google::Apis::DriveV3 # Alias the module
       #    service = Drive::DriveService.new
       #
-      # @see https://developers.google.com/drive/
+      # @see https://developers.google.com/workspace/drive/
       class DriveService < Google::Apis::Core::BaseService
         DEFAULT_ENDPOINT_TEMPLATE = "https://www.$UNIVERSE_DOMAIN$/"
 
@@ -52,6 +52,10 @@ module Google
         end
         
         # Gets information about the user, the user's Drive, and system capabilities.
+        # For more information, see [Return user info](https://developers.google.com/
+        # workspace/drive/api/guides/user-info). Required: The `fields` parameter must
+        # be set. To return the exact fields you need, see [Return specific fields](
+        # https://developers.google.com/workspace/drive/api/guides/fields-parameter).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -78,7 +82,112 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a specific app.
+        # Retrieves an AccessProposal by ID.
+        # @param [String] file_id
+        #   Required. The id of the item the request is on.
+        # @param [String] proposal_id
+        #   Required. The id of the access proposal to resolve.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DriveV3::AccessProposal] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::AccessProposal]
+        #
+        # @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_accessproposal(file_id, proposal_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'files/{fileId}/accessproposals/{proposalId}', options)
+          command.response_representation = Google::Apis::DriveV3::AccessProposal::Representation
+          command.response_class = Google::Apis::DriveV3::AccessProposal
+          command.params['fileId'] = file_id unless file_id.nil?
+          command.params['proposalId'] = proposal_id unless proposal_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List the AccessProposals on a file. Note: Only approvers are able to list
+        # AccessProposals on a file. If the user is not an approver, returns a 403.
+        # @param [String] file_id
+        #   Required. The id of the item the request is on.
+        # @param [Fixnum] page_size
+        #   Optional. The number of results per page
+        # @param [String] page_token
+        #   Optional. The continuation token on the list of access requests.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DriveV3::ListAccessProposalsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::ListAccessProposalsResponse]
+        #
+        # @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_accessproposals(file_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'files/{fileId}/accessproposals', options)
+          command.response_representation = Google::Apis::DriveV3::ListAccessProposalsResponse::Representation
+          command.response_class = Google::Apis::DriveV3::ListAccessProposalsResponse
+          command.params['fileId'] = file_id unless file_id.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Used to approve or deny an Access Proposal.
+        # @param [String] file_id
+        #   Required. The id of the item the request is on.
+        # @param [String] proposal_id
+        #   Required. The id of the access proposal to resolve.
+        # @param [Google::Apis::DriveV3::ResolveAccessProposalRequest] resolve_access_proposal_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [NilClass] No result returned for this method
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [void]
+        #
+        # @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 resolve_accessproposal_access_proposal(file_id, proposal_id, resolve_access_proposal_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'files/{fileId}/accessproposals/{proposalId}:resolve', options)
+          command.request_representation = Google::Apis::DriveV3::ResolveAccessProposalRequest::Representation
+          command.request_object = resolve_access_proposal_request_object
+          command.params['fileId'] = file_id unless file_id.nil?
+          command.params['proposalId'] = proposal_id unless proposal_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a specific app. For more information, see [Return user info](https://
+        # developers.google.com/workspace/drive/api/guides/user-info).
         # @param [String] app_id
         #   The ID of the app.
         # @param [String] fields
@@ -108,7 +217,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists a user's installed apps.
+        # Lists a user's installed apps. For more information, see [Return user info](
+        # https://developers.google.com/workspace/drive/api/guides/user-info).
         # @param [String] app_filter_extensions
         #   A comma-separated list of file extensions to limit returned results. All
         #   results within the given app query scope which can open any of the given file
@@ -151,7 +261,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the starting pageToken for listing future changes.
+        # Gets the starting pageToken for listing future changes. For more information,
+        # see [Retrieve changes](https://developers.google.com/workspace/drive/api/
+        # guides/manage-changes).
         # @param [String] drive_id
         #   The ID of the shared drive for which the starting pageToken for listing future
         #   changes from that shared drive will be returned.
@@ -191,7 +303,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the changes for a user or shared drive.
+        # Lists the changes for a user or shared drive. For more information, see [
+        # Retrieve changes](https://developers.google.com/workspace/drive/api/guides/
+        # manage-changes).
         # @param [String] page_token
         #   The token for continuing a previous list request on the next page. This should
         #   be set to the value of 'nextPageToken' from the previous response or to the
@@ -273,7 +387,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Subscribes to changes for a user.
+        # Subscribes to changes for a user. For more information, see [Notifications for
+        # resource changes](https://developers.google.com/workspace/drive/api/guides/
+        # push).
         # @param [String] page_token
         #   The token for continuing a previous list request on the next page. This should
         #   be set to the value of 'nextPageToken' from the previous response or to the
@@ -358,7 +474,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Stops watching resources through this channel.
+        # Stops watching resources through this channel. For more information, see [
+        # Notifications for resource changes](https://developers.google.com/workspace/
+        # drive/api/guides/push).
         # @param [Google::Apis::DriveV3::Channel] channel_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -386,7 +504,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a comment on a file.
+        # Creates a comment on a file. For more information, see [Manage comments and
+        # replies](https://developers.google.com/workspace/drive/api/guides/manage-
+        # comments). Required: The `fields` parameter must be set. To return the exact
+        # fields you need, see [Return specific fields](https://developers.google.com/
+        # workspace/drive/api/guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::Comment] comment_object
@@ -419,7 +541,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a comment.
+        # Deletes a comment. For more information, see [Manage comments and replies](
+        # https://developers.google.com/workspace/drive/api/guides/manage-comments).
+        # Required: The `fields` parameter must be set. To return the exact fields you
+        # need, see [Return specific fields](https://developers.google.com/workspace/
+        # drive/api/guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] comment_id
@@ -450,7 +576,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a comment by ID.
+        # Gets a comment by ID. For more information, see [Manage comments and replies](
+        # https://developers.google.com/workspace/drive/api/guides/manage-comments).
+        # Required: The `fields` parameter must be set. To return the exact fields you
+        # need, see [Return specific fields](https://developers.google.com/workspace/
+        # drive/api/guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] comment_id
@@ -487,7 +617,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists a file's comments.
+        # Lists a file's comments. For more information, see [Manage comments and
+        # replies](https://developers.google.com/workspace/drive/api/guides/manage-
+        # comments). Required: The `fields` parameter must be set. To return the exact
+        # fields you need, see [Return specific fields](https://developers.google.com/
+        # workspace/drive/api/guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Boolean] include_deleted
@@ -532,7 +666,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a comment with patch semantics.
+        # Updates a comment with patch semantics. For more information, see [Manage
+        # comments and replies](https://developers.google.com/workspace/drive/api/guides/
+        # manage-comments). Required: The `fields` parameter must be set. To return the
+        # exact fields you need, see [Return specific fields](https://developers.google.
+        # com/workspace/drive/api/guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] comment_id
@@ -710,8 +848,8 @@ module Google
         
         # Lists the user's shared drives. This method accepts the `q` parameter, which
         # is a search query combining one or more search terms. For more information,
-        # see the [Search for shared drives](/drive/api/guides/search-shareddrives)
-        # guide.
+        # see the [Search for shared drives](/workspace/drive/api/guides/search-
+        # shareddrives) guide.
         # @param [Fixnum] page_size
         #   Maximum number of shared drives to return per page.
         # @param [String] page_token
@@ -891,18 +1029,18 @@ module Google
         # 120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type,
         # rather than the literal `*/*` value. The literal `*/*` is only used to
         # indicate that any valid MIME type can be uploaded. For more information on
-        # uploading files, see [Upload file data](/drive/api/guides/manage-uploads).
-        # Apps creating shortcuts with `files.create` must specify the MIME type `
-        # application/vnd.google-apps.shortcut`. Apps should specify a file extension in
-        # the `name` property when inserting files with the API. For example, an
-        # operation to insert a JPEG file should specify something like `"name": "cat.
-        # jpg"` in the metadata. Subsequent `GET` requests include the read-only `
-        # fileExtension` property populated with the extension originally specified in
-        # the `title` property. When a Google Drive user requests to download a file, or
-        # when the file is downloaded through the sync client, Drive builds a full
-        # filename (with extension) based on the title. In cases where the extension is
-        # missing, Drive attempts to determine the extension based on the file's MIME
-        # type.
+        # uploading files, see [Upload file data](/workspace/drive/api/guides/manage-
+        # uploads). Apps creating shortcuts with `files.create` must specify the MIME
+        # type `application/vnd.google-apps.shortcut`. Apps should specify a file
+        # extension in the `name` property when inserting files with the API. For
+        # example, an operation to insert a JPEG file should specify something like `"
+        # name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-
+        # only `fileExtension` property populated with the extension originally
+        # specified in the `title` property. When a Google Drive user requests to
+        # download a file, or when the file is downloaded through the sync client, Drive
+        # builds a full filename (with extension) based on the title. In cases where the
+        # extension is missing, Drive attempts to determine the extension based on the
+        # file's MIME type.
         # @param [Google::Apis::DriveV3::File] file_object
         # @param [Boolean] enforce_single_parent
         #   Deprecated. Creating files in multiple folders is no longer supported.
@@ -1018,6 +1156,50 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Downloads content of a file. Operations are valid for 24 hours from the time
+        # of creation.
+        # @param [String] file_id
+        #   Required. The ID of the file to download.
+        # @param [String] mime_type
+        #   Optional. The MIME type the file should be downloaded as. This field can only
+        #   be set when downloading Google Workspace documents. See [Export MIME types for
+        #   Google Workspace documents](/drive/api/guides/ref-export-formats) for the list
+        #   of supported MIME types. If not set, a Google Workspace document is downloaded
+        #   with a default MIME type. The default MIME type might change in the future.
+        # @param [String] revision_id
+        #   Optional. The revision ID of the file to download. This field can only be set
+        #   when downloading blob files, Google Docs, and Google Sheets. Returns `
+        #   INVALID_ARGUMENT` if downloading a specific revision on the file is
+        #   unsupported.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DriveV3::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::Operation]
+        #
+        # @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 download_file(file_id, mime_type: nil, revision_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'files/{fileId}/download', options)
+          command.response_representation = Google::Apis::DriveV3::Operation::Representation
+          command.response_class = Google::Apis::DriveV3::Operation
+          command.params['fileId'] = file_id unless file_id.nil?
+          command.query['mimeType'] = mime_type unless mime_type.nil?
+          command.query['revisionId'] = revision_id unless revision_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Permanently deletes all of the user's trashed files.
         # @param [String] drive_id
         #   If set, empties the trash of the provided shared drive.
@@ -1131,14 +1313,16 @@ module Google
         # Gets a file's metadata or content by ID. If you provide the URL parameter `
         # alt=media`, then the response includes the file contents in the response body.
         # Downloading content with `alt=media` only works if the file is stored in Drive.
-        # To download Google Docs, Sheets, and Slides use [`files.export`](/drive/api/
-        # reference/rest/v3/files/export) instead. For more information, see [Download &
-        # export files](/drive/api/guides/manage-downloads).
+        # To download Google Docs, Sheets, and Slides use [`files.export`](/workspace/
+        # drive/api/reference/rest/v3/files/export) instead. For more information, see [
+        # Download & export files](/workspace/drive/api/guides/manage-downloads).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Boolean] acknowledge_abuse
         #   Whether the user is acknowledging the risk of downloading known malware or
-        #   other abusive files. This is only applicable when alt=media.
+        #   other abusive files. This is only applicable when the `alt` parameter is set
+        #   to `media` and the user is the owner of the file or an organizer of the shared
+        #   drive in which the file resides.
         # @param [String] include_labels
         #   A comma-separated list of IDs of labels to include in the `labelInfo` part of
         #   the response.
@@ -1190,10 +1374,10 @@ module Google
         
         # Lists the user's files. This method accepts the `q` parameter, which is a
         # search query combining one or more search terms. For more information, see the
-        # [Search for files & folders](/drive/api/guides/search-files) guide. *Note:*
-        # This method returns *all* files by default, including trashed files. If you
-        # don't want trashed files to appear in the list, use the `trashed=false` query
-        # parameter to remove trashed files from the results.
+        # [Search for files & folders](/workspace/drive/api/guides/search-files) guide. *
+        # Note:* This method returns *all* files by default, including trashed files. If
+        # you don't want trashed files to appear in the list, use the `trashed=false`
+        # query parameter to remove trashed files from the results.
         # @param [String] corpora
         #   Bodies of items (files/documents) to which the query applies. Supported bodies
         #   are 'user', 'domain', 'drive', and 'allDrives'. Prefer 'user' or 'drive' to '
@@ -1214,11 +1398,20 @@ module Google
         # @param [Boolean] include_team_drive_items
         #   Deprecated: Use `includeItemsFromAllDrives` instead.
         # @param [String] order_by
-        #   A comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', '
-        #   modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', '
-        #   recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts
-        #   ascending by default, but can be reversed with the 'desc' modifier. Example
-        #   usage: ?orderBy=folder,modifiedTime desc,name.
+        #   A comma-separated list of sort keys. Valid keys are: * `createdTime`: When the
+        #   file was created. * `folder`: The folder ID. This field is sorted using
+        #   alphabetical ordering. * `modifiedByMeTime`: The last time the file was
+        #   modified by the user. * `modifiedTime`: The last time the file was modified by
+        #   anyone. * `name`: The name of the file. This field is sorted using
+        #   alphabetical ordering, so 1, 12, 2, 22. * `name_natural`: The name of the file.
+        #   This field is sorted using natural sort ordering, so 1, 2, 12, 22. * `
+        #   quotaBytesUsed`: The number of storage quota bytes used by the file. * `
+        #   recency`: The most recent timestamp from the file's date-time fields. * `
+        #   sharedWithMeTime`: When the file was shared with the user, if applicable. * `
+        #   starred`: Whether the user has starred the file. * `viewedByMeTime`: The last
+        #   time the file was viewed by the user. Each key sorts ascending by default, but
+        #   can be reversed with the 'desc' modifier. Example usage: `?orderBy=folder,
+        #   modifiedTime desc,name`.
         # @param [Fixnum] page_size
         #   The maximum number of files to return per page. Partial or empty result pages
         #   are possible even before the end of the files list has been reached.
@@ -1357,7 +1550,8 @@ module Google
         # size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME
         # type, rather than the literal `*/*` value. The literal `*/*` is only used to
         # indicate that any valid MIME type can be uploaded. For more information on
-        # uploading files, see [Upload file data](/drive/api/guides/manage-uploads).
+        # uploading files, see [Upload file data](/workspace/drive/api/guides/manage-
+        # uploads).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::File] file_object
@@ -1442,7 +1636,9 @@ module Google
         # @param [Google::Apis::DriveV3::Channel] channel_object
         # @param [Boolean] acknowledge_abuse
         #   Whether the user is acknowledging the risk of downloading known malware or
-        #   other abusive files. This is only applicable when alt=media.
+        #   other abusive files. This is only applicable when the `alt` parameter is set
+        #   to `media` and the user is the owner of the file or an organizer of the shared
+        #   drive in which the file resides.
         # @param [String] include_labels
         #   A comma-separated list of IDs of labels to include in the `labelInfo` part of
         #   the response.
@@ -1487,6 +1683,143 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. If the
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+        # Clients can use Operations.GetOperation or other methods to check whether the
+        # cancellation succeeded or whether the operation completed despite cancellation.
+        # On successful cancellation, the operation is not deleted; instead, it becomes
+        # an operation with an Operation.error value with a google.rpc.Status.code of `1`
+        # , corresponding to `Code.CANCELLED`.
+        # @param [String] name
+        #   The name of the operation resource to be cancelled.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [NilClass] No result returned for this method
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [void]
+        #
+        # @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 cancel_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'operations/{name}:cancel', options)
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a long-running operation. This method indicates that the client is no
+        # longer interested in the operation result. It does not cancel the operation.
+        # If the server doesn't support this method, it returns `google.rpc.Code.
+        # UNIMPLEMENTED`.
+        # @param [String] name
+        #   The name of the operation resource to be deleted.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [NilClass] No result returned for this method
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [void]
+        #
+        # @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_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'operations/{name}', options)
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
+        # @param [String] name
+        #   The name of the operation resource.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DriveV3::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::Operation]
+        #
+        # @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_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'operations/{name}', options)
+          command.response_representation = Google::Apis::DriveV3::Operation::Representation
+          command.response_class = Google::Apis::DriveV3::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`.
+        # @param [String] filter
+        #   The standard list filter.
+        # @param [String] name
+        #   The name of the operation's parent resource.
+        # @param [Fixnum] page_size
+        #   The standard list page size.
+        # @param [String] page_token
+        #   The standard list page token.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DriveV3::ListOperationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::ListOperationsResponse]
+        #
+        # @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_operations(filter: nil, name: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'operations', options)
+          command.response_representation = Google::Apis::DriveV3::ListOperationsResponse::Representation
+          command.response_class = Google::Apis::DriveV3::ListOperationsResponse
+          command.query['filter'] = filter unless filter.nil?
+          command.query['name'] = name unless name.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a permission for a file or shared drive. **Warning:** Concurrent
         # permissions operations on the same file are not supported; only the last
         # update is applied.
@@ -1562,6 +1895,8 @@ module Google
         #   The ID of the file or shared drive.
         # @param [String] permission_id
         #   The ID of the permission.
+        # @param [Boolean] enforce_expansive_access
+        #   Whether the request should enforce expansive access rules.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1588,10 +1923,11 @@ 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_permission(file_id, permission_id, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def delete_permission(file_id, permission_id, enforce_expansive_access: nil, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:delete, 'files/{fileId}/permissions/{permissionId}', options)
           command.params['fileId'] = file_id unless file_id.nil?
           command.params['permissionId'] = permission_id unless permission_id.nil?
+          command.query['enforceExpansiveAccess'] = enforce_expansive_access unless enforce_expansive_access.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['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
@@ -1707,6 +2043,8 @@ module Google
         # @param [String] permission_id
         #   The ID of the permission.
         # @param [Google::Apis::DriveV3::Permission] permission_object
+        # @param [Boolean] enforce_expansive_access
+        #   Whether the request should enforce expansive access rules.
         # @param [Boolean] remove_expiration
         #   Whether to remove the expiration date.
         # @param [Boolean] supports_all_drives
@@ -1739,7 +2077,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_permission(file_id, permission_id, permission_object = nil, remove_expiration: nil, supports_all_drives: nil, supports_team_drives: nil, transfer_ownership: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def update_permission(file_id, permission_id, permission_object = nil, enforce_expansive_access: nil, remove_expiration: nil, supports_all_drives: nil, supports_team_drives: nil, transfer_ownership: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:patch, 'files/{fileId}/permissions/{permissionId}', options)
           command.request_representation = Google::Apis::DriveV3::Permission::Representation
           command.request_object = permission_object
@@ -1747,6 +2085,7 @@ module Google
           command.response_class = Google::Apis::DriveV3::Permission
           command.params['fileId'] = file_id unless file_id.nil?
           command.params['permissionId'] = permission_id unless permission_id.nil?
+          command.query['enforceExpansiveAccess'] = enforce_expansive_access unless enforce_expansive_access.nil?
           command.query['removeExpiration'] = remove_expiration unless remove_expiration.nil?
           command.query['supportsAllDrives'] = supports_all_drives unless supports_all_drives.nil?
           command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
@@ -1991,7 +2330,9 @@ module Google
         #   The ID of the revision.
         # @param [Boolean] acknowledge_abuse
         #   Whether the user is acknowledging the risk of downloading known malware or
-        #   other abusive files. This is only applicable when alt=media.
+        #   other abusive files. This is only applicable when the `alt` parameter is set
+        #   to `media` and the user is the owner of the file or an organizer of the shared
+        #   drive in which the file resides.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/lib/google/apis/drive_v3.rb

@@ -23,7 +23,7 @@ module Google
     #
     # The Google Drive API allows clients to access resources from Google Drive.
     #
-    # @see https://developers.google.com/drive/
+    # @see https://developers.google.com/workspace/drive/
     module DriveV3
       # Version of the Google Drive API this client connects to.
       # This is NOT the gem version.