google-apis-drive_v3 0.71.0 → 0.75.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f50c4bbb21b7d3fffee4a9d33ae65217db09abecf37ceb9f8032cc76100840d5
-  data.tar.gz: cc220f450b65c597806fd98cc1daf774ce06bdc1951dc55164bee1f61189433f
+  metadata.gz: 71a60038259310c65f637a49fcbb678b0a0efc64a8f905a7b502c91e47e7f258
+  data.tar.gz: 6e401c83cfe0b79e8d2f1bb270eeb86de4870a123b6481b007efa112b2e93e79
 SHA512:
-  metadata.gz: f425b7ae19279904245a205a16d73530fb5883ccdfe3a97b78dd02bbf1ffb44e992fc908fd7a04a54b7fbd7b37ff9d338f016f471212c77ef6639feed9ec3e01
-  data.tar.gz: 23fe66999ef8724df649c6edb3bec613f953fa5f0a9715108943eda92e763e2e67bf1068fd8035e494bf29afdc2c4bef49cf2617fae4c9b019060e8530c9448e
+  metadata.gz: 415f513e80cb536af4d5c45ef7f87db85d54f92c943dab0b7f458856730da9dd955eac44d5a1483f0bdc3d233defa3f7dace90d7cc7753451cae579d99820fee
+  data.tar.gz: 21c09a71bfa49d70b0be4f3900d7ad140f6c6beefa2628d0e8d9740a613f0e0b5960d7acf449978be401a9660b7261c98530036831447fa71785e0074fecc7ce

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release history for google-apis-drive_v3
 
+### v0.75.0 (2025-12-07)
+
+* Regenerated from discovery document revision 20251201
+
+### v0.74.0 (2025-11-23)
+
+* Regenerated from discovery document revision 20251114
+
+### v0.73.0 (2025-10-26)
+
+* Regenerated from discovery document revision 20251019
+
+### v0.72.0 (2025-10-19)
+
+* Regenerated from discovery document revision 20251013
+
 ### v0.71.0 (2025-09-21)
 
 * Regenerated from discovery document revision 20250910

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

@@ -561,6 +561,116 @@ module Google
         end
       end
       
+      # Metadata for an approval. An approval is a review/approve process for a Drive
+      # item.
+      class Approval
+        include Google::Apis::Core::Hashable
+      
+        # The Approval ID.
+        # Corresponds to the JSON property `approvalId`
+        # @return [String]
+        attr_accessor :approval_id
+      
+        # Output only. The time time the approval was completed.
+        # Corresponds to the JSON property `completeTime`
+        # @return [String]
+        attr_accessor :complete_time
+      
+        # Output only. The time the approval was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The time that the approval is due.
+        # Corresponds to the JSON property `dueTime`
+        # @return [String]
+        attr_accessor :due_time
+      
+        # Information about a Drive user.
+        # Corresponds to the JSON property `initiator`
+        # @return [Google::Apis::DriveV3::User]
+        attr_accessor :initiator
+      
+        # This is always drive#approval.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # Output only. The most recent time the approval was modified.
+        # Corresponds to the JSON property `modifyTime`
+        # @return [String]
+        attr_accessor :modify_time
+      
+        # The responses made on the Approval by reviewers.
+        # Corresponds to the JSON property `reviewerResponses`
+        # @return [Array<Google::Apis::DriveV3::ReviewerResponse>]
+        attr_accessor :reviewer_responses
+      
+        # Output only. The status of the approval at the time this resource was
+        # requested.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
+        # Target file id of the approval.
+        # Corresponds to the JSON property `targetFileId`
+        # @return [String]
+        attr_accessor :target_file_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @approval_id = args[:approval_id] if args.key?(:approval_id)
+          @complete_time = args[:complete_time] if args.key?(:complete_time)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @due_time = args[:due_time] if args.key?(:due_time)
+          @initiator = args[:initiator] if args.key?(:initiator)
+          @kind = args[:kind] if args.key?(:kind)
+          @modify_time = args[:modify_time] if args.key?(:modify_time)
+          @reviewer_responses = args[:reviewer_responses] if args.key?(:reviewer_responses)
+          @status = args[:status] if args.key?(:status)
+          @target_file_id = args[:target_file_id] if args.key?(:target_file_id)
+        end
+      end
+      
+      # The response of an Approvals list request.
+      class ApprovalList
+        include Google::Apis::Core::Hashable
+      
+        # The list of Approvals. If nextPageToken is populated, then this list may be
+        # incomplete and an additional page of results should be fetched.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::DriveV3::Approval>]
+        attr_accessor :items
+      
+        # This is always drive#approvalList
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The page token for the next page of Approvals. This will be absent if the end
+        # of the Approvals 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)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # A change to a file or shared drive.
       class Change
         include Google::Apis::Core::Hashable
@@ -780,6 +890,12 @@ module Google
         # @return [String]
         attr_accessor :anchor
       
+        # Output only. The email address of the user assigned to this comment. If no
+        # user is assigned, the field is unset.
+        # Corresponds to the JSON property `assigneeEmailAddress`
+        # @return [String]
+        attr_accessor :assignee_email_address
+      
         # Information about a Drive user.
         # Corresponds to the JSON property `author`
         # @return [Google::Apis::DriveV3::User]
@@ -819,6 +935,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # Output only. A list of email addresses for users mentioned in this comment. If
+        # no users are mentioned, the list is empty.
+        # Corresponds to the JSON property `mentionedEmailAddresses`
+        # @return [Array<String>]
+        attr_accessor :mentioned_email_addresses
+      
         # The last time the comment or any of its replies was modified (RFC 3339 date-
         # time).
         # Corresponds to the JSON property `modifiedTime`
@@ -850,6 +972,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @anchor = args[:anchor] if args.key?(:anchor)
+          @assignee_email_address = args[:assignee_email_address] if args.key?(:assignee_email_address)
           @author = args[:author] if args.key?(:author)
           @content = args[:content] if args.key?(:content)
           @created_time = args[:created_time] if args.key?(:created_time)
@@ -857,6 +980,7 @@ module Google
           @html_content = args[:html_content] if args.key?(:html_content)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
+          @mentioned_email_addresses = args[:mentioned_email_addresses] if args.key?(:mentioned_email_addresses)
           @modified_time = args[:modified_time] if args.key?(:modified_time)
           @quoted_file_content = args[:quoted_file_content] if args.key?(:quoted_file_content)
           @replies = args[:replies] if args.key?(:replies)
@@ -3142,12 +3266,14 @@ 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. 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/
-      # workspace/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.
+      # world access to a file or a folder hierarchy. For more information, see [Share
+      # files, folders, and drives](https://developers.google.com/workspace/drive/api/
+      # guides/manage-sharing). By default, permission requests only return a subset
+      # of fields. Permission `kind`, `ID`, `type`, and `role` are always returned. To
+      # retrieve specific fields, see [Return specific fields](https://developers.
+      # google.com/workspace/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
       
@@ -3159,7 +3285,7 @@ module Google
         alias_method :allow_file_discovery?, :allow_file_discovery
       
         # Output only. Whether the account associated with this permission has been
-        # deleted. This field only pertains to user and group permissions.
+        # deleted. This field only pertains to permissions of type `user` or `group`.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
@@ -3167,9 +3293,9 @@ module Google
       
         # Output only. The "pretty" name of the value of the permission. The following
         # is a list of examples for each type of permission: * `user` - User's full name,
-        # as defined for their Google account, such as "Joe Smith." * `group` - Name of
+        # as defined for their Google Account, such as "Dana A." * `group` - Name of
         # the Google Group, such as "The Company Administrators." * `domain` - String
-        # domain name, such as "thecompany.com." * `anyone` - No `displayName` is
+        # domain name, such as "cymbalgroup.com." * `anyone` - No `displayName` is
         # present.
         # Corresponds to the JSON property `displayName`
         # @return [String]
@@ -3194,14 +3320,15 @@ module Google
         attr_accessor :expiration_time
       
         # Output only. The ID of this permission. This is a unique identifier for the
-        # grantee, and is published in User resources as `permissionId`. IDs should be
+        # grantee, and is published in the [User resource](https://developers.google.com/
+        # workspace/drive/api/reference/rest/v3/User) as `permissionId`. IDs should be
         # treated as opaque values.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # When true, only organizers, owners, and users with permissions added directly
-        # on the item can access it.
+        # When `true`, only organizers, owners, and users with permissions added
+        # directly on the item can access it.
         # Corresponds to the JSON property `inheritedPermissionsDisabled`
         # @return [Boolean]
         attr_accessor :inherited_permissions_disabled
@@ -3214,14 +3341,15 @@ module Google
         attr_accessor :kind
       
         # Whether the account associated with this permission is a pending owner. Only
-        # populated for `user` type permissions for files that are not in a shared drive.
+        # populated for permissions of type `user` for files that aren't in a shared
+        # drive.
         # Corresponds to the JSON property `pendingOwner`
         # @return [Boolean]
         attr_accessor :pending_owner
         alias_method :pending_owner?, :pending_owner
       
         # Output only. Details of whether the permissions on this item are inherited or
-        # directly on this item.
+        # are directly on this item.
         # Corresponds to the JSON property `permissionDetails`
         # @return [Array<Google::Apis::DriveV3::Permission::PermissionDetail>]
         attr_accessor :permission_details
@@ -3231,9 +3359,10 @@ module Google
         # @return [String]
         attr_accessor :photo_link
       
-        # The role granted by this permission. While new values may be supported in the
-        # future, the following are currently allowed: * `owner` * `organizer` * `
-        # fileOrganizer` * `writer` * `commenter` * `reader`
+        # The role granted by this permission. Supported values include: * `owner` * `
+        # organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` For more
+        # information, see [Roles and permissions](https://developers.google.com/
+        # workspace/drive/api/guides/ref-roles).
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -3243,21 +3372,22 @@ module Google
         # @return [Array<Google::Apis::DriveV3::Permission::TeamDrivePermissionDetail>]
         attr_accessor :team_drive_permission_details
       
-        # The type of the grantee. Valid values are: * `user` * `group` * `domain` * `
-        # anyone` When creating a permission, if `type` is `user` or `group`, you must
-        # provide an `emailAddress` for the user or group. When `type` is `domain`, you
-        # must provide a `domain`. There isn't extra information required for an `anyone`
-        # type.
+        # The type of the grantee. Supported values include: * `user` * `group` * `
+        # domain` * `anyone` When creating a permission, if `type` is `user` or `group`,
+        # you must provide an `emailAddress` for the user or group. If `type` is `domain`
+        # , you must provide a `domain`. If `type` is `anyone`, no extra information is
+        # required.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
         # Indicates the view for this permission. Only populated for permissions that
-        # belong to a view. published and metadata are the only supported values. -
-        # published: The permission's role is published_reader. - metadata: The item is
-        # only visible to the metadata view because the item has limited access and the
-        # scope has at least read access to the parent. Note: The metadata view is
-        # currently only supported on folders.
+        # belong to a view. The only supported values are `published` and `metadata`: * `
+        # published`: The permission's role is `publishedReader`. * `metadata`: The item
+        # is only visible to the `metadata` view because the item has limited access and
+        # the scope has at least read access to the parent. The `metadata` view is only
+        # supported on folders. For more information, see [Views](https://developers.
+        # google.com/workspace/drive/api/guides/ref-roles#views).
         # Corresponds to the JSON property `view`
         # @return [String]
         attr_accessor :view
@@ -3303,15 +3433,16 @@ module Google
           # @return [String]
           attr_accessor :inherited_from
         
-          # Output only. The permission type for this user. While new values may be added
-          # in future, the following are currently possible: * `file` * `member`
+          # Output only. The permission type for this user. Supported values include: * `
+          # file` * `member`
           # Corresponds to the JSON property `permissionType`
           # @return [String]
           attr_accessor :permission_type
         
-          # Output only. The primary role for this user. While new values may be added in
-          # the future, the following are currently possible: * `owner` * `organizer` * `
-          # fileOrganizer` * `writer` * `commenter` * `reader`
+          # Output only. The primary role for this user. Supported values include: * `
+          # owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` For
+          # more information, see [Roles and permissions](https://developers.google.com/
+          # workspace/drive/api/guides/ref-roles).
           # Corresponds to the JSON property `role`
           # @return [String]
           attr_accessor :role
@@ -3388,8 +3519,8 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
-        # The list of permissions. If nextPageToken is populated, then this list may be
-        # incomplete and an additional page of results should be fetched.
+        # The list of permissions. If `nextPageToken` is populated, then this list may
+        # be incomplete and an additional page of results should be fetched.
         # Corresponds to the JSON property `permissions`
         # @return [Array<Google::Apis::DriveV3::Permission>]
         attr_accessor :permissions
@@ -3418,6 +3549,12 @@ module Google
         # @return [String]
         attr_accessor :action
       
+        # Output only. The email address of the user assigned to this comment. If no
+        # user is assigned, the field is unset.
+        # Corresponds to the JSON property `assigneeEmailAddress`
+        # @return [String]
+        attr_accessor :assignee_email_address
+      
         # Information about a Drive user.
         # Corresponds to the JSON property `author`
         # @return [Google::Apis::DriveV3::User]
@@ -3458,6 +3595,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # Output only. A list of email addresses for users mentioned in this comment. If
+        # no users are mentioned, the list is empty.
+        # Corresponds to the JSON property `mentionedEmailAddresses`
+        # @return [Array<String>]
+        attr_accessor :mentioned_email_addresses
+      
         # The last time the reply was modified (RFC 3339 date-time).
         # Corresponds to the JSON property `modifiedTime`
         # @return [DateTime]
@@ -3470,6 +3613,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @action = args[:action] if args.key?(:action)
+          @assignee_email_address = args[:assignee_email_address] if args.key?(:assignee_email_address)
           @author = args[:author] if args.key?(:author)
           @content = args[:content] if args.key?(:content)
           @created_time = args[:created_time] if args.key?(:created_time)
@@ -3477,6 +3621,7 @@ module Google
           @html_content = args[:html_content] if args.key?(:html_content)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
+          @mentioned_email_addresses = args[:mentioned_email_addresses] if args.key?(:mentioned_email_addresses)
           @modified_time = args[:modified_time] if args.key?(:modified_time)
         end
       end
@@ -3561,6 +3706,37 @@ module Google
         end
       end
       
+      # A response on an Approval made by a specific Reviewer.
+      class ReviewerResponse
+        include Google::Apis::Core::Hashable
+      
+        # This is always drive#reviewerResponse.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # A Reviewer’s Response for the Approval.
+        # Corresponds to the JSON property `response`
+        # @return [String]
+        attr_accessor :response
+      
+        # Information about a Drive user.
+        # Corresponds to the JSON property `reviewer`
+        # @return [Google::Apis::DriveV3::User]
+        attr_accessor :reviewer
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @response = args[:response] if args.key?(:response)
+          @reviewer = args[:reviewer] if args.key?(:reviewer)
+        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.71.0"
+      GEM_VERSION = "0.75.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250910"
+      REVISION = "20251201"
     end
   end
 end

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

@@ -76,6 +76,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Approval
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ApprovalList
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Change
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -328,6 +340,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ReviewerResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Revision
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -520,6 +538,34 @@ module Google
         end
       end
       
+      class Approval
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :approval_id, as: 'approvalId'
+          property :complete_time, as: 'completeTime'
+          property :create_time, as: 'createTime'
+          property :due_time, as: 'dueTime'
+          property :initiator, as: 'initiator', class: Google::Apis::DriveV3::User, decorator: Google::Apis::DriveV3::User::Representation
+      
+          property :kind, as: 'kind'
+          property :modify_time, as: 'modifyTime'
+          collection :reviewer_responses, as: 'reviewerResponses', class: Google::Apis::DriveV3::ReviewerResponse, decorator: Google::Apis::DriveV3::ReviewerResponse::Representation
+      
+          property :status, as: 'status'
+          property :target_file_id, as: 'targetFileId'
+        end
+      end
+      
+      class ApprovalList
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :items, as: 'items', class: Google::Apis::DriveV3::Approval, decorator: Google::Apis::DriveV3::Approval::Representation
+      
+          property :kind, as: 'kind'
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class Change
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -572,6 +618,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :anchor, as: 'anchor'
+          property :assignee_email_address, as: 'assigneeEmailAddress'
           property :author, as: 'author', class: Google::Apis::DriveV3::User, decorator: Google::Apis::DriveV3::User::Representation
       
           property :content, as: 'content'
@@ -581,6 +628,7 @@ module Google
           property :html_content, as: 'htmlContent'
           property :id, as: 'id'
           property :kind, as: 'kind'
+          collection :mentioned_email_addresses, as: 'mentionedEmailAddresses'
           property :modified_time, as: 'modifiedTime', type: DateTime
       
           property :quoted_file_content, as: 'quotedFileContent', class: Google::Apis::DriveV3::Comment::QuotedFileContent, decorator: Google::Apis::DriveV3::Comment::QuotedFileContent::Representation
@@ -1133,6 +1181,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :action, as: 'action'
+          property :assignee_email_address, as: 'assigneeEmailAddress'
           property :author, as: 'author', class: Google::Apis::DriveV3::User, decorator: Google::Apis::DriveV3::User::Representation
       
           property :content, as: 'content'
@@ -1142,6 +1191,7 @@ module Google
           property :html_content, as: 'htmlContent'
           property :id, as: 'id'
           property :kind, as: 'kind'
+          collection :mentioned_email_addresses, as: 'mentionedEmailAddresses'
           property :modified_time, as: 'modifiedTime', type: DateTime
       
         end
@@ -1167,6 +1217,16 @@ module Google
         end
       end
       
+      class ReviewerResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kind, as: 'kind'
+          property :response, as: 'response'
+          property :reviewer, as: 'reviewer', class: Google::Apis::DriveV3::User, decorator: Google::Apis::DriveV3::User::Representation
+      
+        end
+      end
+      
       class Revision
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -192,6 +192,77 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets an Approval by ID.
+        # @param [String] file_id
+        #   Required. The ID of the file the Approval is on.
+        # @param [String] approval_id
+        #   Required. The ID of the Approval.
+        # @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::Approval] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::Approval]
+        #
+        # @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_approval(file_id, approval_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'files/{fileId}/approvals/{approvalId}', options)
+          command.response_representation = Google::Apis::DriveV3::Approval::Representation
+          command.response_class = Google::Apis::DriveV3::Approval
+          command.params['fileId'] = file_id unless file_id.nil?
+          command.params['approvalId'] = approval_id unless approval_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
+        
+        # Lists the Approvals on a file.
+        # @param [String] file_id
+        #   Required. The ID of the file the Approval is on.
+        # @param [Fixnum] page_size
+        #   The maximum number of Approvals to return. When not set, at most 100 Approvals
+        #   will be returned.
+        # @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 a previous response.
+        # @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::ApprovalList] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::ApprovalList]
+        #
+        # @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_approvals(file_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'files/{fileId}/approvals', options)
+          command.response_representation = Google::Apis::DriveV3::ApprovalList::Representation
+          command.response_class = Google::Apis::DriveV3::ApprovalList
+          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
+        
         # 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
@@ -1757,9 +1828,10 @@ module Google
           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.
+        # Creates a permission for a file or shared drive. For more information, see [
+        # Share files, folders, and drives](https://developers.google.com/workspace/
+        # drive/api/guides/manage-sharing). **Warning:** Concurrent permissions
+        # operations on the same file aren't supported; only the last update is applied.
         # @param [String] file_id
         #   The ID of the file or shared drive.
         # @param [Google::Apis::DriveV3::Permission] permission_object
@@ -1770,10 +1842,10 @@ module Google
         # @param [Boolean] enforce_single_parent
         #   Deprecated: See `moveToNewOwnersRoot` for details.
         # @param [Boolean] move_to_new_owners_root
-        #   This parameter will only take effect if the item is not in a shared drive and
-        #   the request is attempting to transfer the ownership of the item. If set to `
-        #   true`, the item will be moved to the new owner's My Drive root folder and all
-        #   prior parents removed. If set to `false`, parents are not changed.
+        #   This parameter only takes effect if the item isn't in a shared drive and the
+        #   request is attempting to transfer the ownership of the item. If set to `true`,
+        #   the item is moved to the new owner's My Drive root folder and all prior
+        #   parents removed. If set to `false`, parents aren't changed.
         # @param [Boolean] send_notification_email
         #   Whether to send a notification email when sharing to users or groups. This
         #   defaults to `true` for users and groups, and is not allowed for other requests.
@@ -1785,12 +1857,16 @@ module Google
         # @param [Boolean] transfer_ownership
         #   Whether to transfer ownership to the specified user and downgrade the current
         #   owner to a writer. This parameter is required as an acknowledgement of the
-        #   side effect.
+        #   side effect. For more information, see [Transfer file ownership](https://
+        #   developers.google.com/workspace/drive/api/guides/transfer-file).
         # @param [Boolean] use_domain_admin_access
-        #   Issue the request as a domain administrator; if set to true, then the
-        #   requester will be granted access if the file ID parameter refers to a shared
-        #   drive and the requester is an administrator of the domain to which the shared
-        #   drive belongs.
+        #   Issue the request as a domain administrator. If set to `true`, and if the
+        #   following additional conditions are met, the requester is granted access: 1.
+        #   The file ID parameter refers to a shared drive. 2. The requester is an
+        #   administrator of the domain to which the shared drive belongs. For more
+        #   information, see [Manage shared drives as domain administrators](https://
+        #   developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-
+        #   administrators).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1829,8 +1905,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a permission. **Warning:** Concurrent permissions operations on the
-        # same file are not supported; only the last update is applied.
+        # Deletes a permission. For more information, see [Share files, folders, and
+        # drives](https://developers.google.com/workspace/drive/api/guides/manage-
+        # sharing). **Warning:** Concurrent permissions operations on the same file aren'
+        # t supported; only the last update is applied.
         # @param [String] file_id
         #   The ID of the file or shared drive.
         # @param [String] permission_id
@@ -1842,10 +1920,13 @@ module Google
         # @param [Boolean] supports_team_drives
         #   Deprecated: Use `supportsAllDrives` instead.
         # @param [Boolean] use_domain_admin_access
-        #   Issue the request as a domain administrator; if set to true, then the
-        #   requester will be granted access if the file ID parameter refers to a shared
-        #   drive and the requester is an administrator of the domain to which the shared
-        #   drive belongs.
+        #   Issue the request as a domain administrator. If set to `true`, and if the
+        #   following additional conditions are met, the requester is granted access: 1.
+        #   The file ID parameter refers to a shared drive. 2. The requester is an
+        #   administrator of the domain to which the shared drive belongs. For more
+        #   information, see [Manage shared drives as domain administrators](https://
+        #   developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-
+        #   administrators).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1876,7 +1957,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a permission by ID.
+        # Gets a permission by ID. For more information, see [Share files, folders, and
+        # drives](https://developers.google.com/workspace/drive/api/guides/manage-
+        # sharing).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] permission_id
@@ -1886,10 +1969,13 @@ module Google
         # @param [Boolean] supports_team_drives
         #   Deprecated: Use `supportsAllDrives` instead.
         # @param [Boolean] use_domain_admin_access
-        #   Issue the request as a domain administrator; if set to true, then the
-        #   requester will be granted access if the file ID parameter refers to a shared
-        #   drive and the requester is an administrator of the domain to which the shared
-        #   drive belongs.
+        #   Issue the request as a domain administrator. If set to `true`, and if the
+        #   following additional conditions are met, the requester is granted access: 1.
+        #   The file ID parameter refers to a shared drive. 2. The requester is an
+        #   administrator of the domain to which the shared drive belongs. For more
+        #   information, see [Manage shared drives as domain administrators](https://
+        #   developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-
+        #   administrators).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1921,28 +2007,33 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists a file's or shared drive's permissions.
+        # Lists a file's or shared drive's permissions. For more information, see [Share
+        # files, folders, and drives](https://developers.google.com/workspace/drive/api/
+        # guides/manage-sharing).
         # @param [String] file_id
         #   The ID of the file or shared drive.
         # @param [String] include_permissions_for_view
         #   Specifies which additional view's permissions to include in the response. Only
-        #   'published' is supported.
+        #   `published` is supported.
         # @param [Fixnum] page_size
         #   The maximum number of permissions to return per page. When not set for files
         #   in a shared drive, at most 100 results will be returned. When not set for
         #   files that are not in a shared drive, the entire list will be returned.
         # @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.
+        #   be set to the value of `nextPageToken` from the previous response.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
         #   Deprecated: Use `supportsAllDrives` instead.
         # @param [Boolean] use_domain_admin_access
-        #   Issue the request as a domain administrator; if set to true, then the
-        #   requester will be granted access if the file ID parameter refers to a shared
-        #   drive and the requester is an administrator of the domain to which the shared
-        #   drive belongs.
+        #   Issue the request as a domain administrator. If set to `true`, and if the
+        #   following additional conditions are met, the requester is granted access: 1.
+        #   The file ID parameter refers to a shared drive. 2. The requester is an
+        #   administrator of the domain to which the shared drive belongs. For more
+        #   information, see [Manage shared drives as domain administrators](https://
+        #   developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-
+        #   administrators).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1976,8 +2067,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a permission with patch semantics. **Warning:** Concurrent permissions
-        # operations on the same file are not supported; only the last update is applied.
+        # Updates a permission with patch semantics. For more information, see [Share
+        # files, folders, and drives](https://developers.google.com/workspace/drive/api/
+        # guides/manage-sharing). **Warning:** Concurrent permissions operations on the
+        # same file aren't supported; only the last update is applied.
         # @param [String] file_id
         #   The ID of the file or shared drive.
         # @param [String] permission_id
@@ -1994,12 +2087,16 @@ module Google
         # @param [Boolean] transfer_ownership
         #   Whether to transfer ownership to the specified user and downgrade the current
         #   owner to a writer. This parameter is required as an acknowledgement of the
-        #   side effect.
+        #   side effect. For more information, see [Transfer file ownership](https://
+        #   developers.google.com//workspace/drive/api/guides/transfer-file).
         # @param [Boolean] use_domain_admin_access
-        #   Issue the request as a domain administrator; if set to true, then the
-        #   requester will be granted access if the file ID parameter refers to a shared
-        #   drive and the requester is an administrator of the domain to which the shared
-        #   drive belongs.
+        #   Issue the request as a domain administrator. If set to `true`, and if the
+        #   following additional conditions are met, the requester is granted access: 1.
+        #   The file ID parameter refers to a shared drive. 2. The requester is an
+        #   administrator of the domain to which the shared drive belongs. For more
+        #   information, see [Manage shared drives as domain administrators](https://
+        #   developers.google.com/workspace/drive/api/guides/manage-shareddrives#manage-
+        #   administrators).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2313,7 +2410,13 @@ module Google
         end
         
         # Lists a file's revisions. For more information, see [Manage file revisions](
-        # https://developers.google.com/workspace/drive/api/guides/manage-revisions).
+        # https://developers.google.com/workspace/drive/api/guides/manage-revisions). **
+        # Important:** The list of revisions returned by this method might be incomplete
+        # for files with a large revision history, including frequently edited Google
+        # Docs, Sheets, and Slides. Older revisions might be omitted from the response,
+        # meaning the first revision returned may not be the oldest existing revision.
+        # The revision history visible in the Workspace editor user interface might be
+        # more complete than the list returned by the API.
         # @param [String] file_id
         #   The ID of the file.
         # @param [Fixnum] page_size

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v3
 version: !ruby/object:Gem::Version
-  version: 0.71.0
+  version: 0.75.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,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.71.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.75.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3
 rdoc_options: []
 require_paths: