google-apis-drive_v3 0.71.0 → 0.72.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f50c4bbb21b7d3fffee4a9d33ae65217db09abecf37ceb9f8032cc76100840d5
-  data.tar.gz: cc220f450b65c597806fd98cc1daf774ce06bdc1951dc55164bee1f61189433f
+  metadata.gz: 0ff71cb12be0a53ad4977907a56d7a9ea8822d8260f12686e9aecae3649a2fd1
+  data.tar.gz: aa9a95cafc618c31c9225a1e75ec18a6f664b01ce38fc4da21c13f1e942e2394
 SHA512:
-  metadata.gz: f425b7ae19279904245a205a16d73530fb5883ccdfe3a97b78dd02bbf1ffb44e992fc908fd7a04a54b7fbd7b37ff9d338f016f471212c77ef6639feed9ec3e01
-  data.tar.gz: 23fe66999ef8724df649c6edb3bec613f953fa5f0a9715108943eda92e763e2e67bf1068fd8035e494bf29afdc2c4bef49cf2617fae4c9b019060e8530c9448e
+  metadata.gz: c85a5d2469356838ad2c82bd2f51e5bdaf9cad03e1e3a1f4a4266729161ebf12861a9b769dbcc509111e3d9c36d6de6500fe2da79e2eb588c068785d5ef71ff0
+  data.tar.gz: 81d080704d598849b42628d0710a8631190e9d75180cc93e2e4e00f22445040eb0f22c1f12fd3f8aa81443d8406d822b67a8edf557fad73de02450b8973b93b9

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-drive_v3
 
+### 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

@@ -3142,12 +3142,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 +3161,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 +3169,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 +3196,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 +3217,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 +3235,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 +3248,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 +3309,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 +3395,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

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.72.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 = "20251013"
     end
   end
 end

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

@@ -1757,9 +1757,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 +1771,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 +1786,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 +1834,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 +1849,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 +1886,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 +1898,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 +1936,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 +1996,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 +2016,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

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.72.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.72.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3
 rdoc_options: []
 require_paths: