google-apis-drive_v3 0.56.0 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44b01bdd14e7ed5584ac7de19b6dc2d34988ddde5af36e643edbe5de0cdd568f
-  data.tar.gz: 3efb87406e9749886a0586790ced01f0807452b7c6fb4c083c153dfffde75e4f
+  metadata.gz: 9f2bff3b0ee31c6db343289f04ccbcf2653969066382b6be8bd045c5d6a29fdf
+  data.tar.gz: b2d869d93a11bf9abb4416105db55f6246f10b1ec5972459d7965592f7557009
 SHA512:
-  metadata.gz: 30cb75cc927a04c6a0d987e61dcf7b72b7fe35913e68e2095e6fc9a68943840635eff2b6d53fa48d25a477a37d33a892fb7dec77f90fca9b129d490123697296
-  data.tar.gz: f2354d1cfeb71774c843f0e338937a5254a6b7bbd67a94c9010f303626d1ac3f392c731ababa92521fbf98d3932ec554567bbf1b4438d12271b18047ffa7e578
+  metadata.gz: a786650363c69c7179930db9590ab071a152dec7e807cde44d82e293bb21360972aa707d6b3529c2d59de68224f5ad1e2b03bd0a289ddf0863ce845977427c2f
+  data.tar.gz: e068edb0a65da1658fa46a772d9e17846278af96b5f4165558777cb45c6ee19a4d6afbf2136bd3dc90271202873602b5336a752b9e67a4b3dd22a9db1eab9ce9

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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
+
 ### v0.56.0 (2024-09-08)
 
 * Regenerated from discovery document revision 20240903

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.56.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 = "20240903"
+      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

@@ -1260,11 +1260,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.
@@ -1535,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.56.0
+  version: 0.58.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-15 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.56.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