google-apis-drive_v2 0.40.0 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d18b0415f22956e3361799001196bd0c4ff0b6ceffc2c373aa20a0683152ee98
-  data.tar.gz: 4ba7e52469dfe0d8b123a8c754f8ccde1c4563867b299e84b55b6f5d1823603a
+  metadata.gz: fe56bd23a7c40ff15ce9845baeca77036282bf8f2e807b81a7d851844ec384be
+  data.tar.gz: 4977b5fcac850fcba1fb1ef51f63af3a26e832e4def9996936ef4d3379b40446
 SHA512:
-  metadata.gz: 9fb5ce30d129cb4e43c28a4fb405aa86135ecac0fd18fe1e0cd50e0d86a05594130413be10517a9a22ee724d7dbc5975b6f281942d2704c3c7581c5e9a86f311
-  data.tar.gz: b8beb7e20a3041dfc6f54eb822a287ff165e32ff06682aa5e8c55848f3769bd8084473197116f1f3de8d2c86f03aa7a985253b8edc09a05e31af6001e26acd92
+  metadata.gz: 4ac4ce61aebd343b9e5097099ed456e2a8c99617a618d96a3df14eed9792bbe234b8f453c31b8f79547322b503d24baf59d1e43c4fbeb725f6ec3de68fd582bc
+  data.tar.gz: dd67246971fd9af0d3be1811018bc08b6973b1539ab93fdcb4e071177efeef95eab86c55f7ca25c86f43a0d532bb293a1378dec4f5213c01f65e38acb0ea525b

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-drive_v2
 
+### v0.41.0 (2023-08-27)
+
+* Regenerated from discovery document revision 20230822
+
 ### v0.40.0 (2023-07-23)
 
 * Regenerated from discovery document revision 20230714

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

@@ -452,7 +452,8 @@ module Google
       
       # The apps resource provides a list of the apps that a user has installed, with
       # information about each app's supported MIME types, file extensions, and other
-      # details.
+      # details. Some resource methods (such as `apps.get`) require an `appId`. Use
+      # the `apps.list` method to retrieve the ID for an installed application.
       class App
         include Google::Apis::Core::Hashable
       
@@ -717,7 +718,9 @@ module Google
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # Representation of a shared drive.
+        # Representation of a shared drive. Some resource methods (such as `drives.
+        # update`) require a `driveId`. Use the `drives.list` method to retrieve the ID
+        # for a shared drive.
         # Corresponds to the JSON property `drive`
         # @return [Google::Apis::DriveV2::Drive]
         attr_accessor :drive
@@ -727,7 +730,8 @@ module Google
         # @return [String]
         attr_accessor :drive_id
       
-        # The metadata for a file.
+        # The metadata for a file. Some resource methods (such as `files.update`)
+        # require a `fileId`. Use the `files.list` method to retrieve the ID for a file.
         # Corresponds to the JSON property `file`
         # @return [Google::Apis::DriveV2::File]
         attr_accessor :file
@@ -991,7 +995,9 @@ module Google
         end
       end
       
-      # A reference to a folder's child.
+      # A reference to a folder's child. Some resource methods (such as `children.get`)
+      # require a `childId`. Use the `children.list` method to retrieve the ID of the
+      # child.
       class ChildReference
         include Google::Apis::Core::Hashable
       
@@ -1028,7 +1034,9 @@ module Google
         end
       end
       
-      # A comment on a file in Google Drive.
+      # A comment on a file in Google Drive. Some resource methods (such as `comments.
+      # update`) require a `commentId`. Use the `comments.list` method to retrieve the
+      # ID for a comment in a file.
       class Comment
         include Google::Apis::Core::Hashable
       
@@ -1213,7 +1221,9 @@ module Google
         end
       end
       
-      # A comment on a file in Google Drive.
+      # A comment on a file in Google Drive. Some resource methods (such as `replies.
+      # update`) require a `replyId`. Use the `replies.list` method to retrieve the ID
+      # for a reply.
       class CommentReply
         include Google::Apis::Core::Hashable
       
@@ -1393,7 +1403,9 @@ module Google
         end
       end
       
-      # Representation of a shared drive.
+      # Representation of a shared drive. Some resource methods (such as `drives.
+      # update`) require a `driveId`. Use the `drives.list` method to retrieve the ID
+      # for a shared drive.
       class Drive
         include Google::Apis::Core::Hashable
       
@@ -1804,7 +1816,8 @@ module Google
         end
       end
       
-      # The metadata for a file.
+      # The metadata for a file. Some resource methods (such as `files.update`)
+      # require a `fileId`. Use the `files.list` method to retrieve the ID for a file.
       class File
         include Google::Apis::Core::Hashable
       
@@ -2227,7 +2240,10 @@ module Google
         # @return [Google::Apis::DriveV2::User]
         attr_accessor :trashing_user
       
-        # A permission for a file.
+        # A permission for a file. A permission grants a user, group, domain, or the
+        # world access to a file or a folder hierarchy. Some resource methods (such as `
+        # permissions.update`) require a `permissionId`. Use the `permissions.list`
+        # method to retrieve the ID for a file, folder, or shared drive.
         # Corresponds to the JSON property `userPermission`
         # @return [Google::Apis::DriveV2::Permission]
         attr_accessor :user_permission
@@ -3503,7 +3519,9 @@ module Google
         end
       end
       
-      # A reference to a file's parent.
+      # A reference to a file's parent. Some resource methods (such as `parents.get`)
+      # require a `parentId`. Use the `parents.list` method to retrieve the ID for a
+      # parent.
       class ParentReference
         include Google::Apis::Core::Hashable
       
@@ -3547,7 +3565,10 @@ module Google
         end
       end
       
-      # A permission for a file.
+      # A permission for a file. A permission grants a user, group, domain, or the
+      # world access to a file or a folder hierarchy. Some resource methods (such as `
+      # permissions.update`) require a `permissionId`. Use the `permissions.list`
+      # method to retrieve the ID for a file, folder, or shared drive.
       class Permission
         include Google::Apis::Core::Hashable
       
@@ -3876,7 +3897,9 @@ module Google
       # application. The following limits apply to file properties: * Maximum of 100
       # properties total per file * Maximum of 30 private properties per app * Maximum
       # of 30 public properties * Maximum of 124 bytes size limit on (key + value)
-      # string in UTF-8 encoding for a single property
+      # string in UTF-8 encoding for a single property Some resource methods (such as `
+      # properties.update`) require a `propertyKey`. Use the `properties.list` method
+      # to retrieve the key for a property.
       class Property
         include Google::Apis::Core::Hashable
       
@@ -3966,7 +3989,9 @@ module Google
         end
       end
       
-      # A revision of a file.
+      # A revision of a file. Some resource methods (such as `revisions.update`)
+      # require a `revisionId`. Use the `revisions.list` method to retrieve the ID for
+      # a revision.
       class Revision
         include Google::Apis::Core::Hashable
       

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DriveV2
       # Version of the google-apis-drive_v2 gem
-      GEM_VERSION = "0.40.0"
+      GEM_VERSION = "0.41.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230714"
+      REVISION = "20230822"
     end
   end
 end

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

@@ -826,7 +826,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Permanently deletes a shared drive for which the user is an organizer. The
+        # Permanently deletes a shared drive for which the user is an `organizer`. The
         # shared drive cannot contain any untrashed items.
         # @param [String] drive_id
         #   The ID of the shared drive.
@@ -1151,8 +1151,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Permanently deletes a file by ID. Skips the trash. The currently authenticated
-        # user must own the file or be an organizer on the parent for shared drive files.
+        # Permanently deletes a file owned by the user without moving it to the trash.
+        # If the file belongs to a shared drive, the user must be an `organizer` on the
+        # parent folder. If the target is a folder, all descendants owned by the user
+        # are also deleted.
         # @param [String] file_id
         #   The ID of the file to delete.
         # @param [Boolean] enforce_single_parent
@@ -1565,7 +1567,7 @@ module Google
         
         # Lists the labels on a file.
         # @param [String] file_id
-        #   The ID for the file or shared drive.
+        #   The ID for the file.
         # @param [Fixnum] max_results
         #   The maximum number of labels to return per page. When not set, defaults to 100.
         # @param [String] page_token
@@ -1785,13 +1787,7 @@ module Google
         end
         
         # Moves a file to the trash. The currently authenticated user must own the file
-        # or be at least a `fileOrganizer` on the parent for shared drive files. Only
-        # the owner may trash a file. The trashed item is excluded from all `files.list`
-        # responses returned for any user who doesn't own the file. However, all users
-        # with access to the file can see the trashed item metadata in an API response.
-        # All users with access can copy, download, export, and share the file. *Note:*
-        # Files moved to the trash still appear by default in results from the `files.
-        # list` method. To permanently remove a file, use `files.delete`.
+        # or be at least a `fileOrganizer` on the parent for shared drive files.
         # @param [String] file_id
         #   The ID of the file to trash.
         # @param [String] include_labels
@@ -1837,7 +1833,6 @@ module Google
         
         # Restores a file from the trash. The currently authenticated user must own the
         # file or be at least a `fileOrganizer` on the parent for shared drive files.
-        # Only the owner may untrash a file.
         # @param [String] file_id
         #   The ID of the file to untrash.
         # @param [String] include_labels

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v2
 version: !ruby/object:Gem::Version
-  version: 0.40.0
+  version: 0.41.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-23 00:00:00.000000000 Z
+date: 2023-08-27 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_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v2/v0.40.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v2/v0.41.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v2
 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.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Google Drive API V2