google-apis-drive_v3 0.57.0 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eba6c7f45f2dca3ece3274c4fde067743ec6ee59fbc20a5d123ad2d1fdff9a2f
-  data.tar.gz: 3c96a6d537ab15574b4b96ceda7f0b218a8c3c6452d009c8f95c0f009c57045e
+  metadata.gz: 9f2bff3b0ee31c6db343289f04ccbcf2653969066382b6be8bd045c5d6a29fdf
+  data.tar.gz: b2d869d93a11bf9abb4416105db55f6246f10b1ec5972459d7965592f7557009
 SHA512:
-  metadata.gz: 25cea60fe5a24d4c3519b9bdf2c47a0792c9abfeba6b7660482fa6b9c0ccd53ebe10a5b5344f0cc9934226ee4802121eb529379b57a5eddfd42f6431246ff59f
-  data.tar.gz: fea5f017c0cfc0a93aef5e2f9cdef3f0fe0f6444dc4d3a9450a5b01e9cb434fff4ddb5a9b8a2892beab2692faef466e5ed129070cfc086de33215a77bf20a81b
+  metadata.gz: a786650363c69c7179930db9590ab071a152dec7e807cde44d82e293bb21360972aa707d6b3529c2d59de68224f5ad1e2b03bd0a289ddf0863ce845977427c2f
+  data.tar.gz: e068edb0a65da1658fa46a772d9e17846278af96b5f4165558777cb45c6ee19a4d6afbf2136bd3dc90271202873602b5336a752b9e67a4b3dd22a9db1eab9ce9

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-drive_v3
 
+### v0.58.0 (2024-10-13)
+
+* Regenerated from discovery document revision 20241008
+
 ### v0.57.0 (2024-09-22)
 
 * Regenerated from discovery document revision 20240914

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

@@ -227,6 +227,89 @@ module Google
         end
       end
       
+      # The Access Proposal resource for outstanding access proposals on a file
+      class AccessProposal
+        include Google::Apis::Core::Hashable
+      
+        # The creation time
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The file id that the proposal for access is on
+        # Corresponds to the JSON property `fileId`
+        # @return [String]
+        attr_accessor :file_id
+      
+        # The id of the access proposal
+        # Corresponds to the JSON property `proposalId`
+        # @return [String]
+        attr_accessor :proposal_id
+      
+        # The email address of the user that will receive permissions if accepted
+        # Corresponds to the JSON property `recipientEmailAddress`
+        # @return [String]
+        attr_accessor :recipient_email_address
+      
+        # The message that the requester added to the proposal
+        # Corresponds to the JSON property `requestMessage`
+        # @return [String]
+        attr_accessor :request_message
+      
+        # The email address of the requesting user
+        # Corresponds to the JSON property `requesterEmailAddress`
+        # @return [String]
+        attr_accessor :requester_email_address
+      
+        # A wrapper for the role and view of an access proposal.
+        # Corresponds to the JSON property `rolesAndViews`
+        # @return [Array<Google::Apis::DriveV3::AccessProposalRoleAndView>]
+        attr_accessor :roles_and_views
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @file_id = args[:file_id] if args.key?(:file_id)
+          @proposal_id = args[:proposal_id] if args.key?(:proposal_id)
+          @recipient_email_address = args[:recipient_email_address] if args.key?(:recipient_email_address)
+          @request_message = args[:request_message] if args.key?(:request_message)
+          @requester_email_address = args[:requester_email_address] if args.key?(:requester_email_address)
+          @roles_and_views = args[:roles_and_views] if args.key?(:roles_and_views)
+        end
+      end
+      
+      # A wrapper for the role and view of an access proposal.
+      class AccessProposalRoleAndView
+        include Google::Apis::Core::Hashable
+      
+        # The role that was proposed by the requester New values may be added in the
+        # future, but the following are currently possible: * `writer` * `commenter` * `
+        # reader`
+        # Corresponds to the JSON property `role`
+        # @return [String]
+        attr_accessor :role
+      
+        # Indicates the view for this access proposal. Only populated for proposals that
+        # belong to a view. `published` is the only supported value.
+        # Corresponds to the JSON property `view`
+        # @return [String]
+        attr_accessor :view
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @role = args[:role] if args.key?(:role)
+          @view = args[:view] if args.key?(:view)
+        end
+      end
+      
       # The `apps` resource provides a list of apps that a user has installed, with
       # information about each app's supported MIME types, file extensions, and other
       # details. Some resource methods (such as `apps.get`) require an `appId`. Use
@@ -2803,6 +2886,34 @@ module Google
         end
       end
       
+      # The response to an Access Proposal list request.
+      class ListAccessProposalsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of Access Proposals. This field is only populated in v3 and v3beta.
+        # Corresponds to the JSON property `accessProposals`
+        # @return [Array<Google::Apis::DriveV3::AccessProposal>]
+        attr_accessor :access_proposals
+      
+        # The continuation token for the next page of results. This will be absent if
+        # the end of the results list has been reached. If the token is rejected for any
+        # reason, it should be discarded, and pagination should be restarted from the
+        # first page of results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @access_proposals = args[:access_proposals] if args.key?(:access_proposals)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The response message for Operations.ListOperations.
       class ListOperationsResponse
         include Google::Apis::Core::Hashable

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.57.0"
+      GEM_VERSION = "0.58.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 = "20240914"
+      REVISION = "20241008"
     end
   end
 end

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

@@ -46,6 +46,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AccessProposal
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccessProposalRoleAndView
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class App
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -238,6 +250,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListAccessProposalsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListOperationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -417,6 +435,28 @@ module Google
         end
       end
       
+      class AccessProposal
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :file_id, as: 'fileId'
+          property :proposal_id, as: 'proposalId'
+          property :recipient_email_address, as: 'recipientEmailAddress'
+          property :request_message, as: 'requestMessage'
+          property :requester_email_address, as: 'requesterEmailAddress'
+          collection :roles_and_views, as: 'rolesAndViews', class: Google::Apis::DriveV3::AccessProposalRoleAndView, decorator: Google::Apis::DriveV3::AccessProposalRoleAndView::Representation
+      
+        end
+      end
+      
+      class AccessProposalRoleAndView
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :role, as: 'role'
+          property :view, as: 'view'
+        end
+      end
+      
       class App
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -956,6 +996,15 @@ module Google
         end
       end
       
+      class ListAccessProposalsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :access_proposals, as: 'accessProposals', class: Google::Apis::DriveV3::AccessProposal, decorator: Google::Apis::DriveV3::AccessProposal::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListOperationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -1544,6 +1544,88 @@ 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.
+        # @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`.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v3
 version: !ruby/object:Gem::Version
-  version: 0.57.0
+  version: 0.58.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-22 00:00:00.000000000 Z
+date: 2024-10-13 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.57.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.58.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.6
+rubygems_version: 3.5.21
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Google Drive API V3