google-apis-drive_v2 0.39.0 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 298545cf06daaf2dc1fa477396cd34aaf21a302a8a05f768a022e066c1d6949c
-  data.tar.gz: 857f03312fe68587fd4beef5aee958000483450f39aa3c7918376c8fd7eb2d94
+  metadata.gz: fe56bd23a7c40ff15ce9845baeca77036282bf8f2e807b81a7d851844ec384be
+  data.tar.gz: 4977b5fcac850fcba1fb1ef51f63af3a26e832e4def9996936ef4d3379b40446
 SHA512:
-  metadata.gz: 1cf4c06ad366389637b9427ca4adf70a02f457060914b7e60d49655100d11ac5333ae4aac000ce63228b29694cee411338c2f1082b6c39913d0845d9cb5a3b90
-  data.tar.gz: 3666f44ebae5e98cdc24111a551a4e75551dc7c7b57205e6c977cd14afa751fdf60186b52c353556348cfe84fb29bc9783149c9e2cf344cfa23537b31a71667c
+  metadata.gz: 4ac4ce61aebd343b9e5097099ed456e2a8c99617a618d96a3df14eed9792bbe234b8f453c31b8f79547322b503d24baf59d1e43c4fbeb725f6ec3de68fd582bc
+  data.tar.gz: dd67246971fd9af0d3be1811018bc08b6973b1539ab93fdcb4e071177efeef95eab86c55f7ca25c86f43a0d532bb293a1378dec4f5213c01f65e38acb0ea525b

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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
+
 ### v0.39.0 (2023-06-11)
 
 * Regenerated from discovery document revision 20230603

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
       
@@ -1339,6 +1349,14 @@ module Google
       class ContentRestriction
         include Google::Apis::Core::Hashable
       
+        # Whether the content restriction can only be modified or removed by a user who
+        # owns the file. For files in shared drives, any user with `organizer`
+        # capabilities can modify or remove this content restriction.
+        # Corresponds to the JSON property `ownerRestricted`
+        # @return [Boolean]
+        attr_accessor :owner_restricted
+        alias_method :owner_restricted?, :owner_restricted
+      
         # Whether the content of the file is read-only. If a file is read-only, a new
         # revision of the file may not be added, comments may not be added or modified,
         # and the title of the file may not be modified.
@@ -1376,6 +1394,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @owner_restricted = args[:owner_restricted] if args.key?(:owner_restricted)
           @read_only = args[:read_only] if args.key?(:read_only)
           @reason = args[:reason] if args.key?(:reason)
           @restricting_user = args[:restricting_user] if args.key?(:restricting_user)
@@ -1384,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
       
@@ -1795,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
       
@@ -2218,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
@@ -2449,19 +2474,33 @@ module Google
           attr_accessor :can_modify_content
           alias_method :can_modify_content?, :can_modify_content
         
-          # Output only. Whether the current user can modify restrictions on content of
-          # this file.
+          # Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `
+          # canModifyOwnerContentRestriction` or `canRemoveContentRestriction`.
           # Corresponds to the JSON property `canModifyContentRestriction`
           # @return [Boolean]
           attr_accessor :can_modify_content_restriction
           alias_method :can_modify_content_restriction?, :can_modify_content_restriction
         
+          # Output only. Whether the current user can add or modify content restrictions
+          # on the file which are editor restricted.
+          # Corresponds to the JSON property `canModifyEditorContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_modify_editor_content_restriction
+          alias_method :can_modify_editor_content_restriction?, :can_modify_editor_content_restriction
+        
           # Output only. Whether the current user can modify the labels on the file.
           # Corresponds to the JSON property `canModifyLabels`
           # @return [Boolean]
           attr_accessor :can_modify_labels
           alias_method :can_modify_labels?, :can_modify_labels
         
+          # Output only. Whether the current user can add or modify content restrictions
+          # which are owner restricted.
+          # Corresponds to the JSON property `canModifyOwnerContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_modify_owner_content_restriction
+          alias_method :can_modify_owner_content_restriction?, :can_modify_owner_content_restriction
+        
           # Output only. Whether the current user can move children of this folder outside
           # of the shared drive. This is false when the item is not a folder. Only
           # populated for items in shared drives.
@@ -2567,6 +2606,13 @@ module Google
           attr_accessor :can_remove_children
           alias_method :can_remove_children?, :can_remove_children
         
+          # Output only. Whether there is a content restriction on the file that can be
+          # removed by the current user.
+          # Corresponds to the JSON property `canRemoveContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_remove_content_restriction
+          alias_method :can_remove_content_restriction?, :can_remove_content_restriction
+        
           # Output only. Whether the current user can remove a parent from the item
           # without adding another parent in the same request. Not populated for shared
           # drive files.
@@ -2630,7 +2676,9 @@ module Google
             @can_list_children = args[:can_list_children] if args.key?(:can_list_children)
             @can_modify_content = args[:can_modify_content] if args.key?(:can_modify_content)
             @can_modify_content_restriction = args[:can_modify_content_restriction] if args.key?(:can_modify_content_restriction)
+            @can_modify_editor_content_restriction = args[:can_modify_editor_content_restriction] if args.key?(:can_modify_editor_content_restriction)
             @can_modify_labels = args[:can_modify_labels] if args.key?(:can_modify_labels)
+            @can_modify_owner_content_restriction = args[:can_modify_owner_content_restriction] if args.key?(:can_modify_owner_content_restriction)
             @can_move_children_out_of_drive = args[:can_move_children_out_of_drive] if args.key?(:can_move_children_out_of_drive)
             @can_move_children_out_of_team_drive = args[:can_move_children_out_of_team_drive] if args.key?(:can_move_children_out_of_team_drive)
             @can_move_children_within_drive = args[:can_move_children_within_drive] if args.key?(:can_move_children_within_drive)
@@ -2646,6 +2694,7 @@ module Google
             @can_read_revisions = args[:can_read_revisions] if args.key?(:can_read_revisions)
             @can_read_team_drive = args[:can_read_team_drive] if args.key?(:can_read_team_drive)
             @can_remove_children = args[:can_remove_children] if args.key?(:can_remove_children)
+            @can_remove_content_restriction = args[:can_remove_content_restriction] if args.key?(:can_remove_content_restriction)
             @can_remove_my_drive_parent = args[:can_remove_my_drive_parent] if args.key?(:can_remove_my_drive_parent)
             @can_rename = args[:can_rename] if args.key?(:can_rename)
             @can_share = args[:can_share] if args.key?(:can_share)
@@ -3470,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
       
@@ -3514,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
       
@@ -3843,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
       
@@ -3933,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.39.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 = "20230603"
+      REVISION = "20230822"
     end
   end
 end

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

@@ -756,6 +756,7 @@ module Google
       class ContentRestriction
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :owner_restricted, as: 'ownerRestricted'
           property :read_only, as: 'readOnly'
           property :reason, as: 'reason'
           property :restricting_user, as: 'restrictingUser', class: Google::Apis::DriveV2::User, decorator: Google::Apis::DriveV2::User::Representation
@@ -969,7 +970,9 @@ module Google
             property :can_list_children, as: 'canListChildren'
             property :can_modify_content, as: 'canModifyContent'
             property :can_modify_content_restriction, as: 'canModifyContentRestriction'
+            property :can_modify_editor_content_restriction, as: 'canModifyEditorContentRestriction'
             property :can_modify_labels, as: 'canModifyLabels'
+            property :can_modify_owner_content_restriction, as: 'canModifyOwnerContentRestriction'
             property :can_move_children_out_of_drive, as: 'canMoveChildrenOutOfDrive'
             property :can_move_children_out_of_team_drive, as: 'canMoveChildrenOutOfTeamDrive'
             property :can_move_children_within_drive, as: 'canMoveChildrenWithinDrive'
@@ -985,6 +988,7 @@ module Google
             property :can_read_revisions, as: 'canReadRevisions'
             property :can_read_team_drive, as: 'canReadTeamDrive'
             property :can_remove_children, as: 'canRemoveChildren'
+            property :can_remove_content_restriction, as: 'canRemoveContentRestriction'
             property :can_remove_my_drive_parent, as: 'canRemoveMyDriveParent'
             property :can_rename, as: 'canRename'
             property :can_share, as: 'canShare'

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.39.0
+  version: 0.41.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-11 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.39.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