google-apis-drive_v3 0.59.0 → 0.61.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75c465494ee65e55fa56309097e0c572169e5f6ce66b2a145bb498eeb25a8e57
-  data.tar.gz: 14d8191cbc3caa4f9665e4921c165c169b6956b00f66185e15be111963ac8df1
+  metadata.gz: d592e7aac3b45c349709aaba088197aa2c497c4f88779b75b793c5a75b24219a
+  data.tar.gz: c351468b6394b84217c4b1324a0cc5e68fd7b977f93d266f86672acfee887fd5
 SHA512:
-  metadata.gz: a1b5427aadfb8af893ba0f48ab589c7344331f20d9b8be7f3974fd4722ca510f91ad877d5764527bb0880c8beb521162c062eb8a7ca339e3e8c56a307991844a
-  data.tar.gz: ae8e07a1759f03a14827c1069fb5b1746aeea9a17ed09f674cc3fb45fb44eff471ca85ed0e674e0fdf269468c0dbf0420b7710f13d268cf14f703e90e0a4939a
+  metadata.gz: e9a1366a99c35bea59cc2912fc18906eeb02de4245be5e37af101efaba7a4dfb3896eb354ee864d61272c9df276722fc85e5fd0f6b252e2bf45adbf5c82e532f
+  data.tar.gz: 4fb9a1d9f4fdeb55e74f01d90e5478c7e8bbe126f201ca459a7020be9f5a9306d8344eaec9847d4e47c5776111519b916a3ae0760a92843e25e309f8212b620f

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-drive_v3
 
+### v0.61.0 (2024-12-15)
+
+* Regenerated from discovery document revision 20241206
+
+### v0.60.0 (2024-11-24)
+
+* Regenerated from discovery document revision 20241117
+
 ### v0.59.0 (2024-10-20)
 
 * Regenerated from discovery document revision 20241014

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

@@ -3054,9 +3054,12 @@ module Google
       end
       
       # A permission for a file. A permission grants a user, group, domain, or the
-      # world access to a file or a folder hierarchy. Some resource methods (such as `
-      # permissions.update`) require a `permissionId`. Use the `permissions.list`
-      # method to retrieve the ID for a file, folder, or shared drive.
+      # world access to a file or a folder hierarchy. By default, permissions requests
+      # only return a subset of fields. Permission kind, ID, type, and role are always
+      # returned. To retrieve specific fields, see https://developers.google.com/drive/
+      # api/guides/fields-parameter. Some resource methods (such as `permissions.
+      # update`) require a `permissionId`. Use the `permissions.list` method to
+      # retrieve the ID for a file, folder, or shared drive.
       class Permission
         include Google::Apis::Core::Hashable
       
@@ -3416,6 +3419,47 @@ module Google
         end
       end
       
+      # Request message for resolving an AccessProposal on a file.
+      class ResolveAccessProposalRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The action to take on the AccessProposal.
+        # Corresponds to the JSON property `action`
+        # @return [String]
+        attr_accessor :action
+      
+        # Optional. The roles the approver has allowed, if any. Note: This field is
+        # required for the `ACCEPT` action.
+        # Corresponds to the JSON property `role`
+        # @return [Array<String>]
+        attr_accessor :role
+      
+        # Optional. Whether to send an email to the requester when the AccessProposal is
+        # denied or accepted.
+        # Corresponds to the JSON property `sendNotification`
+        # @return [Boolean]
+        attr_accessor :send_notification
+        alias_method :send_notification?, :send_notification
+      
+        # Optional. Indicates the view for this access proposal. This should only be set
+        # when the proposal belongs to a view. `published` is the only supported value.
+        # Corresponds to the JSON property `view`
+        # @return [String]
+        attr_accessor :view
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @action = args[:action] if args.key?(:action)
+          @role = args[:role] if args.key?(:role)
+          @send_notification = args[:send_notification] if args.key?(:send_notification)
+          @view = args[:view] if args.key?(:view)
+        end
+      end
+      
       # The metadata for a revision to a file. Some resource methods (such as `
       # revisions.update`) require a `revisionId`. Use the `revisions.list` method to
       # retrieve the ID for a revision.

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DriveV3
       # Version of the google-apis-drive_v3 gem
-      GEM_VERSION = "0.59.0"
+      GEM_VERSION = "0.61.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20241014"
+      REVISION = "20241206"
     end
   end
 end

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

@@ -316,6 +316,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ResolveAccessProposalRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Revision
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1126,6 +1132,16 @@ module Google
         end
       end
       
+      class ResolveAccessProposalRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :action, as: 'action'
+          collection :role, as: 'role'
+          property :send_notification, as: 'sendNotification'
+          property :view, as: 'view'
+        end
+      end
+      
       class Revision
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -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/
+        # 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/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/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/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/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/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,8 @@ 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/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 +473,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/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 +503,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/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/drive/api/
+        # guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::Comment] comment_object
@@ -419,7 +540,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/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/drive/api/guides/fields-
+        # parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] comment_id
@@ -450,7 +575,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/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/drive/api/guides/fields-
+        # parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] comment_id
@@ -487,7 +616,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/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/drive/api/
+        # guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Boolean] include_deleted
@@ -532,7 +665,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/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/
+        # drive/api/guides/fields-parameter).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] comment_id
@@ -1544,97 +1681,14 @@ module Google
           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_file_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 [String] action
-        #   Required. The action to take on the AccessProposal.
-        # @param [Array<String>, String] role
-        #   Optional. The roles the approver has allowed, if any. Note: This field is
-        #   required for the `ACCEPT` action.
-        # @param [Boolean] send_notification
-        #   Optional. Whether to send an email to the requester when the AccessProposal is
-        #   denied or accepted.
-        # @param [String] view
-        #   Optional. Indicates the view for this access proposal. This should only be set
-        #   when the proposal belongs to a view. `published` is the only supported value.
-        # @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_file_accessproposal(file_id, proposal_id, action: nil, role: nil, send_notification: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'files/{fileId}/accessproposals/{proposalId}:resolve', options)
-          command.params['fileId'] = file_id unless file_id.nil?
-          command.params['proposalId'] = proposal_id unless proposal_id.nil?
-          command.query['action'] = action unless action.nil?
-          command.query['role'] = role unless role.nil?
-          command.query['sendNotification'] = send_notification unless send_notification.nil?
-          command.query['view'] = view unless view.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          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`.
+        # 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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v3
 version: !ruby/object:Gem::Version
-  version: 0.59.0
+  version: 0.61.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-27 00:00:00.000000000 Z
+date: 2024-12-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.59.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.61.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.21
+rubygems_version: 3.5.23
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Google Drive API V3